Skip to main content

Installation

SDK Version Selection

Choose your SDK version below:

  • Apptrove SDK → Recommended for all projects (Latest: v2.x.x)
  • Trackier SDK → Will be deprecated in August 2026 (v1.x.xx)

Use the tabs below to view installation instructions for your chosen SDK.

This guide provides step-by-step instructions to integrate the Apptrove iOS SDK into your iOS application using CocoaPods or Swift Package Manager. Choose the installation method that best suits your project.

Prerequisites​

  • iOS 10.0 or later
  • Xcode 12.0 or later
  • CocoaPods (for Option 1) or Swift Package Manager support (for Option 2)
  • A Trackier MMP account with an SDK key
  • Access to your project's Podfile (for CocoaPods) or Xcode project settings

Installation​

Choose one of the following installation methods:

Option 1: CocoaPods​

Add Apptrove SDK via CocoaPods​

To integrate the Apptrove iOS SDK, configure your Podfile to include the SDK dependency.

1.1 Update the Podfile​

In your project's Podfile, add the following line:

pod 'apptrove-ios-sdk'

Package Information:

  • CocoaPods Package: apptrove-ios-sdk
  • Installation Command: pod 'apptrove-ios-sdk'
  • Version: 2.x.x (latest)

1.2 Install Dependencies​

Run the following command in the terminal from your project directory:

pod install

1.3 Open the Workspace​

Open the generated .xcworkspace file in Xcode to build and run your project.

1.3 Open the Workspace​

Open the generated .xcworkspace file in Xcode to build and run your project.

1.4 Import SDK​

Import the SDK in your Swift files:

import apptrove_ios_sdk
CocoaPods

If you're new to CocoaPods, refer to the official CocoaPods documentation for guidance on creating and using Podfiles.

Option 2: Swift Package Manager​

The Apptrove iOS SDK supports Swift Package Manager (SPM) for dependency management.

Step 1: Add Package Dependency​

1.1 Open Xcode Package Dependencies​

  1. Open your project in Xcode
  2. Go to File → Add Package Dependencies...

Add iOS Package

1.2 Enter Repository URL​

Enter the repository URL:

https://github.com/ApptroveLabs/Trackier_iOS_SDK.git
  1. Select the version rule (e.g., "Up to Next Major Version" with 2.x.x)
  2. Click "Add Package"

Xcode will verify the package:

Verifying Trackier iOS SDK

1.3 Add SDK Product to Target​

  1. Select the ApptroveSDK product and add it to your target
  2. Click "Add Package" again to confirm

Step 2: Add Framework to Target​

After adding the package, you need to link the framework:

2.1 Open Project Settings​

  1. Open your project in Xcode
  2. Select your project in the navigator (top-level item)
  3. Select your target (e.g., "iOS Simulator")
  4. Go to "General" tab
  5. Scroll to "Frameworks, Libraries, and Embedded Content"

2.2 Add ApptroveSDK Framework​

  1. Click the "+" button
  2. Search for ApptroveSDK

Add Framework from Project

  1. Select ApptroveSDK and click "Add"

2.3 Verify Framework Integration​

Verify that ApptroveSDK appears in the frameworks list:

Verify Framework

Step 3: Import SDK in Your Code​

After successful installation, import the SDK in your Swift files:

import ApptroveSDK
SPM Repository

Example Application​

For a sample implementation, refer to the Example directory in the Apptrove iOS SDK GitHub repository. To explore the example project:

  1. Clone the repository: 
    git clone https://github.com/trackier/ios-sdk.git
  2. Navigate to the Example directory
  3. Open the project in Xcode
    • For CocoaPods: Run pod install and open the .xcworkspace file
    • For SPM: The dependencies will be automatically resolved by Swift Package Manager

Next Steps​

After completing the installation:

  1. Initialize the Apptrove SDK in your app.
  2. Test your integration to ensure proper tracking of installs and events.
  3. Contact Apptrove support at support@apptrove.com for assistance.

For the latest version of the Apptrove iOS SDK and additional resources, visit the Apptrove Documentation Portal.