MapLibreParticleLab/platform/android/TESTS.md

Mapbox GL Test App

Testing

Running Espresso tests on a device

This test project comes with all the required Android Testing Support Library dependencies in the Gradle file. Tests are under the app/src/androidTest folder.

Note that before running your tests, you might want to turn off animations on your test device. It's a known issue that leaving system animations turned on in a test device (window animation scale, transition animation scale, animator duration scale) might cause unexpected results, or may lead tests to fail.

To create a new run configuration:

• Click on Run -> Edit Configurations...
• Click on the plus sign and then on "Android Tests"
• Give a name to the configuration, e.g. TestAppTests
• Choose the MapLibreAndroidTestApp module
• Choose android.support.test.runner.AndroidJUnitRunner as the instrumentation runner
• Click OK to save the new configuration

You can now run this configuration from the main toolbar dropdown menu.

Running pure JUnit tests

These tests run on a local JVM on your development machine and they are extremely fast to run (as compared to Espresso). These tests are located under src/test/java. To run them you switch to the Unit Tests build variant, then right click the corresponding test class or method and select "Run ...".

You can also have a run configuration:

• Click on Run -> Edit Configurations...
• Click on "Junit Tests"
• Give a name to the configuration, e.g. JUnit tests
• As "Test Kind", choose "All in directory"
• As folder, choose the following folder: mapbox-gl-native/android/java/MapLibreAndroidTestApp/src/test/java
• Click OK to save the new configuration

You can also run the tests from the command line with:

$ ./gradlew -Pmapbox.abis=none test -p MapLibreAndroidTestApp

Running the UI/Application Exerciser Monkey

Similar to the "Built-in: Fuzz" test mentioned above, Android provides Monkey, "a program that runs on your emulator or device and generates pseudo-random streams of user events such as clicks, touches, or gestures, as well as a number of system-level events."

To exercise Monkey on the test app, install the package on the device (e.g. via Android Studio) and then:

$ adb shell monkey -p org.maplibre.testapp -v 500