iOS Packages

Choose between the aggregate iOS SDK, the core runtime, pairing UI, Objective-C support, and individual native tool products.

Start with the aggregate Ansight product for a local development build. It includes the runtime, native pairing, and standard native tool suites used by the iOS quickstart.

Use AnsightCore plus selected products only when the app needs a smaller, explicitly assembled integration.

Package Managers

The SDK is available as a Swift package from ansight-ai/ansight-sdk and as matching CocoaPods pods.

For SwiftPM, select the latest published release in Xcode with an Up to Next Major Version rule. For CocoaPods, omit the version constraint to install the latest release:

pod 'Ansight'

Follow iOS Setup for the complete installation and startup flow.

Products

Product	Registry	Purpose
`Ansight`	CocoaPods	Aggregate setup with `AnsightCore`, QR/file pairing, Clipboard, database, file-system, file-descriptor diagnostics, preferences, reflection, secure-storage, and visual-tree tools.
`AnsightCore`	CocoaPods	Runtime lifecycle, telemetry, network capture, purchase diagnostics and StoreKit refresh, host connection, pairing protocol, screenshots, touch input, tool abstractions, and build-time checks.
`AnsightMotion`	CocoaPods	Opt-in app-fed shake and accelerometer capture; included by `Ansight`.
`AnsightConnectivity`	CocoaPods	Opt-in OS connection state and quality capture; included by `Ansight`.
`AnsightAnnotations`	CocoaPods	Debug-only native annotation editor and retry outbox; included by `Ansight`.
`AnsightPairingQR`	CocoaPods	UIKit document import and AVFoundation QR scanning for SDK-owned pairing UI.
`AnsightToolsVisualTree`	CocoaPods	UIKit visual tree, screenshot, node inspection, and overlay tools.
`AnsightToolsFileSystem`	CocoaPods	Sandboxed file list, read, checksum, download, push, copy, move, and delete tools.
`AnsightToolsFileDescriptorDiagnostics`	CocoaPods	Process file-descriptor counts, limits, utilization, and open-descriptor diagnostics.
`AnsightToolsDatabase`	CocoaPods	SQLite discovery, schema inspection, and constrained read-only query tools.
`AnsightToolsPreferences`	CocoaPods	UserDefaults list, read, write, and remove tools.
`AnsightToolsClipboard`	CocoaPods	Device clipboard read, presence, write, and clear tools.
`AnsightToolsSecureStorage`	CocoaPods	Allow-listed Keychain read, write, and remove tools.
`AnsightToolsReflection`	CocoaPods	Registered-root runtime inspection plus opt-in write/invoke hooks.
`AnsightObjC`	CocoaPods	Objective-C facade used by Objective-C hosts and the React Native bridge.

Swift application code should normally use Ansight or AnsightCore. Use AnsightObjC only for Objective-C hosts and bridge layers.

Core-Only Setup

After adding AnsightCore, initialize it once from the same app-startup location used by the aggregate SDK:

import AnsightCore

let options = try AnsightOptions.createBuilder()
    .withFramesPerSecond()
    .withReadOnlyToolAccess()
    .build()

try AnsightRuntime.shared.initializeAndActivate(options: options)

Core-only setup provides the runtime, telemetry, pairing, screenshots, touch input, and custom tool abstractions without registering concrete tool suites.

Keep aggregate setup, enrollment UI, and remote tool products limited to approved development builds. Review iOS Security before choosing a distributable-build package layout.