本文首发于：行者AI

公司次要业务蕴含游戏AI及自动化测试，咱们的AI团队须要利用挪动设施对游戏内AI机器人的体现做一些持续性跟踪优化，自动化测试团队这边对于游戏的UI自动化测试开发工作也在一直向前推动，两者对于挪动设施的应用都是必要的。

因为挪动设施资源无限，存在频繁互借，遗记偿还等状况。为了解决治理和调用问题，咱们做了一些深刻调研，最初理解到，能够采纳开源框架STF或者是ATXServer2来解决，将无限的资源达到最大化的输入。上面会对通过这两种形式搭建挪动设施治理平台做个简略的介绍，同时，也做个简略的比拟，大家能够依据公司业务状况对其进行抉择。

1. 基于STF搭建挪动设施治理平台

1.1 STF介绍及优劣势剖析

  • STF是最早的近程真机调试平台，当初所有的近程真机调试其实都是借鉴了它的实现思维。
  • STF github地址
  • STF 官网地址

  • 劣势

    • 反对安卓2.3-10.0零碎（10.0零碎为目前最新）
    • 通过浏览器近程管制，反对近程鼠标键盘对真机进行操作
    • 近程复制粘贴性能
    • 快照截图
    • 利用包及文件的上传/下载性能
    • 反对近程端浏览器进行真机拜访操作
    • 日志输入及谬误日志输入打印
    • 脚本运行（可实现后续的自动化测试）
    • 开发人员进行近程debug性能
    • 提供设施机的CPU，内存，电量等性能的监测
    • 固化测试机器的零碎版本，零碎设置，不被篡改

  • 劣势

    • 仅反对安卓手机近程管制，iOS不反对（须要二次开发）
    • 并不能很好兼容国内各种各样的安卓定制化手机，可能会遇到STF.APK无奈失常装置到手机或者无奈失常主动启动服务的状况。

1.2 架构介绍（Nodejs+Angularjs+Rethinkdb）

STF的外围性能能够了解为：“同步图像” + “点击”。前者应用minicap实现，后者依赖minitouch。

具体构造看下图:

设施端

  • STF在会在android设施上装置minicap和minitouch。应用minicap来捕捉屏幕，应用minitouch来触发多点触控事件，并通过adb应用socket在服务端和设施端进行数据传输。
  • STF还会在android设施上装置STFService.apk，它在设施后盾运行，提供了一组socket api能够用来监控和执行不同的action。 同理，它也是通过adb和服务端通信，不过它应用的是protocal buffer数据格式。
  • minirev，间接从Android设施的端口转发本地服务，即使不在一个网段。

服务端

  • STF的服务端由多个不同的独立的，基于nodejs的微服务组成，这些服务之间是通过ZeroMQ通信。服务端能够进一步分成Provider 层和Application层。

Provider 层

  • Provider层（stf-provider）次要负责和设施之间进行通信。
  • 通过adb来监控设施状态，当有新的设施连贯，或者有设施断开则会立即监控到。
  • 如果是新的connect设施，则provider会folck一个新的nodejs过程（stf-device）， 这个过程次要负责与该设施的所有通信。
  • stf由两个局部组成，别离是stf-provider和adb。
  • 须要留神的是，provider层的服务须要跑在物理机上，所有的设施须要连着这台物理机。

Application 层

  • Application层则是由stf -api、stf -app和stf -auth等微服务组成，这些微服务组成了一个残缺的STF。
  • 从部署的角度来看，这些服务能够跑在任意中央，惟一的要求就是，这些服务可能通过网络和provider通信，这也就是意味着他们须要在同一个网段上。

Client 层

  • 应用Angular JS实现
  • 通过websocket与服务进行通信

1.3 环境搭建

强烈建议在Centos下利用docker搭建，置信我，这相对是最优且最简略的形式。

（1）装置docker服务

  • 进入docker官网下载对应docker安装包进行装置
  • 命令行执行docker version查看是否装置胜利

