Deeplinks Testing

What are Deeplinks

Deeplinks are a type of link that send users directly to an app instead of a website or a store.

To get more information about the deeplinks follow this documentation.

Points to consider before testing deeplinks

• Deeplinks AND Dynamic Links should not be tested on PREPROD builds.
• Deeplinks will not work in the local builds (builds from VSCode).
• Sign with production SSH keys to test deeplinks on Android.
• Deeplinks will work on Play Store/App Store builds.

How to test Deeplinks on Play Store or App Store builds

Step 1: Make sure the app is installed in the device.

• PROD build of the app should be installed on the device before testing.

Step 2: Copy the deeplinks somewhere in the device.

• Copy the URL of the deeplink and paste it somewhere in the device.

Step 3: Click/Tap on the link

• Click/Tap on the link, The app should open with specific page as per the deeplinks.

To get the list of deeplinks which are available for the PROD/PREPROD builds for each region, click on the links given below:

• UK
• NL
• BE
• FR

How to test Deeplinks on PREPROD or Local builds

Step 1: Copy the deeplink URL.

• Before testing, copy the deeplink URL which you are going on test on the device.

Step 2: Now based on the device, add the following code in the terminal.

• Add a code given below, in the terminal of the VSCode where the app instance is running.
  • For Android:

    adb shell "am start -a android.intent.action.VIEW -d add_deeplink_URL_here -n com.toolstation.mobile_app/com.toolstation.mobile_app.MainActivity"
    

  • For iOS:

    xcrun simctl openurl booted "add_deeplink_URL_here"
    

Step 3: Add the URL of the deeplink in place of add_deeplink_URL_here

• Suppose the URL of the deeplink is: https://www.toolstation.com/promos/promo/APPPERCENT. Then the code you should add in the terminal are:
  • For Android:

    adb shell "am start -a android.intent.action.VIEW -d https://www.toolstation.com/promos/promo/APPPERCENT -n com.toolstation.mobile_app/com.toolstation.mobile_app.MainActivity"
    

  • For iOS:

    xcrun simctl openurl booted "https://www.toolstation.com/promos/promo/APPPERCENT"
    

Step 4: Run the command and observe the output on the app.