SDK Installation (iOS)

Detour provides a native iOS SDK (Detour) for deferred links, universal links, and custom scheme links.

Beta

iOS SDK 1.0.0 is currently in beta. APIs and integration details may still change before stable release.

Before installation, make sure your app is created in the Detour Dashboard and you have:

• appID from API configuration
• publishable apiKey from API configuration
• iOS link integration snippets from App configuration

Requirements

• iOS 13+ (from package manifest)
• Swift 5.5+ (Swift Package Manager)

Install with Swift Package Manager

In Xcode:

1. Open your project.
2. Go to File > Add Package Dependencies...
3. Enter repository URL:
   • https://github.com/software-mansion-labs/ios-detour
4. Add product Detour to your app target.

Or in Package.swift:

.package(url: "https://github.com/software-mansion-labs/ios-detour", from: "1.0.0")

Prepare app configuration

import Detour

let detourConfig = DetourConfig(
    apiKey: "<YOUR_DETOUR_API_KEY>",
    appID: "<YOUR_DETOUR_APP_ID>",
    shouldUseClipboard: true,
    linkProcessingMode: .all
)

Configure link capabilities

Add both integration pieces from Dashboard/App config:

• custom URL scheme in Info.plist (CFBundleURLTypes)
• associated domains in entitlements (applinks:<your-domain>)

Without those entries, iOS will not dispatch runtime links to your app.

Next steps

1. Wire startup/runtime handling in SDK Usage.
2. Use the runnable template from Examples.