myfreax

使用openstf对Android手机进行远程控制或者测试

STF(或Smartphone Test Farm)是一个Web应用程序,用于从您的浏览器中远程调试智能手机,智能手表。在本文我们介绍如何在Linux和Windows的wsl Linux子系统中安装openstf,本教程适合几乎适合基于debian系的Linux发行版,其中包括Ubuntu,Linux mint等

11 min read
By myfreax
使用openstf对Android手机进行远程控制或者测试

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/

sudo cp /etc/rethinkdb/default.conf.sample /etc/rethinkdb/instances.d/instance1.conf
这个是示例配置请不要用于生产环境

启动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中配置于安装。如果您遇到问题或有反馈,请在下面发表评论。