Skip to main content

​
Requirements

Before integrating the AppDNA iOS SDK, ensure your project meets the following minimum requirements:
RequirementMinimum Version
iOS15.0+
Swift5.9+
Xcode15+
Projects targeting iOS versions below 15.0 are not supported. The SDK uses Swift concurrency features that require iOS 15.0 as a minimum deployment target.

​
Installation

Add the AppDNA SDK to your project using Swift Package Manager:
  1. In Xcode, go to File > Add Package Dependencies…
  2. Enter the repository URL:
https://github.com/appdna-ai/appdna-sdk-ios.git
  1. Set the dependency rule to Up to Next Major Version starting from 1.0.0.
  2. 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/appdna-sdk-ios.git", from: "1.0.0")
]
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'
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.

​
Dependencies

The following dependencies are automatically included with the SDK. You do not need to add them manually:
DependencyVersionPurpose
KeychainAccess~4.2.2Secure storage for tokens and IDs
FirebaseFirestore~10.0.0Real-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.

​
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.0"
If the import succeeds and the version prints correctly, the SDK is ready to configure.
You should see 1.0.0 printed in the Xcode console. If you get a “No such module” error, clean your build folder (Cmd+Shift+K) and rebuild.

​
Next Steps

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