codeskyblue/atxserver2-android-provider

atxserver2-android-provider

该镜像为https://github.com/openatx/atxserver2的安卓设备提供者，用于接入和管理安卓设备，支持自动发现已接入的设备并安装minicap、minitouch、atx-agent等必要工具，方便进行安卓设备的自动化操作与管理。

核心功能

• 自动发现通过USB接入的安卓设备
• 自动安装minicap、minitouch、atx-agent等工具到设备
• 提供应用安装接口（通过URL安装APK）
• 提供设备冷却接口（用于设备降温与软件清理）

使用场景

• 安卓应用自动化测试环境搭建
• 多安卓设备集中管理场景
• 安卓设备批量操作需求场景

配置说明

Docker部署（推荐）

安装Docker（Linux系统）

bash
curl -fsSL https://get.docker.com | sh

使用Docker Hub镜像部署

bash
IMAGE="codeskyblue/atxserver2-android-provider"
SERVER_URL="http://你的atxserver2地址:4000" # 替换为实际地址
docker pull $IMAGE
docker run -it --rm --privileged -v /dev/bus/usb:/dev/bus/usb --net host \
    ${IMAGE} python main.py --server ${SERVER_URL}

手动构建镜像（依赖git-lfs）

bash
git lfs clone https://github.com/openatx/atxserver2-android-provider
cd atxserver2-android-provider
docker build -t atx2android .
docker run -it --rm --privileged -v /dev/bus/usb:/dev/bus/usb --net host docker.xuanyuan.run/atx2android python main.py --server localhost:4000

源码部署

依赖Python3.6+、NodeJS、Git-LFS

bash
git lfs clone https://github.com/openatx/atxserver2-android-provider
cd atxserver2-android-provider
# 安装依赖
npm install
pip install -r requirements.txt
# 启动（替换为实际atxserver2地址）
python3 main.py --server localhost:4000

接口使用

安装应用（需认证）

bash
http POST $SERVER/app/install?udid=${设备UDID} secret=$SECRET url==http://example.com/demo.apk

冷却设备（需认证）

bash
http POST $SERVER/cold?udid=${设备UDID} secret=$SECRET

（注：secret可在provider启动时获取）

LICENSE

MIT