Updated Appium base image to version v2.11.1-p0

Merge pull request #441 from budtmo/dependabot/pip/master/autopep8-2.3.1
[pip] Bump autopep8 from 2.2.0 to 2.3.1
2026-07-31 04:07:25 +00:00 · 2024-07-09 10:58:32 +02:00 · 2024-06-30 18:15:08 +02:00 · 2024-06-30 18:14:47 +02:00 · 2024-06-23 23:18:37 +00:00 · 2024-06-23 23:18:31 +00:00
11 changed files with 129 additions and 20 deletions
@@ -0,0 +1,40 @@
+version: 2
+updates:
+- package-ecosystem: docker
+  directory: "/docker"
+  schedule:
+    interval: daily
+    time: '01:00'
+    timezone: "Europe/Berlin"
+  commit-message:
+    prefix: "[docker] "
+  target-branch: "master"
+  open-pull-requests-limit: 99
+  reviewers:
+    - "budtmo"
+
+- package-ecosystem: pip
+  directory: "/"
+  schedule:
+    interval: daily
+    time: '01:00'
+    timezone: "Europe/Berlin"
+  commit-message:
+    prefix: "[pip] "
+  target-branch: "master"
+  open-pull-requests-limit: 99
+  reviewers:
+    - "budtmo"
+
+- package-ecosystem: github-actions
+  directory: "/"
+  schedule:
+    interval: daily
+    time: '01:00'
+    timezone: "Europe/Berlin"
+  commit-message:
+    prefix: "[github-action] "
+  target-branch: "master"
+  open-pull-requests-limit: 99
+  reviewers:
+    - "budtmo"
@@ -13,10 +13,10 @@ jobs:
        python-version: ["3.8"]
    steps:
    - name: Checkout the repo
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4

    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
      with:
        python-version: ${{ matrix.python-version }}

@@ -35,7 +35,7 @@ jobs:
    needs: run_test
    steps:
    - name: Checkout the repo
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4

    - name: Get release version
      run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
@@ -51,10 +51,10 @@ jobs:
    needs: release_base
    strategy:
      matrix:
-        android: ["9.0", "10.0", "11.0", "12.0", "13.0"]
+        android: ["9.0", "10.0", "11.0", "12.0", "13.0", "14.0"]
    steps:
    - name: Checkout the repo
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4

    - name: Get release version
      run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
@@ -70,7 +70,7 @@ jobs:
    needs: release_base
    steps:
    - name: Checkout the repo
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4

    - name: Get release version
      run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
@@ -13,7 +13,7 @@ jobs:
    runs-on: ubuntu-20.04
    steps:
    - name: Checkout the repo
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4

    - name: Build base image
      run: script -e -c "./app.sh build base test"
@@ -11,7 +11,7 @@ Advantages of using this projects
 ---------------------------------
 1. Emulator with different device profile and skins, such as Samsung Galaxy S6, LG Nexus 4, HTC Nexus One and more.
 2. Support vnc to be able to see what happen inside docker container
