使用openstf对Android手机进行远程控制或者测试
STF(或Smartphone Test Farm)是一个Web应用程序,用于从您的浏览器中远程调试智能手机,智能手表。在本文我们介绍如何在Linux和Windows的wsl Linux子系统中安装openstf,本教程适合几乎适合基于debian系的Linux发行版,其中包括Ubuntu,Linux mint等
openstf让你使用浏览器就可以在多个设备上进行实时测试。下面我们看看是openstf可以做的事情。这些事情并不是一个浏览器扩展可以相比的,如果你不需要那些强大功能,也可以选择一个浏览器扩展即可
- 通过浏览器远程控制任何设备
- 实时屏幕视图
- 刷新速度可以达到30-40 FPS,具体取决于规格和Android版本。有关更多信息,请参见minicap。
- 旋转支持
- 支持使用自己的键盘输入文字
- 支持中继键
- 复制和粘贴支持(尽管在较旧的设备上可能有点挑剔,但您可能需要长按并手动选择粘贴)
- 不幸的是,有时可能不适用于非拉丁语言。
- 通过minitouch在触摸屏上提供多点触摸支持,
Alt
在拖动时按住可以在常规屏幕上支持两根手指捏/旋转/缩放手势 - 拖放安装和启动
.apk
文件 - 如果清单中指定了启动主启动器活动
- 通过minirev反向端口转发
- 即使设备不在同一网络上,也可以直接从设备访问本地服务器
- 在任何浏览器中打开远程控制webapp
- 实时检测已安装的浏览器
- 如果用户选择默认浏览器,则会自动检测到
- 执行shell命令并查看实时输出
- 显示和过滤设备日志
- 使用
adb connect
连接的设备,就像它在插入到计算机的远程设备一样。在ADB模式下,无论你是连接到同一个网络,都可远程控制 - 在本地运行任何
adb
命令,包括shell访问 - Android Studio和其他IDE支持,在浏览器上观看设备屏幕的同时调试您的应用程序
- 支持Chrome远程调试工具
- 文件资源管理器可以访问设备文件系统
- VNC实验支持(正在进行中)
- 监控您的设备清单
- 查看哪些设备已连接,离线/不可用(表明USB连接弱),未授权或已拔出
- 查看谁在使用设备
- 通过电话号码,IMEI,ICCID,Android版本,运营商,产品名称,组名称和/或许多其他属性来搜索设备,并具有简单但功能强大的查询
- 在需要物理定位的设备上显示带有标识信息的亮红色屏幕
- 跟踪电池电量和健康状况
- 基本的Play商店帐户管理
- 列出,删除和添加新帐户(添加可能无法在所有设备上进行)
- 显示硬件规格
- 使用预订和分区系统
- 分区系统使您
[administrator level]
可以无限期地将不同的设备集分配给不同的项目或组织(即,由用户集代表) - 预订系统使您可以在有限的时间内(例如,在5天内的凌晨3:00至凌晨4:00)为一组用户保留一组设备。
- 预订和分区系统的共同点是组的概念,即设备,用户和时间规范的关联
- 向GroupFeature.pdf报告以获取有关如何使用此功能的详细文档
- 监控您的小组库存
- 查看哪些组处于活动,就绪或待处理状态,以及其他组属性:名称,标识符,所有者,设备,用户,类别,持续时间,重复,开始日期,到期日期
- 按属性值搜索组
- 通过电子邮件联系所选组的所有者
- 管理您的群组
- 通过指定组的名称,设备,用户和时间表来创建组
- 准备好系统安排的小组
- 按属性值搜索组
- 删除您的组或您选择的组
- 通过电子邮件联系所选组的所有者
[administrator level]
- 管理设备
[administrator level]
- 通过设备的属性值搜索设备
- 删除一个或一组符合一组过滤器的设备:存在,已预订,带注释,受控
- 管理用户
[administrator level]
- 通过提供用户名和电子邮件来创建用户
- 通过用户的属性值搜索用户
- 删除满足一组过滤器的用户或部分用户:组所有者
- 通过电子邮件联系用户或部分用户
- 设置适用于所有用户的默认组配额
- 设置适用于特定用户的组配额
- 简单的REST API
在本文我们介绍如何在Linux和Windows的wsl Linux子系统中安装openstf,本教程适合几乎适合基于debian系的Linux发行版,其中包括Ubuntu,Linux mint等
安装OpenSTF依赖的软件
sudo apt install python build-essential graphicsmagick pkg-config yasm libczmq-dev libprotobuf-dev -y
安装adb
对于使用Windows wsl Linux子系统用户还需要安装Windows的adb,当你在wsl Linux 子系统终端执行命令adb deviecs
可能找不到设备。Linux用户可以忽略Windows adb的安装
mkdir -p /mnt/d/sdk/windows/android #for windows
mkdir -p /mnt/d/sdk/linux/android #for linux
wget https://dl.google.com/android/repository/platform-tools_r31.0.0-linux.zip
wget https://dl.google.com/android/repository/platform-tools_r31.0.0-windows.zip #for windows
unzip platform-tools_r31.0.0-windows.zip -d /mnt/d/sdk/windows/android #for windows
unzip platform-tools_r31.0.0-linux.zip -d /mnt/d/sdk/linux/android #for Linux
将adb加入环境变量或者PATH
如果你在Windows wls安装adb还需要设置Windows的环境变量,这样你可以在cmd的任意位置即可使用adb
命令
Windows
开始菜单->设置->系统->关于,然后找到右侧栏中的高级设置如下图所示。
点击环境变量,将展示如何下图
选择Path,然后点击编辑,将会弹出一个新的对话框。
点击新建,在弹出的对话框中输入adb所在的路径,在我们的示例中是D:\sdk\windows\android\platform-tools
。
现在我们已经在Windows完成adb配置。接下来我们还需要在wsl Linux子系统使用adb ,因此还要为Linux配置,将adb添加Linux子系统的PATH中
zsh用户
echo "export PATH=$PATH/mnt/d/sdk/linux/android" >> ~/.zshrc
source ~/.zshrc
bash用户
echo "export PATH=$PATH/mnt/d/sdk/linux/android" >> ~/.bashrc
source ~/.bashrc
验证adb安装
在Linux的发行版中或者Windows wsl Linux子系统中
adb version
在Windows的cmd
adb version
你应该可以看到下面的输出
Android Debug Bridge version 1.0.26
对于Windows wsl Linux的用户必须保证cmd终端adb版本与Linux子系统adb版本一致,否则wsl Linux的adb不能正常工作
现在我们已经在Windows和Linux中adb的配置,接下来安装rethinkdb
安装RethinkDB
RethinkDB是最初由同名公司创建,开放源代码,面向文档的分布式分布式数据库。数据库存储JSON文件动态模式,并旨在促进推实时更新查询结果的应用。该公司最初是在2009年6月由Y Combinator资助的,但在2016年10月宣布它无法建立可持续的业务,并且如果没有商业支持,其产品将来将完全开源。
执行下面的命令安装RethinkDB
source /etc/lsb-release && echo "deb https://download.rethinkdb.com/repository/ubuntu-$DISTRIB_CODENAME $DISTRIB_CODENAME main" | sudo tee /etc/apt/sources.list.d/rethinkdb.list
wget -qO- https://download.rethinkdb.com/repository/raw/pubkey.gpg | sudo apt-key add -
sudo apt-get update
sudo apt-get install rethinkdb
验证RethinkDB的安装
rethinkdb -v
输出如何下所示
rethinkdb 2.4.1~0focal (CLANG 10.0.0 )
配置RethinkDB
如果你马上执行命令sudo service rethinkdb start
启动rethinkdb,你可能会看一个如下的提示,说在/etc/rethinkdb/instances.d/
目录中找不到rethinkdb实例存在
rethinkdb: No instances defined in /etc/rethinkdb/instances.d/
rethinkdb: See http://www.rethinkdb.com/docs/guides/startup/ for more information
接下来我们需要在/etc/rethinkdb/instances.d/
定义一个rethinkdb实例。执行以下命令复制一个文件到/etc/rethinkdb/instances.d/
启动RethinkDB
现在我们已经对RethinkDB的配置,我们可以执行以下命令启动RethinkDB
sudo service rethinkdb start
你将会看到以下输出
rethinkdb: instance1: will only listen on local network interfaces.
rethinkdb: instance1: To expose rethinkdb on the network, add the 'bind=all' option to /etc/rethinkdb/instances.d/instance1.conf
rethinkdb: instance1: Starting instance. (logging to `/var/lib/rethinkdb/instance1/data/log_file')
Recursively removing directory /var/lib/rethinkdb/instance1/data/tmp
安装Node.js
由于openstf已经好久没有维护,它依赖Node.js依然停留在Node.js 8.x版本。因此我们需要一个工具为我们提供快速切换Node.js版本的能力。在众多的Node.js版本管理工具中。nvm可以说是独树一帜,因此我们首先安装nvm(Node.js版本管理工具)。如果你不是Node.js开发者。我们也为提供一直最快捷的安装Node.js的方式,那就是从Nodesource安装Node.js
从nodesource安装Node.js
# Using Ubuntu
curl -fsSL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs
# Using Debian, as root
curl -fsSL https://deb.nodesource.com/setup_8.x | bash -
apt-get install -y nodejs
使用nvm安装Node.js
如果你未安装Node.js版本管理工具,可以参照此文章安装nvm
nvm install 8.4
nvm alias default 8.4
安装并启动openstf
安装openstf
如果朝里的局域网里建议将npm registry换成国内的
npm i -g mirror-config-china --registry=https://registry.npm.taobao.org #对于china朝里的局域网,建议换成淘宝镜像
npm install -g stf
使用adb connect或者usb连接手机与计算机
首先在你的手机中打开开发者选项,如果你还不知道怎么打开开发者选项,只需要在手机的设置里的构建版本号点击7次,即可开启开发者选项。至此,我们要回到计算机启动adb调试服务器,执行以下命令启动adb调试服务器
adb start-server
然后在手机开启usb调试。如果你手机刷入某些第三方ROM,还可以开启基于网络adb调试。如果正常连接,手机将提示你是否信任在此计算机调试,请点击允许。之后可以使用以下命令验证是否正常连接
adb devices
在上面命令输出中你将会看自己设备的型号名称
List of devices attached
xxxx xxxxx
启动openstf
stf local
上面的命令启动需要一点时间,等待完整启动完成后。使用你喜欢的浏览器打开http://localhost:7100
,然后输入用户名:administrator
密码:administrator@fakedomain.com
结论
至此,你已经了解如何使用openstf远程的控制自己的手机。并且了解安装openstf的注意事项。也了解adb在Windows,Linux,wsl中配置于安装。如果您遇到问题或有反馈,请在下面发表评论。