Dub iOS SDK (BETA)

Track deep link conversion events in your iOS app
Learn more »

Compatibility · Installation · Development

Dub is the modern link attribution platform for short links, conversion tracking, and affiliate programs.

The Dub iOS SDK is a client side library built in Swift for both UIKit and SwiftUI.

It enables open tracking for regular/deferred deep links as well as tracking lead and sale conversion events.

Learn more about the Dub iOS SDK in the official documentation.

Table of Contents

• Compatibility
• Installation
• Usage
• Development
  • Documentation
  • Contributions

Compatibility

Supported iOS and Xcode versions

The Dub iOS SDK is available for iOS and macOS. It requires the following minimum build tool versions:

Tool	Version
Xcode	16+
Swift	4.0+

And supports the following device platforms:

Platform	Version
iOS	16.0
macOS	10.13 (Ventura)

If you require additional compatibility, let us know!

Installation

Swift Package Manager (Recommended)

The Dub iOS SDK can be installed using the Swift Package Manager.

In Xcode, select File > Add Package Dependencies and add https://github.com/dubinc/dub-ios as the repository URL. Select the latest version of the SDK from the release page.

Other

If you have additional installation requirements, let us know!

Examples

SwiftUI

The SwiftUI example may be found at /Examples/SwiftUI.

UIKit

The SwiftUI example may be found at /Examples/UIKit.

Development

Documentation

This project uses the Swift-DocC Plugin to generate SDK docs from code comments.

To generate documents manually run the following command from the project root:

swift package --allow-writing-to-directory ./docs generate-documentation --target Dub --output-path ./docs

To write doc comments, hover over a symbol and press ⌘ + ⌥ + / (command + option + forward slash).

Contributions

Feel free to open a PR or a Github issue as a proof of concept and we'll do our best to include it in a future release!