You can use an android emulator to help you develop your GDSL tests. It is usefull if you do not have a real device or if you want to test on a device with the same resolution as a device on the Test Bench. Do not use emulator if you want measures, the metrics (energy, data …) are not available.

...

• 16 GB of RAM memory

• Available Disk storage > 10 GB

• Install Android Studio

• Install Android SDK Tools to have uiautomatorviewer from Android Studio:

  • Open Android Studio

  • Click on More Actions > SDK Manager (or Tools > SDK Manager if a project is open)

  • Click on the SDK Tools tab, uncheck "Hide Obsolete Packages"

  • Check Android SDK Tools and install version 26.1.1

• On Windows only, turn vulkan off to be able to load web pages (only if you want to test web pages) :

  • Open Windows start menu

  • Select Notepad

  • Add the following text :

    Code Block
    language bash
    Vulkan = off GLDirectMem = on

  • Click on File > Save as : go to C:\Users\[username]\.android and name the file advancedFeatures.ini

...

• Follow the first part of the prerequisite (part 1.1)

• Install Android SDK Tools:

  • Install Android Studio if you don’t have it

  • Open Android Studio

  • Click on More Actions > SDK Manager (or Tools > SDK Manager if a project is open)

  • Click on the SDK Tools tab, uncheck "Hide Obsolete Packages"

  • Check Android SDK Tools and install version 26.1.1

• Add ADB (Android Debug Bridge) to your path / environment variables:

  • On Linux: add the line export PATH=$HOME/Android/Sdk/platform-tools:$PATH in the .bashrc file and run the command "source ~/.bashrc"

  • On Mac: add the line export PATH=$HOME/Library/Android/sdk/platform-tools:$PATH in the .bash_profile file and run the command "source ~/.bash_profile"

  • On Windows: Windows start menu > Settings > System > About > Advanced settings > Environment variables > Path > Modify > Add the path C:\Users\[username]\AppData\Local\Android\Sdk\platform-tools. Replace username by the name of the user.

• Add AAPT (Android Asset Packaging Tool) to your environment variables:

  • On Linux: add the line export PATH=$HOME/Android/Sdk/build-tools/[aapt_folder]:$PATH in the .bashrc file and run the command "source ~/.bashrc". Replace aapt_folder by the name of the aapt folder.

  • On Mac: add the line export PATH=$HOME/Library/Android/sdk/build-tools/[aapt_folder]:$PATH in the .bash_profile file and run the command "source ~/.bash_profile". Replace aapt_folder by the name of the aapt folder.

  • On Windows: Windows start menu > Settings > System > About > Advanced settings > Environment variables > Path > Modify > Add the path C:\Users\[username]\AppData\Local\Android\Sdk\build-tools\[aapt_folder]. Replace username by the name of the user and aapt_folder by the name of the aapt folder.

• Get the testrunner from https://app.greenspector.com/ in the Modules tab, and put it in a folder (for example “testrunner_files”)

• Add in this folder the configuration files config.yml and job.yml, and a script with the testgb extension. An example of these files is available at the following location:

  • configuration files: https://app.greenspector.com/download > Test Runner: Download > “Config - Android” and “Job - Android”

  • testgb file: https://app.greenspector.com/download > GDSL Templates: Download (you can choose between a test file for an Android application, a website, or an iOS application)

  You can find the documentation about the gdsl functions here

Useful documentation :

• Android GDSL functions: https://dsl.greenspector.com/

• How to use uiautomatorviewer to get elements of a view (by id, text, class or description) to write GDSL test: Get elements of a view (UIAutomatorViewer)

2. Use an android emulator without Greenspector tools

...

• Check the configuration and click on “Finish”. Be careful, the configuration might be different than the one you chose. Make sure to click on “Show Advanced Settings” and check each property.

• Your device is now created. You can launch it by clicking on the triangle.

...

2.2. Emulators tested

...

• Open the configuration file of your emulator. Replace [device_id] by the id of your device.

  • On Linux and macOS: $HOME/.android/avd/[device_id]/config.ini

  • On Windows: C:\Users\[username]\.android\avd\[device_id]\config.ini

• Make the following changes:

  • PlayStore.enabled: change from “false” to “true”

  • image.sysdir.1: change “google_apis” to “google_apis_playstore”

  • tag.display: change “Google APIs” to “Google Play”

  • tag.id: change “google_apis” to “google_apis_playstore”

• Save your changes

• On the Device Manager window, select the three dots button and click on “Wipe Data”. It will load the new configuration.

• We expect the following error message:

...

# For newer version of Android SDK
export PATH=$HOME/Android/Sdk/emulator:$PATH

# For older version of Android SDK
export PATH=$HOME/Android/Sdk/tools:$PATH

• On macOS: Update ~/.bashrc or ~/.bash_profile

export PATH=$HOME/Library/Android/Sdk/emulator:$PATH

...

job:
   url: com.google.android.youtubechrome

In the second case, it installs the app at the beginning of the test and uninstalls it at the end.

...

• Launch an android emulator

  • Option 1: open the Device Manager window of Android Studio and click on the triangle

  • Option 2: start an emulator from the command line (part 2.5)

• If you run the testrunner for the first time, you have to run it once without the --no-update option:

  • On Linux and macOS: ./testrunner -jobFile job.yml -config config.yml

  • On Windows: testrunner -jobFile job.yml -config config.yml

• Download the android-service executable in 32 bits and its version file : https://dl.greenspector.com/emulator/android-service-files.tar.gz

• Go to your greenspector cache:

  • On Linux and macOS: $HOME/.greenspector

  • On Windows: C:\Users\[username]\.greenspector

• Replace the android-service and android-service.version files with the downloaded files. You will have to decompress the tar.gz file.

• You can now run the testrunner with the --no-update option:

  • On Linux and macOS: ./testrunner -jobFile job.yml -config config.yml --no-update

  • On Windows: testrunner -jobFile job.yml -config config.yml --no-update

...