deep_link

Using deep link on Sauce Labs

This folder contains examples for using deep linking for:

• Android Real Devices in the Sauce Labs Cloud
• Android Emulators in the Sauce Labs Cloud

Deep link for Android

For Android real devices and emulators we can use the mobile:deeplink uiautomator2 command.
Please see here for more info.

Important information

Environment variables for Sauce Labs

The examples in this repository use environment variables, make sure you've added the following

# For Sauce Labs Emulators/Simulators/Real devices
export SAUCE_USERNAME=********
export SAUCE_ACCESS_KEY=*******

Demo app(s)

The demo app that has been used for all these tests can be found here.
This app supports deep linking for iOS and for Android, this means that screens can directly be opened with a deep link.
Please check here the screens that can directly be opened with a deep link.

Be aware of the fact that and iOS simulator uses a different build then a iOS real device. So please check the file you download.

The advice is to download the files to an apps folder in the root of this folder.

Make sure that when you downloaded the files from the releases page, that you rename the apps to the following:

• Android-MyDemoAppRN.{#.#.#}.build-{####}.apk => Android.MyDemoAppRN.apk
• iOS-Real-Device-MyRNDemoApp.{#.#.#}-{####}.ipa => iOS.MyDemoAppRN.ipa
• iOS-Simulator-MyRNDemoApp.{#.#.#}-{####}.zip => iOS.MyDemoAppRN.zip

If you don't do that then the scripts can't find the apps!

Upload apps to Sauce Storage

If you want to use Android emulators, Android real devices, iOS simulators or iOS real devices in the Sauce Labs platform, you need to upload the apps to the Sauce Storage.

Manual upload

Execute the following steps to manually upload the apps:

• Login to the Sauce Labs platform
• Go to LIVE > Mobile App
• Click on App Upload and OR select the folder, OR drag the apps to the screen to upload them

Automated upload

You can find a script to upload them to, OR the US, OR EU DC in this-file. You can push the files to the storage by doing the following from the folder appium-app-examples:

cd src/test/java/com/helpers/
push_apps_to_storage.sh

Run tests on Sauce Labs Android real devices

If you want to run the tests on Sauce Labs Android Real Devices then you can run the Android test with

// If using the US DC
 mvn clean test -Dtest=DeepLinkAndroidTest -Dregion=us

// If using the EU DC
 mvn clean test -Dtest=DeepLinkAndroidTest -Dregion=eu

The tests, which can be found here, will be executed on:

• Any available Samsung device with OS Android 12

The devices use dynamic allocation, meaning they will try to find an available device that matches a regular expression. NOTE: Make sure you are in the folder appium-app-examples when you execute this command

Run tests on Sauce Labs Android Emulators

If you want to run the tests on Sauce Labs Android emulators then you can run the Android test with

// If using the US DC
 mvn clean test -Dtest=DeepLinkAndroidTest -Dregion=us -Drdc=false

// If using the EU DC
 mvn clean test -Dtest=DeepLinkAndroidTest -Dregion=eu -Drdc=false

The tests, which can be found here, will be executed on:

• Android GoogleAPI Emulator with OS Android 12

NOTE: Make sure you are in the folder appium-app-examples when you execute this command