iOS Installation

Supported on: iOS SDK 1.0.61+

Requirements

Before integrating the AppDNA iOS SDK, ensure your project meets the following minimum requirements:

Requirement	Minimum Version
iOS	16.0+
Swift	5.9+
Xcode	16+

Projects targeting iOS versions below 16.0 are not supported. The SDK uses Swift concurrency features and modern SwiftUI APIs that require iOS 16.0 as a minimum deployment target.

Installation

Swift Package Manager (Recommended)

Add the AppDNA SDK to your project using Swift Package Manager:

In Xcode, go to File > Add Package Dependencies…
Enter the repository URL:

https://github.com/appdna-ai-inc/appdna-sdk-ios.git

Set the dependency rule to Up to Next Major Version starting from 1.0.71.
Select the AppDNASDK package product and add it to your target.

Alternatively, add it directly to your Package.swift:

dependencies: [
    .package(url: "https://github.com/appdna-ai-inc/appdna-sdk-ios.git", from: "1.0.71")
]

Then add the product to your target’s dependencies:

.target(
    name: "YourApp",
    dependencies: [
        .product(name: "AppDNASDK", package: "appdna-sdk-ios")
    ]
)

CocoaPods

Add the following to your Podfile:

pod 'AppDNASDK', '~> 1.0.71'

Then run:

pod install

The pod is published from the AppDNASDK.podspec in the SDK repository. Make sure your CocoaPods repo is up to date by running pod repo update if the pod is not found.

Firebase Configuration

The AppDNA SDK uses Firebase Firestore for real-time configuration delivery (paywalls, experiments, feature flags, onboarding flows). You must add a Firebase configuration file to your project.

Step 1: Download GoogleService-Info-AppDNA.plist

Log into your AppDNA Console
Go to Settings → SDK
Click Download Firebase Config to download GoogleService-Info-AppDNA.plist

Step 2: Add to Your Xcode Project

Drag GoogleService-Info-AppDNA.plist into your Xcode project navigator
Ensure “Copy items if needed” is checked
Select your app target in the “Add to targets” section

Step 3: Add Background Task Permission

Add the following to your app’s Info.plist to enable background event uploads:

<key>BGTaskSchedulerPermittedIdentifiers</key>
<array>
    <string>ai.appdna.sdk.eventUpload</string>
</array>

// In AppDelegate.swift — must be called before AppDNA.configure()
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    AppDNA.registerBackgroundTasks()
    AppDNA.configure(apiKey: "YOUR_API_KEY")
    return true
}

Without GoogleService-Info-AppDNA.plist, the SDK cannot fetch remote configuration (paywalls, experiments, feature flags). Events will still be tracked, but remote features will not work.

If your app already uses Firebase for your own services (Realtime Database, Analytics, Crashlytics), AppDNA automatically creates a separate named Firebase instance using GoogleService-Info-AppDNA.plist. Your existing Firebase setup is not affected. Just add the AppDNA plist alongside your own GoogleService-Info.plist.

Dependencies

The following dependencies are automatically included with the SDK. You do not need to add them manually:

Dependency	Version	Purpose
KeychainAccess	~> 4.2	Secure storage for tokens and IDs
FirebaseFirestore	>= 11.0, < 13.0	Real-time remote configuration sync

If your project already includes these dependencies, ensure your version constraints are compatible with the versions listed above. SPM and CocoaPods will resolve version conflicts automatically in most cases.

Lottie and Rive animation support requires adding lottie-ios and rive-ios as separate SPM dependencies in your project.

Verify Installation

After adding the SDK, verify it is correctly installed by importing the module and printing the SDK version:

import AppDNASDK

print(AppDNA.sdkVersion) // "1.0.71"

If the import succeeds and the version prints correctly, the SDK is ready to configure.

You should see 1.0.71 printed in the Xcode console. If you get a “No such module” error, clean your build folder (Cmd+Shift+K) and rebuild.

Troubleshooting

If you encounter issues during integration, call AppDNA.diagnose() after configuration to get a full health report:

// Call a few seconds after configure() to allow bootstrap to complete
DispatchQueue.main.asyncAfter(deadline: .now() + 5) {
    AppDNA.diagnose()
}

This prints a diagnostic report to the Xcode console:

╔══════════════════════════════════════════
║  AppDNA SDK Diagnostic Report  v1.0.71
╠══════════════════════════════════════════
║ ✅ API Key: sandbox key (adn_test_...50ef)
║ ✅ Environment: sandbox
║ ✅ Bootstrap: orgId=..., appId=...
║ ✅ Firebase: secondary app 'appdna' configured
║ ✅ Identity: anonId=a1b2c3d4...
║ ✅ Event Queue: initialized
║ ✅ Remote Config: initialized
║ ✅ Modules: paywalls, onboarding, messages, surveys, billing, push, experiments
╠══════════════════════════════════════════
║ ✅ SDK is fully operational
╚══════════════════════════════════════════

Any items marked with ❌ indicate a configuration issue. Common fixes:

Issue	Fix
❌ API Key: invalid format	Key must start with `adn_live_` or `adn_test_`
❌ Bootstrap: failed	Check API key and internet connection
❌ Firebase: no secondary app	Add `GoogleService-Info-AppDNA.plist` to your target
⚠️ Firebase: using default app	Your own Firebase is being used instead of AppDNA’s — add `GoogleService-Info-AppDNA.plist`

Next Steps

Once the SDK is installed, proceed to the Quickstart guide to configure the SDK and start tracking events.

​Requirements

​Installation

​Swift Package Manager (Recommended)

​CocoaPods

​Firebase Configuration

​Step 1: Download GoogleService-Info-AppDNA.plist

​Step 2: Add to Your Xcode Project

​Step 3: Add Background Task Permission

​Dependencies

​Verify Installation

​Troubleshooting

​Next Steps

Requirements

Installation

Swift Package Manager (Recommended)

CocoaPods

Firebase Configuration

Step 1: Download GoogleService-Info-AppDNA.plist

Step 2: Add to Your Xcode Project

Step 3: Add Background Task Permission

Dependencies

Verify Installation

Troubleshooting

Next Steps