codeskyblue/atxserver2-android-provider

atxserver2-android-provider

该镜像为https://github.com/openatx/atxserver2%E7%9A%84%E5%AE%89%E5%8D%93%E8%AE%BE%E5%A4%87%E6%8F%90%E4%BE%9B%E8%80%85%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%8E%A5%E5%85%A5%E5%92%8C%E7%AE%A1%E7%90%86%E5%AE%89%E5%8D%93%E8%AE%BE%E5%A4%87%EF%BC%8C%E6%94%AF%E6%8C%81%E8%87%AA%E5%8A%A8%E5%8F%91%E7%8E%B0%E5%B7%B2%E6%8E%A5%E5%85%A5%E7%9A%84%E8%AE%BE%E5%A4%87%E5%B9%B6%E5%AE%89%E8%A3%85minicap%E3%80%81minitouch%E3%80%81atx-agent%E7%AD%89%E5%BF%85%E8%A6%81%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%96%B9%E4%BE%BF%E8%BF%9B%E8%A1%8C%E5%AE%89%E5%8D%93%E8%AE%BE%E5%A4%87%E7%9A%84%E8%87%AA%E5%8A%A8%E5%8C%96%E6%93%8D%E4%BD%9C%E4%B8%8E%E7%AE%A1%E7%90%86%E3%80%82

核心功能

• 自动发现通过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 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