Branch Deep link not opening application

Nick picture Nick · Feb 1, 2016 · Viewed 11.7k times · Source

I have been trying (unsuccessfully) to use Branch to implement deep linking into our iOS application. The Branch URL redirects directly to App Store and never attempts to open the application. I must be missing something.

What I've done:

  1. Included Branch SDK (CocoaPods) Added branch_key to application plist

  2. Added URL Scheme to URL Types in application plist

  3. EnabledAssociated Domains in both the project and the App ID in the developer console.

  4. Ensured that the entitlements file is included in the build.

  5. Registered deep link handler in AppDelegate

Dashboard: Settings -> Link Settings:

  1. "Always try to open app" is checked

  2. "IOS URI Scheme" is set to the application's custom URI scheme.

  3. "Enable Universal Links" is checked.

  4. Bundle Identifier & Apple App Prefix are both set correctly.

    Within the Branch Dashboard, under "Marketing" tab, I've created a single link. I'm emailing this link to myself and opening it on the device (Mail.app). Safari opens then the App Store is opened as if the application is not installed.

Neither application:openURL:sourceApplication:annotation nor application:continueUserActivity:restorationHandler are called.

AppDelegate Methods:

func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
    let branch: Branch = Branch.getInstance()
    branch.initSessionWithLaunchOptions(launchOptions, andRegisterDeepLinkHandler: { params, error in
        if (error == nil) {
            // params are the deep linked params associated with the link that the user clicked -> was re-directed to this app
            // params will be empty if no data found
            // ... insert custom logic here ...
            NSLog("params: %@", params.description)
        }
    })
    return true
}

func application(application: UIApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler: ([AnyObject]?) -> Void) -> Bool {
    // pass the url to the handle deep link call
    
    return Branch.getInstance().continueUserActivity(userActivity)
}

func application(application: UIApplication, openURL url: NSURL, sourceApplication: String?, annotation: AnyObject) -> Bool {
    // pass the url to the handle deep link call
    Branch.getInstance().handleDeepLink(url);
    
    // do other deep link routing for the Facebook SDK, Pinterest SDK, etc
    return true
}

Am I missing a configuration step? Is this because the application is installed via Xcode debug and not through the app store? I'm expecting to see the application delegate methods called, but they are not.

Answer

Nick picture Nick · Feb 1, 2016

It appears that the application must be installed via App Store/Test Flight/Ad Hoc or the application will not be considered installed.

I installed the application to my device using an Ad Hoc provision and everything is working.