（2）利用docker拉取镜像文件

  • 开启docker服务
  • 拉取docker镜像文件
docker pull devicefarmer/stf:latestdocker pull sorccu/adb:latestdocker pull rethinkdb:latestdocker pull openstf/ambassador:latestdocker pull nginx:latest
  • 通过docker images查看镜像文件是否拉取胜利

（3） 启动容器

  • 先启动一个数据库
docker run -d --name rethinkdb -v /srv/rethinkdb:/data --net host rethinkdb rethinkdb --bind all --cache-size 8192 --http-port 8090
  • 再启动adb service
docker run -d --name adbd --privileged -v /dev/bus/usb:/dev/bus/usb --net host sorccu/adb:latest
  • 最初启动stf
docker run -d --name stf --net host openstf/stf stf local --public-ip 宿主机IP地址

肯定要留神启动程序，stf 依赖 rethinkdb，所以要先启动 rethinkdb，启动实现后应用: docker ps -a 查看是否启动胜利，顺便获取stf的container ID。

（4） 启动STF程序

  • 首先进入stf镜像目录
docker exec -it stf的containerID /bin/sh
  • 启动stf命令
stf local --public-ip 宿主机IP地址 --allow-remote

启动之后，局域网浏览器输出 http://宿主机IP地址:7100 能够关上STF登录界面，随便输出帐号邮箱后登录，不过目前还没有设施。

（5） 连贯设施

因为是在Centos虚拟环境搭建的平台，不能进行设施直连，故在局域网windows电脑连贯设施进行近程连贯，在未装置STF 的电脑上裸露adb端口（搭建SDK环境），倡议采纳默认端口:5037；

指定端口号与服务器进行通信：

adb -a -P 5037 fork-server server

如果呈现以下谬误:

在工作管理器中关掉 adb.exe，或应用命令 adb kill-server 关掉adb程序，从新运行上述命令。若还是执行失败，倡议换成低版本adb（1.0.32版本）再试试。

直到执行命令呈现OK。

（6）切换到Centos环境连贯windows下挪动设施

在启动STF的命令行输出：

stf provider --name localhost.localdomain --min-port 7400 --max-port 7700 --connect-sub tcp://127.0.0.1:7114 --connect-push tcp://127.0.0.1:7116 --group-timeout 900 --public-ip 宿主机IP地址 --storage-url http://localhost:7100/ --adb-host 局域网windowsIP地址 --adb-port 5037 --vnc-initial-size 600x800 --mute-master never --allow-remote

连贯胜利后显示挪动设施信息：

STF设施列表界面：

STF设施操作界面：

1.4 过程中可能用到的一些命令

docker

docker start 容器名  #启动某个容器docker stop 容器名   #进行某个容器docker rm 容器名     #删除某个容器

linux

netstat -anp |grep 端口号   #查看端口占用kill -9 对应端口PID        #删除过程

2. 基于ATXServer2搭建挪动设施治理平台

2.1 ATXServer2根本介绍

ATXServer2其实是在STF根底上，应用Python3+NodeJS+rethinkdb搭建的一个设施治理平台，性能和STF差不多，然而能够实现IOS设施近程管制。

ATXServer2 github地址

2.2 ATXServer2近程管制原理简介

Android的近程管制次要还是基于 minicap+minitouch+atx-agent；

IOS的近程管制次要还是基于appium fork的WebDriverAgent，因为appium在WDA中减少了MJPEG Server，所以让近程投屏成为了可能。（不过只反对iOS 12.0以上）

2.3 ATXServer2整体我的项目构造

整体我的项目次要包含四局部：

  • rethinkdb: 一个开源的轻量级的数据库，是用来存储数据的。rethinkdb官网地址
  • atxserver2 ：这一部分次要负责解决数据，显示与用户的前端交互等等，所以独自运行atxserver2也能够看到成果，当运行起来以候拜访: IP:4000 就能够看到web界面。
  • atxserver2-android-provider： 这一部分是接入安卓设施必须启动的我的项目，次要负责安卓设施和平台的交互工作，要想接入安卓设施必须启动此我的项目。
  • atxserver2-ios-provider： 这一部分是接入IOS设施必须启动的我的项目，次要负责IOS设施和平台的交互工作，同样的要想接入IOS设施必须启动此我的项目。（留神须要MAC电脑）

