/atxserver2

Smart Phone Management. Reimplement of atx-server with Python

Primary LanguageHTMLMIT LicenseMIT

atxserver2

移动设备管理平台

Beta，尝鲜者可提前体验，虽然还有很多没开发的

img

环境依赖

部署

Step 1

先准备好一个rethinkdb服务器(推荐部署到Linux上) 具体方法查看RethinkDB安装文档

Step 2

安装并启动Server，这里需要Python3.6以上版本

先将代码clone到本地，使用下面的方法安装依赖

pip3 install -r requirements.txt

最简单的启动方法 （默认连接的rethinkdb地址 localhost:28015)

# 启动方式，这也是最简单的启动方法
python3 main.py

# 指定认证方式
python3 main.py --auth simple # 默认是一个非常simple的认证，输入邮箱就可以
python3 main.py --auth openid # 网易内部使用
# 其他的认证方式还有待添加，非常欢迎PR

# 设置监听端口
python3 main.py --port 4000 # 默认监听的就是这个地址

通过环境变量的修改，可以更改RethinkDB的连接地址

# Linux环境
# the bellow is default value
export RDB_HOST=localhost
export RDB_PORT=28015
export RDB_USER=admin
export RDB_PASSWD=
export RDB_DBNAME=atxserver2

python3 main.py

启动之后，浏览器打开 http://localhost:4000，完成认证之后就可以顺利的看到设备列表页了。不过目前还是空的，什么都没有。

image

Step 3: Android设备接入

接下来，进行安卓设备接入。这时需要用到另外一个项目 atxserver2-android-provider 这个项目运行需要Python3.6+和NodeJS

这里我们强烈推荐使用Docker部署，源码部署请参考文档 atxserver2-android-provider

SERVER_URL="http://10.0.0.1:4000" # 这个修改成自己的atxserver2地址
docker pull $IMAGE
docker run -it --rm --privileged -v /dev/bus/usb:/dev/bus/usb --net host \
    codeskyblue/atxserver2-android-provider \
    python main.py --server ${SERVER_URL}

该镜像会把所有必要的资源 （atx-uiautomator.apk, minicap, minitouch, atx-agent) 全部推送到手机上。 一切就绪后，你可以进行远程真机的操作了。

atxserver2-remotecontrol

Step 3: iOS设备接入

TODO

操作指南

鼠标操作

  • Right-Click: BACK
  • Middle-Click: HOME

Developers

目前采用tornado+rethinkdb

目录结构参考了django, 代码绝大多数都用到的async的功能

|-- static  静态目录
|-- templates 前端界面
|-- web  网页代码
      |-- urls.py 路由整合文件
      |-- settings.py 配置文件
      |-- database.py 数据库操作相关
      |-- utils.py 常用配置
      |-- views 每个界面的逻辑
        |-- slave.py 与atxslave通信用
        |-- device.py 设备相关路由
        |-- base.py 基于RequestHandler的基类

接口

详情点击 接口REST API

Thanks

LICENSE

MIT