Deep Linking Does Not Work on iOS Devices

Environment

Service Code (AppBuilder)
Feature Run on Device
Mobile development type Hybrid (Apache Cordova app)
Mobile OS iOS

Description

Links in your app, that use a custom URL scheme (for example, googlegmail://) to open an external app, do not work on iOS. Clicking such a link produces no visible result. This problem is observed on iOS 9 and newer versions.

Cause

Apple introduced a new LSApplicationQueriesSchemes key in the iOS Info.plist file that lists the URL schemes the app is able to open. If this property is not set in your app, you will not be able to link using any custom URL schemes.

Solution

You need to whitelist all custom URL schemes that you intend to use in your app. To do this, follow the steps below:

  1. In AppBuilder, right-click your project name and select Edit Configuration -> iOS Info.plist.
  2. Add the following right before the last closing </dict> tag:

    <key>LSApplicationQueriesSchemes</key>
    <array>
        <string>customscheme</string>
        <string>customscheme</string>
        <string>customscheme</string>
    </array>
    

    where you replace customurlscheme with the names of the custom URL schemes that you want to use. For example, fb, googlegmail, comgooglemaps.

  3. Save and re-build your app.

See Also

Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All Rights Reserved.