-3. Support log sharing feature where all logs can be accessed from web-UI 
+3. Support log sharing feature where all logs can be accessed from web-UI
 4. Ability to control emulator from outside container by using adb connect
 5. Integrated with other cloud solutions, e.g. [Genymotion Cloud](https://www.genymotion.com/cloud/)
 6. It can be used to build Android project
@@ -26,6 +26,7 @@ List of Docker-Images
 |11.0|30|budtmo/docker-android:emulator_11.0|budtmo/docker-android:emulator_11.0_<release_version>|
 |12.0|32|budtmo/docker-android:emulator_12.0|budtmo/docker-android:emulator_12.0_<release_version>|
 |13.0|33|budtmo/docker-android:emulator_13.0|budtmo/docker-android:emulator_13.0_<release_version>|
+|14.0|34|budtmo/docker-android:emulator_14.0|budtmo/docker-android:emulator_14.0_<release_version>|
 |-|-|budtmo/docker-android:genymotion|budtmo/docker-android:genymotion_<release_version>|

 List of Devices
@@ -73,6 +74,45 @@ Quick Start
    docker exec -it android-container cat device_status
    ```

+Persisting data
+-----------
+
+The default behaviour is to destroy the emulated device on container restart. To persist data, you need to mount a volume at `/home/androidusr`:
+    ```
+    docker run -v data:/home/androidusr budtmo/docker-android:emulator_11.0
+    ```
+
+WSL2 Hardware acceleration (Windows 11 only)
+-----------
+
+Credit goes to [Guillaume - The Parallel Interface blog](https://www.paralint.com/2022/11/find-new-modified-and-unversioned-subversion-files-on-windows)
+
+[Microsoft - Advanced settings configuration in WSL](https://learn.microsoft.com/en-us/windows/wsl/wsl-config)
+
+
+1. Add yourself to the `kvm` usergroup.
+    ```
+    sudo usermod -a -G kvm ${USER}
+    ```
+
+2. Add necessary flags to `/etc/wsl2.conf` to their respective sections.
+    ```
+    [boot]
+    command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm'
+
+    [wsl2]
+    nestedVirtualization=true
+    ```
+3. Restart WSL2 via CMD prompt or Powershell
+    ```
+    wsl --shutdown
+    ```
+
+
+`command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm'` sets `/dev/kvm` to `kvm` usergroup rather than the default `root` usergroup on WSL2 startup.
+
+`nestedVirtualization` flag is only available to Windows 11.
+
 Use-Cases
 ---------

@@ -124,6 +164,7 @@ The differences between normal version and pro version are:
 |language|No|Yes|Set up language on Android emulator on fly|
 |root-privileged|No|Yes|Able to run command with security privileged|
 |headless-mode|No|Yes|Save resources by using headless mode|
+|Selenium 4.x integration|No|Yes|Running Appium UI-Tests againt one (Selenium Hub) endpoint for Android- and iOS emulator(s) / device(s)|
 |multiple Android-Simulators|No|Yes (soon)|Save resources by having multiple Android-Simulators on one docker-container|
 |Google Play Store|No|Yes (soon)|-|
 |Video Recording|No|Yes (soon)|Helpful for debugging|
@@ -27,7 +27,7 @@ fi
 is_str_in_list ${p} ${projects[@]}

 if [ -z "${3}" ]; then
-    read -p "Release Version (v2.0-p0|v2.0-p1|etc) : " r_v
+    read -p "Release Version (v2.0.0-p0|v2.0.0-p1|etc) : " r_v
 else
    r_v=${3}
 fi
@@ -48,13 +48,14 @@ else
 fi

 if [[ "${p}" == *"emulator"* ]]; then
-    supported_android_version=("9.0" "10.0" "11.0" "12.0" "13.0")
+    supported_android_version=("9.0" "10.0" "11.0" "12.0" "13.0" "14.0")
    declare -A api_levels=(
        ["9.0"]=28
        ["10.0"]=29
        ["11.0"]=30
        ["12.0"]=32
        ["13.0"]=33
+        ["14.0"]=34
    )

    # To get the last index
@@ -1,6 +1,6 @@
-autopep8==2.0.2
-click==8.1.3
-coverage==7.2.5
-mock==5.0.2
+autopep8==2.3.1
+click==8.1.7
+coverage==7.5.4
+mock==5.1.0
 nose==1.3.7
-requests==2.31.0
+requests==2.32.3
@@ -30,7 +30,8 @@ class Emulator(Device):
        "10.0": "29",
        "11.0": "30",
        "12.0": "32",
-        "13.0": "33"
+        "13.0": "33",
+        "14.0": "34"
    }

    adb_name_id = 5554
@@ -1,4 +1,4 @@
-FROM appium/appium:v2.0.0-p0
+FROM appium/appium:v2.11.1-p0

 LABEL maintainer "Budi Utomo <budtmo.os@gmail.com>"

@@ -99,6 +99,8 @@ ENV LOG_PATH=${WORK_PATH}/logs \
    WEB_LOG_PORT=9000
 EXPOSE 9000
 RUN mkdir -p ${LOG_PATH}
+RUN mkdir -p "${WORK_PATH}/.config/Android Open Source Project" \
+ && echo "[General]\nshowNestedWarning=false\n" > "${WORK_PATH}/.config/Android Open Source Project/Emulator.conf"

 #=========
 # Run App
