ReDroid: 云端Android解决方案的全面介绍

ReDroid简介

ReDroid(Remote Android的简称)是一个支持GPU加速的云端Android解决方案。它允许用户在Linux主机上(如Docker、Podman、Kubernetes等环境)启动多个Android实例。ReDroid同时支持arm64和amd64架构,适用于云游戏、虚拟手机、自动化测试等多种场景。

ReDroid截图

目前ReDroid支持以下Android版本:

Android 14 (redroid/redroid:14.0.0-latest)
Android 13 (redroid/redroid:13.0.0-latest)
Android 12 (redroid/redroid:12.0.0-latest)
Android 11 (redroid/redroid:11.0.0-latest)
Android 10 (redroid/redroid:10.0.0-latest)
Android 9 (redroid/redroid:9.0.0-latest)
Android 8.1 (redroid/redroid:8.1.0-latest)

此外,ReDroid还提供了仅64位的版本,如redroid/redroid:14.0.0_64only-latest。

快速开始

ReDroid可以在任何启用了必要内核功能的Linux发行版上运行。以下是在Ubuntu 20.04上的快速启动步骤:

安装Docker:

# 参考 https://docs.docker.com/engine/install/#server 安装Docker

安装所需的内核模块:

apt install linux-modules-extra-`uname -r`
modprobe binder_linux devices="binder,hwbinder,vndbinder"
modprobe ashmem_linux

运行ReDroid:
```
docker run -itd --rm --privileged \
    --pull always \
    -v ~/data:/data \
    -p 5555:5555 \
    redroid/redroid:11.0.0-latest
```
说明:
- --pull always: 使用最新镜像
- -v ~/data:/data: 挂载数据分区
- -p 5555:5555: 暴露adb端口
⚠️ 警告: 不要在公共网络上暴露adb端口,否则ReDroid容器(甚至主机操作系统)可能会被入侵。

连接ADB:

# 安装ADB: https://developer.android.com/studio#downloads
adb connect localhost:5555

查看ReDroid屏幕:
```
# 安装scrcpy: https://github.com/Genymobile/scrcpy/blob/master/README.md#get-the-app
scrcpy -s localhost:5555
```
注意: 如果远程运行ReDroid,请将localhost更改为相应IP地址。通常在本地PC上运行scrcpy。

配置选项

ReDroid提供了多种配置选项,允许用户自定义显示设置、网络代理、GPU模式等。以下是一个自定义显示设置的示例:

docker run -itd --rm --privileged \
    --pull always \
    -v ~/data:/data \
    -p 5555:5555 \
    redroid/redroid:11.0.0-latest \
    androidboot.redroid_width=1080 \
    androidboot.redroid_height=1920 \
    androidboot.redroid_dpi=480

常用配置参数包括:

androidboot.redroid_width: 显示宽度(默认720)
androidboot.redroid_height: 显示高度(默认1280)
androidboot.redroid_fps: 显示帧率(GPU启用时默认30,未启用时15)
androidboot.redroid_dpi: 显示DPI(默认320)
androidboot.redroid_gpu_mode: GPU模式(auto/host/guest,默认auto)

更多配置选项请参考ReDroid官方文档。

原生桥接支持

ReDroid支持在x86架构的实例上运行arm应用程序,这是通过libhoudini、libndk_translation或QEMU translator实现的。官方发布的ReDroid镜像已经包含了libndk_translation。

要启用原生桥接支持,可以参考以下步骤:

准备原生桥接文件结构
创建自定义Dockerfile
构建新的Docker镜像
运行包含原生桥接支持的ReDroid实例

详细步骤请查看ReDroid原生桥接支持文档。

GMS支持

ReDroid可以通过Open GApps、MicroG或MindTheGapps添加GMS(Google移动服务)支持。具体实现方法请参考android-builder-docker文档。

WebRTC流媒体

ReDroid计划从cuttlefish移植WebRTC解决方案,包括前端(HTML5)、后端和多个虚拟HAL。这将为ReDroid提供更强大的远程访问能力。

构建方法

ReDroid的构建过程与AOSP构建过程相同,但建议使用Docker进行构建。详细的构建说明可以在android-builder-docker文档中找到。

故障排除

在使用ReDroid时可能遇到一些常见问题,以下是一些故障排除技巧:

收集调试信息:

curl -fsSL https://raw.githubusercontent.com/remote-android/redroid-doc/master/debug.sh | sudo bash -s -- [CONTAINER]

容器立即消失: 确保已安装所需的内核模块,运行dmesg -T查看详细日志。
容器运行但ADB无法连接: 运行docker exec -it <container> sh,然后检查ps -A和logcat输出。

如果遇到其他问题,可以尝试在ReDroid GitHub Issues中搜索或提问。

联系方式

如果您在使用ReDroid过程中遇到任何问题或有任何建议,可以通过以下方式与开发团队联系:

Slack: remote-android.slack.com
邮箱: ziyang.zhou@outlook.com

许可证

ReDroid本身采用Apache License 2.0许可。但由于ReDroid包含许多第三方模块,使用时请仔细检查相关许可证。ReDroid的内核模块采用GPL v2许可。

结语

ReDroid为云端Android解决方案提供了强大而灵活的选择。无论您是开发者、测试人员还是云服务提供商,ReDroid都能为您的项目带来便利。通过本文的介绍,相信您已经对ReDroid有了全面的了解。我们鼓励您亲自尝试ReDroid,探索其在云端Android应用中的无限可能。

如果您对ReDroid感兴趣,不妨立即开始尝试,并加入ReDroid的开源社区,为这个项目贡献自己的力量。让我们共同推动云端Android技术的发展,创造更多令人惊叹的应用场景! 🚀🤖