Skip to main content
This guide will help you install and set up the Linkrunner SDK in your native iOS application.

​
Requirements

  • iOS 15.0 or higher
  • Swift 5.9 or higher
  • Xcode 14.0 or higher

​
Installation

​
Swift Package Manager

The Linkrunner SDK can be installed via Swift Package Manager (SPM), which is integrated directly into Xcode.
  1. In Xcode, select File → Add Package Dependencies…
  2. Enter the following repository URL: 
    https://github.com/linkrunner-labs/linkrunner-ios.git
  3. Select the version you want to use (we recommend using the latest version)
  4. Click Add Package
  5. Choose the library type LinkrunnerStatic
Alternatively, you can add the package dependency to your Package.swift file: 
dependencies: [
    .package(url: "https://github.com/linkrunner-labs/linkrunner-ios.git", from: "3.0.2")
]
And add the dependency to your target: 
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "Linkrunner", package: "linkrunner-ios")
        ]
    )
]

​
Importing in Swift

After installation, you can import the SDK in your Swift files: 
import Linkrunner

​
Required Permissions

​
App Tracking Transparency

If you plan to use IDFA (Identifier for Advertisers), you need to request permission from the user through App Tracking Transparency. Add the following to your Info.plist file: 
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads and improve your app experience.</string>

​
SKAdNetwork Configuration

To enable SKAdNetwork postback copies to be sent to Linkrunner, add the following keys to your Info.plist file: 
<key>NSAdvertisingAttributionReportEndpoint</key>
<string>https://linkrunner-skan.com</string>
<key>AttributionCopyEndpoint</key>
<string>https://linkrunner-skan.com</string>
For complete SKAdNetwork integration details, see the SKAdNetwork Integration Guide.

​
Network Access

The SDK requires network access to communicate with Linkrunner services. Make sure your app has the appropriate permissions for network access.

​
Next Steps

After installation, proceed to the Usage Guide to learn how to initialize and use the Linkrunner SDK in your iOS application.
⌘I