我的项目构造:

|-- static  动态目录|-- temlates  前端界面|-- web  网页代码      |-- urls.py 路由整合文件      |-- settings.py  配置文件      |-- database.py  数据库操作相干      |-- utils.py  罕用配置      |--views  每个界面的逻辑        |--slave.py  与atxslave通信用        |--devices.py  设施相干路由        |--base.py  基于ReguestHandler的基类

还有其余一些文件夹：

  • scripts文件夹： 次要放着一些用于调试开发的工具类等，比方想调试安卓我的项目能够独自运行fake_android_provider.py 与atxserver2-android-provider，并且其中的参数要改一些,个别不必太关注这个文件夹。
  • examples文件夹 : 寄存着一个自动化的Demo，采纳的自动化框架是uiautomator2，设施占用接口参考了openstf的API。

所有的接口采纳token认证，每个申请在 Header中减少 Authorization: Bearer xxxxx-token-xxxx，这个token值能够在集体的用户信息界面获取到，也存储在rethinkdb里；
接口都是通过web申请调用，能够用 “httpie” 这个工具或者间接用python的 request 办法调用。

具体的API文档拜访地址

2.4 环境搭建（这里介绍手动部署形式）

（1）装置运行rethinkdb数据库

  • rethinkdb下载安装地址
  • 最简略的形式，跟STF搭建办法一样，拉取docker镜像文件，先启动一个rethinkdb数据库，可返回下面查看步骤。

（2）克隆代码到本地

  • 先将代码clone到本地
git clone https://github.com/openatx/atxserver2.git
  • 装置依赖，到根目录执行
pip3 install -r requirements.txt

（3）启动

  • 启动atxserver服务，进入atx2所在目录并执行
python3 main.py
  • 设置监听端口
python3 main.py --port 4000  # 默认监听的就是这个地址

启动之后，局域网浏览器关上：http://宿主机IP地址:4000， 实现认证之后就能够顺利的看到设施列表页了。不过目前还是空的，什么都没有。

（4）Android设施接入

接下来，进行安卓设施接入。这时须要用到另外一个我的项目 atxserver2-android-provider 这个我的项目运行须要Python3.6+和NodeJS（官网强调node必须应用node8）；

  • 先将代码clone到本地，我是clone到了同局域网windows设施上，思考能够连贯挪动设施。
git clone https://github.com/openatx/atxserver2-android-provider.git
  • 装置依赖，到atxserver2-android-provider根目录执行
pip3 install -r requirements.txt
  • 查看挪动设施连贯
adb devices
  • 启动Provider服务连贯宿主机，进入到atxserver2-android-provider根目录执行
python main.py --server 宿主机IP地址:4000

Provider能够通过adb track-devices主动发现曾经接入的设施，当手机接入到电脑上时，会主动给手机装置minicap，minitouch，atx-agent，app-uiautomator-[test].apk，whatsinput-apk。

浏览器输出 宿主机IP地址:4000 拜访ATX server2设施管理系统，设施列表展现如下：

ATX server2设施管理系统设施管制界面:

3. 总结

STF次要采纳的是JAVA，我的项目较老，更新保护稍慢，作者位于国外，交换不便；次要语言js居多，框架比较完善定型了，另外，不反对苹果设施近程连贯；

ATXserver2次要应用python3，国内在作者，不便沟通交流；atxserver2更像是一个内核发动机，能够本人DIY一些想要的性能，并且反对苹果设施近程连贯；

基于对STF与ATXserver2的比拟，咱们最终抉择在ATXserver2的根底上二次开发，退出一些想要实现的性能。当然，除了在前人种的树下纳凉以外，咱们更要谋求一些新的冲破！期待有想法的敌人退出，一起翻新！