iOS – SDK Integration

Module	Swift Package	Module is Optional
KochavaNetworking Advanced networking support. A foundational module for the Kochava SDK.	https://github.com/Kochava/Apple-SwiftPackage-KochavaNetworking

IMPORTANT NOTE: At the present time the source-based swift package(s) cannot be mixed with xcframework-wrapping swift packages due to some technological issues related to dependencies. This means that you cannot currently import the KochavaNetworking source swift package if you also need to import the KochavaMeasurement SDK- as the latter is not currently open-sourced. We welcome you to check back here for more information as it develops.

SDK NOTE: With the release of version 8.0.0 of the Kochava Apple SDK, we discontinued cocoapods distribution in favor of Swift Packages. Please contact support@kochava.com if you have any questions or concerns.

Module	Cocoapod	Module is Optional
KochavaTracker Attribution, event tracking, and analytics.	Apple-Cocoapod-KochavaTracker
KochavaAdNetwork (v5) Support for SKAdNetwork. This module is required for integrations which intend to leverage Apple’s SKAdNetwork support.   This optional module was moved into module KochavaTracker in v6 and does not need to be added separately in newer versions.	Apple-Cocoapod-KochavaAdNetwork	✔

How to add a Cocoapod:

If this is your first time adding a Cocoapod, follow these steps for each of the modules above you wish to add:

1. Open your Podfile in an editor. If you do not have a Podfile yet, see Using Cocoapods.
2. Add the module, and configure the version to the desired major version. Currently you should use 7.

   Example:

target 'MyApp' do
  pod 'Apple-Cocoapod-KochavaTracker', '~> 7.0'
end

 

Sample Code:

XCFramework(s), Swift —

import KochavaTracker

 

XCFramework(s), Objective-C —

@import KochavaTracker;

 

At this point the v5 SDK integration is complete! When viewing code samples throughout our support site, always choose either Swift or Objective-C code samples.

SDK NOTE: With the release of version 8.0.0 of the Kochava Apple SDK, we discontinued all xcframework standalone repositories in favor of Swift Packages. The Swift Package repositories already contain these same xcframeworks. Please contact support@kochava.com if you have any questions or concerns.

How to add an XCFramework:

Follow these steps for each of the modules above you wish to add:

1. Download the XCFramework from the link above and add it to your project.


XCFramework Addition Details:

---




Expand for Details

1. Download the release archive containing the XCFramework.
2. Open the archive and copy the XCFramework into your Xcode project folder using Finder. You will typically want to add this file to the Frameworks folder of your project.
3. Right click on your project in Xcode, select Add Files to (project name), and add the included file to your project.
4. If you are working with multiple targets, you will want to ensure that you have included the XCFramework in each of the desired targets by selecting the file and reviewing its target membership in the inspector, which appears on the right side in Xcode.
5. Ensure that the XCFramework is included in Frameworks, Libraries, and Embedded Content in your project target (located under the General tab). It will normally have been added at the moment you added the file to your target.


Collapse


---

 

2. Import the XCFramework.

Sample Code:

XCFramework(s), Swift —

import KochavaTracker

XCFramework(s), Objective-C —

@import KochavaTracker;

@import KochavaNetworking;
@import KochavaMeasurement;
@import KochavaTracking;  // optional
 
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 
{
    KVALog.shared.level = KVALog_Level.info;

    KVAMeasurement *measurement = KVAMeasurement.shared;
    [measurement startWithAppGUIDString:@"_YOUR_APP_GUID_"];

    return YES;
}

import KochavaTracker
 
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    KVATracker.shared.start(withAppGUIDString: "_YOUR_APP_GUID_")
    return true
}