Open Deep Link

In mobile app testing, the "Open deep link" command is available. This command enables the following operations:

• Open a URI with a custom scheme (such as theapp:// or geo://)
• Open a website URL starting with http:// or https://
• Open Universal Links or Android App Links starting with http:// or https://

Table of Contents

• App to Be Opened with the Link
• Android Restrictions
• iOS Restrictions
• Troubleshooting

App to Be Opened with the Link

Which app opened with the specified URI as a deep link depends on the following factors:

• The installation status of apps
• System settings
• The "App to be opened with link" option in the command

The Behavior Based on Settings:

• If a specific app is set in the "App to be opened with link" option, that app will take priority.
• If "Not specified" is selected, the system's default app associated with the link is typically used.

Android Restrictions

Option Availability in External Cloud Environments

• In external cloud environments (e.g., BrowserStack, SauceLabs), the "Not specified" option for the "App to be opened with link" option is not supported.
• Attempting to use the "Not specified" option will result in an execution error.
• To avoid errors, set a specific app in the "App to be opened with link" option when using these environments.

When Chrome is Opened

• Chrome may display a "Welcome screen" or a "Sign-in prompt" upon launch. These can be dismissed using the "Tap" command if necessary.
• A bug has been reported where a WebView scan may fail if an empty tab exists in Chrome. This can occur because Chrome may automatically create an empty tab upon launch. Consider closing empty tabs using the "Tap" command if necessary.
  • For more details, refer to "Known issues with Android WebView" in "Testing WebView."

When OneLink handling is implemented using the AppsFlyer SDK

Due to constraints in the SDK, there is a known issue where links cannot be opened while the app is in the foreground. Please ensure the app is moved to the background before attempting to open the link.

iOS Restrictions

iOS 16.3 or below

• In environments with iOS 16.3 or below, links are opened via Safari internally before being redirected to the associated app. This behavior introduces the following restrictions:
  • Universal Links could not function. We are considering a fix for it.
  • If a tab is already open, Safari might overwrite it.
  • It is not possible to set a specific app to open links. As a result, the "App to be opened with link" option is not applied.
  • If there are typos or errors in the specified URI, Safari may treat it as a search query rather than displaying an error.

Troubleshooting

The destination when tapping a Universal Link on a cloud device differs from that on a real device