Deep Links
Deep links can be used to speed up navigation by directly accessing specific app screens, bypassing complex flows. Deep Links Tester allows users to validate deep links within their applications, ensuring that promotional or navigational links direct users to the correct pages. Three Types of Deep Links for QApilot are:
Authentication Deeplinks:
Authentication deep links are used to navigate directly to authentication-related screens or processes within an application. They are especially useful in testing login flows, multi-factor authentication (MFA), and session management.
Use Cases in Testing:
Directly opening the login page or a specific OAuth provider (e.g., Google, Facebook).
Bypassing navigation steps to validate MFA functionality (e.g., OTP input screens).
Testing session timeouts or reauthentication flows.
Download App Push Deeplinks
These deep links redirect users to download or install an app from a store (e.g., Google Play Store, Apple App Store) or a specific location. They are useful for apps that promote installations or updates via links in web pages, emails, or other apps.
Use Cases in Testing:
Verifying the redirection to the correct app store page.
Ensuring the deep link handles the "app already installed" scenario properly.
Testing conditional flows where the app opens if installed or redirects to the store if not.
Link Browser Portal PWA Deeplinks
These are links that open specific pages within a browser portal or Progressive Web App (PWA). They bridge the functionality of web and mobile apps, enabling access to a specific part of the app through a browser.
Use Cases in Testing:
Navigating directly to a feature or section within a PWA (e.g., a product page or user dashboard).
Validating behavior in offline mode (PWAs often provide offline capabilities).
Ensuring links function across devices and browsers.
Prerequisites
Ensure that you have test case scenarios to select from the dropdown.
You must have Deeplink URLs and elements to find them.
You should know how to Execute the Test Plan
Listing Deep links
On the Test Deep links List page, you will have the below options:
Navigate to Deep links in the left-side navbar.
You can easily manage Deep Links on the Deep Links list page by filtering, or searching. The page displays deep links with titles, creation dates, and statuses.
Click Add Deep Links

Creating Deep Links
Click the Add to add a new/Create Deeplink on the Deeplink Homepage.
It redirects to the below Create Deeplink window

Enter Title
Enter your App Name
Select OS refers to choosing the operating system (OS) that a particular application or test environment will run on, such as Android or iOS.
A login scenario refers to a category or filter applied to group test cases specifically related to login functionality. This helps streamline test case management, enabling testers to focus on specific features or scenarios.
To test a deep link that requires user login in the application, you can follow a structured approach in QApilot. The goal is to verify that the deep link works correctly only after the user is authenticated and ensures redirection to the correct page or functionality.
Similarly, select Logout Scenario and Logout Test case from the dropdown.
Download a sample Deeplink Excel file and fill in the details to import that includes deep link URL and element text/XPath. Users can upload a sheet containing all the deep links they need to test. This sheet should include the link, the expected destination page, and a unique element identifier for validation.
A Deeplink URL is a specific type of hyperlink that takes a user directly to a specific page or location within a mobile application, rather than just opening the app. Deeplinks enhance the user experience by allowing users to access content more quickly, bypassing unnecessary navigation steps.
XPATH helps to identify and interact with elements like buttons, links, input fields, etc., based on their location.
Click on the Create button and the new Deeplink will be created successfully.

When executed, a deep link can open the app to a specific screen or state, bypassing the app's normal navigation flow. This makes testing deep links crucial in ensuring that users are taken to the correct location within the app when they click these links.
Deep Links Execution
Navigate to Test Plans on the left side nav bar, and create a Test Plan for Test Execution as shown below:

Select Source From Deeplink that you have already created and Import Deeplinks from the available deep links dropdown.

After clicking Import, Device Setup

Next, Execution Settings will apply any advanced settings from this execution.

Enabling the App Installation Flow will apply check authentication on every case or check authentication on only failed cases.

click on Save to Execute Deep links. QAPilot tests each deep link by clicking the link and verifying that it navigates to the correct page. The tool checks for the presence of a unique element (e.g., a specific text field or mobile number) to confirm successful navigation.
If the tool identifies the unique element, the test case is marked as passed. If the element is not found, the test case fails, indicating an issue with the deep link or navigation flow. Once the executions are completed, these are acknowledged in the form of Reports.
Click the three-dot menu to manage the changes concerning every deep link.

The users can View Details to add the elements, Edit, Disable, and Delete.

Click on Edit to update the Deeplink data:

Also, read about the Deep Links Report, here.
Last updated