docker-android

Docker-Android 是一个专为 Android 相关的一切而构建的 docker 镜像。它可用于应用程序开发和测试（原生、网页和混合应用）。

使用本项目的优势

1. 支持不同设备配置和外观的模拟器，如三星 Galaxy S6、LG Nexus 4、HTC Nexus One 等。
2. 支持 VNC，可以查看 docker 容器内部的情况。
3. 支持日志共享功能，所有日志可通过 Web 界面访问。
4. 能够通过 adb connect 从容器外部控制模拟器。
5. 与其他云解决方案集成，如 Genymotion Cloud。
6. 可用于构建 Android 项目。
7. 可用于运行不同测试框架的单元测试和 UI 测试，如 Appium、Espresso 等。

Docker 镜像列表

设备列表

要求

1. 系统中已安装 Docker。

快速开始

1. 如果您的主机使用 Ubuntu 操作系统，可以跳过此步骤。对于 OSX 和 Windows 操作系统 用户，您需要使用支持虚拟化的虚拟机并安装 Ubuntu 操作系统，因为该镜像仅能在 Ubuntu 操作系统 下运行。

2. 您的机器应支持虚拟化。检查是否启用虚拟化的方法是：

   sudo apt install cpu-checker
   kvm-ok
   

3. 运行Docker-Android容器

   docker run -d -p 6080:6080 -e EMULATOR_DEVICE="Samsung Galaxy S10" -e WEB_VNC=true --device /dev/kvm --name android-container budtmo/docker-android:emulator_11.0
   

4. 打开***http://localhost:6080***查看正在运行的容器内部。

5. 检查模拟器状态

   docker exec -it android-container cat device_status
   

数据持久化

默认情况下，容器重启时会销毁模拟设备。要持久化数据，需要在/home/androidusr挂载一个卷： docker run -v data:/home/androidusr budtmo/docker-android:emulator_11.0

WSL2硬件加速（仅限Windows 11）

感谢Guillaume - The Parallel Interface博客

Microsoft - WSL中的高级设置配置

1. 将自己添加到kvm用户组。

   sudo usermod -a -G kvm ${USER}
   

2. 在/etc/wsl2.conf的相应部分添加必要的标志。

   [boot]
   command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm'
   
   [wsl2]
   nestedVirtualization=true
   

3. 通过CMD提示符或Powershell重启WSL2

   wsl --shutdown
   

command = /bin/bash -c 'chown -v root:kvm /dev/kvm && chmod 660 /dev/kvm'在WSL2启动时将/dev/kvm设置为kvm用户组，而不是默认的root用户组。

nestedVirtualization标志仅适用于Windows 11。

使用案例

1. 构建Android项目
2. 使用Appium进行UI测试
3. 在主机上控制Android模拟器
4. 短信模拟
5. Jenkins
6. 在云端部署（Azure、AWS、GCP）

自定义配置

这份文档包含了可用于启用某些功能的配置信息，例如日志共享等。

Genymotion

对于那些没有资源维护模拟器或购买机器或需要不同设备配置的人，可以尝试使用Genymotion SAAS。Docker-Android在不同的云服务上与Genymotion集成，例如Genymotion SAAS、AWS、GCP、阿里云。更多详情请参阅此文档。

模拟器皮肤

模拟器皮肤来自Android Studio IDE和Samsung开发者网站

用户

专业版

由于大量的帮助请求以及为了能够积极维护项目，创建者决定推出docker-android-pro。Docker-Android-Pro是一个基于赞助的项目，这意味着只有活跃的赞助者才能拉取专业版的docker镜像。

普通版本和专业版本的区别是：

本文档包含了如何使用docker-android-pro的详细信息。

许可证

参见许可证