iOS SDK

Installation

dependencies: [
    .package(url: "https://github.com/ApolloLinks/warplink-ios-sdk", from: "0.1.0")
]

Configure Associated Domains

1. In Xcode, select your app target > Signing & Capabilities
2. Click + Capability > Associated Domains
3. Add: applinks:aplnk.to

Also enable Associated Domains in your App ID at developer.apple.com.

Initialize the SDK

Call configure() as early as possible in your app lifecycle.

import SwiftUI
import WarpLink

@main
struct MyApp: App {
    init() {
        WarpLink.configure(apiKey: "wl_live_your_api_key_here_abcdefgh")
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

import UIKit
import WarpLink

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        WarpLink.configure(apiKey: "wl_live_your_api_key_here_abcdefgh")
        return true
    }
}

Enable debug logging during development:

WarpLink.configure(
    apiKey: "wl_live_your_api_key_here_abcdefgh",
    options: WarpLinkOptions(debugLogging: true, matchWindowHours: 48)
)

Handle Deep Links

See Deep Links for Universal Link handling setup.

Handle Deferred Deep Links

See Deferred Deep Links for first-install attribution.

Test on a Physical Device

1. Build and run on a physical device
2. Open your test link in Safari (e.g., https://aplnk.to/abc123)
3. The app should open and trigger the deep link callback
4. Check Xcode console for [WarpLink] log messages

Next Steps

• Deep Links — Handle Universal Links for cold and warm start
• Deferred Deep Links — Preserve context through App Store installs
• Attribution — Understand match types and confidence scores
• API Reference — Full Swift API documentation