@@ -12,6 +12,7 @@ The differences between normal version and pro version are:
 |language|No|Yes|Set up language on Android emulator on fly|
 |root-privileged|No|Yes|Able to run command with security privileged|
 |headless-mode|No|Yes|Save resources by using headless mode|
+|Selenium 4.x integration|No|Yes|Running Appium UI-Tests againt one (Selenium Hub) endpoint for Android- and iOS emulator(s) / device(s)|
 |multiple Android-Simulators|No|Yes (soon)|Save resources by having multiple Android-Simulators on one docker-container|
 |Google Play Store|No|Yes (soon)|-|
 |Video Recording|No|Yes (soon)|Helpful for debugging|
@@ -26,15 +27,18 @@ List of Docker-Images
 |11.0|30|Normal|budtmo2/docker-android-pro:emulator_11.0|budtmo2/docker-android-pro:emulator_11.0_<release_version>|
 |12.0|32|Normal|budtmo2/docker-android-pro:emulator_12.0|budtmo2/docker-android-pro:emulator_12.0_<release_version>|
 |13.0|33|Normal|budtmo2/docker-android-pro:emulator_13.0|budtmo2/docker-android-pro:emulator_13.0_<release_version>|
+|14.0|34|Normal|budtmo2/docker-android-pro:emulator_14.0|budtmo2/docker-android-pro:emulator_14.0_<release_version>|
 |9.0|28|Headless|budtmo2/docker-android-pro:emulator_headless_9.0|budtmo2/docker-android-pro:emulator_headless_9.0_<release_version>|
 |10.0|29|Headless|budtmo2/docker-android-pro:emulator_headless_10.0|budtmo2/docker-android-pro:emulator_headless_10.0_<release_version>|
 |11.0|30|Headless|budtmo2/docker-android-pro:emulator_headless_11.0|budtmo2/docker-android-pro:emulator_headless_11.0_<release_version>|
 |12.0|32|Headless|budtmo2/docker-android-pro:emulator_headless_12.0|budtmo2/docker-android-pro:emulator_headless_12.0_<release_version>|
 |13.0|33|Headless|budtmo2/docker-android-pro:emulator_headless_13.0|budtmo2/docker-android-pro:emulator_headless_13.0_<release_version>|
+|14.0|34|Headless|budtmo2/docker-android-pro:emulator_headless_14.0|budtmo2/docker-android-pro:emulator_headless_14.0_<release_version>|
+|-|-|Selenium|budtmo2/docker-android-pro:selenium|budtmo2/docker-android-pro:selenium_<release_version>|

 ***Note: Headless mode does not have any Web-UI***

-You can always pull the latest image tag. In case you want to see the release version that has been built with a changelog note and use that specific release version, ythe information will be sent to you as well.
+You can always pull the latest image tag. In case you want to see the release version that has been built with a changelog note and use that specific release version, the information will be sent to you as well.


 List of Devices
@@ -77,9 +81,13 @@ You can change the language setting of Android Emulator on the fly by passing fo
 - EMULATOR_COUNTRY="\<country>"


-Version
-------
+Selenium
+--------

+Pull and run image that contains Selenium with Appium urls and its capabilities which is stored inside node.json file:

+```
+docker run -t --rm --name selenium -p 4444:4444 -v $PWD/pro-example/node.json:/home/seleniumusr/selenium_node_config/node.json budtmo2/docker-android-pro:selenium
+```

 [<- BACK TO README](../README.md)
@@ -0,0 +1,16 @@
+[
+    {
+      "appium_url": "http://xx.xx.xx.xx:4723",
+      "capability_platform": "android",
+      "capability_platform_version": "11.0",
+      "capability_device_name": "samsung_galaxy_s6_11.0",
+      "capability_automation_name": "UIAutomator2"
+    },
+    {
+      "appium_url": "http://xx.xx.xx.xx:4724",
+      "capability_platform": "android",
+      "capability_platform_version": "10.0",
+      "capability_device_name": "nexus_5_10.0",
+      "capability_automation_name": "UIAutomator2"
+    }
+]