SwiftUI Apps

Overview

Getting started for apps that are built with SwiftUI. If you're not building a SwiftUI app, and instead are using UIKit, you should look at the UIKit article instead.

Integration

Under the Signing & Capabilities tab, add the Associated Domains Capability, then add the applinks that you can support.

In your App, import MovableInk, call the start method in the constructor, add the onOpenURL modifier, and the onReceive modifier.

You can supply an API Key for Behavior Events; learn more here, and a list of domains you'd like the SDK to handle. You can also supply the list of domains via the plist if you wish; learn more in the Setup Domains via Plist section below.

Note: do not use schemes, such as https:// when providing the domains

import SwiftUI
import MovableInk

@main
struct InkredibleRetailApp: App {
  init() {
    // Starts the SDK. You do not need to do anything with the closure.
    MIClient.start(deeplinkDomains: ["mi.example.com"]) { _ in }
  }

  var body: some Scene {
    WindowGroup {
      ContentView()
      .onOpenURL { url in
        MIClient.handleUniversalLink(url: url)
      }
      .onReceive(MIClient.storedDeeplinkSubject.receive(on: DispatchQueue.main)) { value in
        guard let value = value, let url = URL(string: value) else { return }

        // This closure will be called with the resolved deeplink
      }
    }
  }
}

Setup Domains via Plist

If you wish to load in your domains via the plist, the SDK can support that too.

In your Info.plist, add the movable_ink_universal_link_domains key as an array containing all the domains that you'd like the MovableInk SDK to handle. Note: These should only be domains that are shown in your Creative Tags, such as mi.example.com:

<key>movable_ink_universal_link_domains</key>
<array>
  <string>mi.example.com</string>
</array>

If you already set your domains in code, you don't need to do this.

Deeplinking

That's it! Now you can update your code to capture clickthrough urls and deeplink into your content.

If you don't already have a working implementation of deeplinking into your content, you can view the sample apps as an example.

You can go to the SwiftUI Deeplinking Solutions article to learn more as well.