### Mobile Chrome

To run the tests with Mobile Chrome on Android Simulator, follow these steps:

1. Download [Android Studio](https://developer.android.com/studio/) and on first
   start, follow the instructions to install the Android SDK and Emulator.

   **Please Note:**  
   To be able to use a custom `/etc/hosts` file requires mounting the root file
   system as writable, which requires a supported system image for the Android
   Virtual Device (AVD), e.g.:

   > Android 9 "Pie" (Google APIs)

   System images for Android 10 "Q" or system images including the Google Play
   store do not support mounting the root file system as writable.  
   See also John Wu's
   [Twitter post](https://twitter.com/topjohnwu/status/1170404631865778177) on
   Android 10's file system format.

2. Add the following lines to your `~/.profile` to make the JDK included in
   Android Studio and the installed Android SDK available to
   [Appium](https://appium.io/):

   ```sh
   export JAVA_HOME='/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home'
   export PATH="$JAVA_HOME/bin:$PATH"
   export ANDROID_HOME=~/Library/Android/sdk
   ```

3. Install [Node.JS](https://nodejs.org/) via [Homebrew](https://brew.sh/):

   ```sh
   brew install node
   ```

4. Make sure the necessary [Appium](https://appium.io/) dependencies for Android
   testing are installed:

   ```sh
   npx appium-doctor --android
   ```

5. Install [Appium](https://appium.io/) as global NPM package:

   ```sh
   npm install -g appium
   ```

6. Start `appium` with the provided helper script:

   ```sh
   bin/appium.sh
   ```

   This script is configured for
   [Automatic discovery of compatible Chromedriver](https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/web/chromedriver.md/#automatic-discovery-of-compatible-chromedriver)
   and will download a `chromedriver` version compatible with the version of
   Chrome running on the Android device.

7. Start the Android Virtual Device with a custom `/etc/hosts` file:

   ```sh
   bin/android-emulator.sh -hosts etc/android.hosts
   ```

   **How to update the installed Google Chrome version:**

   - Download a Google Chrome APK (Android Application Package) for the
     architecture of your emulated device (e.g. `x86`), e.g. from
     [APK Mirror](https://www.apkmirror.com/apk/google-inc/chrome/).
   - Drag&drop the APK file into the emulator window to install it or
     alternatively, install it via command-line:
     ```sh
     adb install com.android.chrome_*.apk
     ```

8. Run the tests with Mobile Chrome:

   ```sh
   docker-compose run --rm wdio conf/mobile-chrome.js
   ```

   To run the tests in landscape orientation, provide the `ORIENTATION`
   environment variable:

   ```sh
   ORIENTATION=LANDSCAPE docker-compose run --rm wdio conf/mobile-chrome.js
   ```