Android¶
By default Gauze will run tests on real device connected to host. To check
that device is connected successfully run adb devices
:
> adb devices
List of devices attached
<device-name> device
To use emulator add GAUZE_ANDROID_USE_EMULATOR=ON
. In this case AVD
will be created automatically and emulator will be launched:
Creating AVD with name 'gauze_android-19_armeabi-v7a'
Starting emulator
Waiting for emulator
Emulator is ready!
Created AVD can be found in list of available AVDs:
> /.../android-sdk/tools/android list avd
Name: gauze_android-19_armeabi-v7a
Path: /.../.android/avd/gauze_android-19_armeabi-v7a.avd
Target: Android 4.4.2 (API level 19)
Tag/ABI: default/armeabi-v7a
Skin: WVGA800
Emulator is visible by the same adb device
command:
> /.../android-sdk/platform-tools/adb devices
List of devices attached
emulator-5678 device
<device-name> device
Deleting AVD:
> /.../android-sdk/tools/android delete avd --name gauze_android-19_armeabi-v7a
Deleting file /.../.android/avd/gauze_android-19_armeabi-v7a.ini
Deleting folder /.../.android/avd/gauze_android-19_armeabi-v7a.avd
AVD 'gauze_android-19_armeabi-v7a' deleted.
Emulator can be stopped by kill -9
command:
> ps aux | grep gauze_android
<username> 9160 ... /.../android-sdk/tools/emulator64-arm -avd gauze_android-19_armeabi-v7a -no-window -port 5678 -gpu host
> kill -9 9160
Warning
Pushed resource file and executable are not cleaned up automatically. You
have to remove files explicitly from GAUZE_ANDROID_DEVICE_TESTING_ROOT
directory (defaults to /data/local/tmp
):
> adb shell
> cd /data/local/tmp
> ls -la
> rm -rf somefile somedir
Other options¶
GAUZE_ANDROID_EMULATOR_GPU¶
You can set GAUZE_ANDROID_EMULATOR_GPU
to control what GPU type will be
using while creating Android emulator:
Hint
For Travis CI:
- use
host
on macOS machines - use
off
on Linux machines
GAUZE_ANDROID_EMULATOR_PARTITION_SIZE¶
You can set GAUZE_ANDROID_EMULATOR_PARTITION_SIZE
to specify the system
data partition size in MBs.
GAUZE_ANDROID_PUSH_QUIET¶
Set GAUZE_ANDROID_PUSH_QUIET
to ON
to suppress output from adb push
commands.
GAUZE_ANDROID_PUSH_RESOURCES_ONLY¶
Do not run tests but only push resources.
GAUZE_ANDROID_START_EMULATOR¶
Gauze will create suitable Android emulator image and start emulator
automatically. In case if you want to reuse existing emulator instead, e.g. one
created manually in Android Studio, you can set GAUZE_ANDROID_START_EMULATOR
option to OFF
. GAUZE_ANDROID_START_EMULATOR
is set to ON
by default.
Real device | Emulator (automatically) | Emulator (external) | |
---|---|---|---|
adb shell [1] | adb -d shell |
adb -e shell |
adb -e shell |
GAUZE_ANDROID_USE_EMULATOR | OFF [2] |
ON |
ON |
GAUZE_ANDROID_START_EMULATOR | - |
ON [3] |
OFF |
[1] | https://developer.android.com/studio/command-line/adb#issuingcommands |
[2] | By default real device used |
[3] | By default Gauze will start emulator automatically |