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 GBInstall 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

...

• 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:

...

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

...

• 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

...