Sonic:一站式开源分布式集群云真机测试平台,致力服务于中小企业的客户端 UI 测试,永久免费。

以下是本人实际搭建过程总结,希望对计划或正在搭建的同学有帮助!

Docker 方式部署 sonic 前后端(体验版)环境信息:

Docker 所属操作系统:Centos 7.5

数据库:Mysql5.7.34

Agent 部署环境:Windows 7 64bit 旗舰版、JDK16、Appium1.9.10、Nodejs
V13.14、Appium1.19.1

一、安装 Mysql 数据库

1、安装 mysql 数据库,具体安装参见:https://www.cnblogs.com/sshoub/p/4321640.html

2、创建数据库 sonic(具体也可自定义,确保后续配置文件中数据库保持一致即可)

【注意】:字符集为 utf8,排序规则为 utf8_general_ci

二、Centos 系统下安装 Docker

Docker 具体安装参考:https://blog.csdn.net/m0_37679452/article/details/105188372

三、基于 Docker 方式一键部署前后端

该方式将一次性部署 Sonic 服务端(单机版),Sonic 前端,可根据 docker-compose.yml 文件内容自定义参数。

(a)下载docker-compose.yml文件

下载地址:https://github.com/SonicCloudOrg/sonic-server-simple/releases

修改文件中的数据库连接地址信息

(b)上传docker-compose.yml文件至 Centos 服务器

(c)运行 docker-compose up -d

安装完成后,可以访问http://ip:3000即可访问管理页面,根据提示注册用户即可登录。

使用 docker ps 可以查看当前运行的容器:docker ps

如要查看 simple 服务实时日志,可以使用:docker logs -f 7486ec666762

4、Windows 下基于 jar 包方式部署 Agent

部署 agent 前环境准备工作

(a)安装 npm

(b)安装 Nodejs

建议从官网下载 Nodejs,推荐 LTS 版本,比较稳定:https://nodejs.org/en/download/releases/

下载安装包后按照提示安装即可。

【注意】windows 7 支持的 Nodejs 版本是 V13.14,其它新版本不兼容。

(c)安装 jdk16(注意是 JDK16 不是 1.6,请睁大眼睛哦),并将 JDK 路径设置到系统环境变量,命名为 JAVA_HOME

(d)安装安卓 SDK:将安卓 SDK 设置到系统环境变量,命名为 ANDROID_HOME。确保 platform-tools 目录存在,adb 指令可用。


(e)安装 appium:npm install -g appium@1.19.1 --chromedriver-skip-install

安装完成后查看版本:appium -v

(f)tidevice 安装,详见https://blog.csdn.net/aovenus/article/details/122181915

(g)安装谷歌浏览器:

(h)下载并安装 chromedriver.exe:

查看谷歌浏览器版本:点右侧三个竖点—>帮助—>关于 Google
Chrome,可以看到谷歌浏览器版本。

下载该浏览器版本 93.0.4577.63 对应的 chromedriver.exe,下载地址:http://npm.taobao.org/mirrors/chromedriver/

下载后放到谷歌浏览器所在目录下:


基础环境配置完成后,下面开始部署 agent:

(1)通过http://ip:3000sonic 管理页面,访问在【设备中心】的【Agent 中心】新增 Agent,记录 Agent 的 Key



(2)下载 agent-sources.zip符合自己系统的 jar 包
到任意目录(如本示例为 sonic)

下载地址:https://github.com/SonicCloudOrg/sonic-agent/releases

解压 agent-sources.zip 内的文件到 sonic 目录
下(即解压后的 mini、language、chromeDriver、config、plugins 文件夹与 jar 同级)。

修改 config 文件夹中 application-prod.yml 的配置信息,并保存。

【注意】:重点正确填写红色标注的内容!!!务必正确!!

之后切换到 jar 包所在目录运行:java -jar sonic-agent-windows-x86_64.jar


如正常显示如上信息,则表示部署成功!!恭喜恭喜,下面就开心体验吧!

之后自行接入安卓设备即可(设备请竖直放置或平摊放置,左右旋转放置有可能影响坐标定位),记得开启 USB 设备调试。

adb 查看接入设备:

(3)访问 sonic 管理页面:http://ip:3000,输入登录用户名和密码登录。

可以看到已接入的设备,并显示状态为空闲中,点 “马上使用”,手机上将提示安装 sonic、appium 插件应用。

之后根据提示安装 uiaotomator2

安装完成后,管理界面中将正常显示手机界面,并可以远程操作了!开始你的自由之旅吧!

附:安装部署常见问题

【问题 1】JDK 版本不对,启动 agent 时报如下错误。

【解决方法】需要 JDK16 以上,不是 JDK1.6,同学,睁大眼睛看清楚哦!

JDK 下载地址:https://jdk.java.net/archive/

安装完成后查看 JDK 版本。

【问题 2】使用 java -jar sonic-agent-windows-x86_64.jar 启动 agent 时,
Appium 环境检查报错。

【解决方法】使用 npm i -g appium 安装

【问题 3】使用 java -jar sonic-agent-windows-x86_64.jar 启动 agent 时,adbkit
环境不通过 ×

【解决方法】使用 npm i -g adb kit 安装或下载 adb
kit(https://adbshell.com/downloads)并添加到系统环境变量 PATH。

【问题 4】使用 java -jar
sonic-agent-windows-x86_64.jar 启动 agent 时,chromedriver 环境检查不通过 ×

【解决方法】没有修改 agent-sources/config/application-prod 文件中 chromedriver 路径,修改为当前实际路径即可。

【问题 5】使用 java -jar
sonic-agent-windows-x86_64.jar 启动 agent 时,运行后报以下错误:

需要卸载本机已安装 Appium,使用 npm i -g
appium 重新安装。

安装完成后查看版本:

再次启动 agent 后,应该可以看到端口 7777 监听,说明正常启动成功。

更多常见问题请参考该专栏其他同学总结!


↙↙↙阅读原文可查看相关链接,并与作者交流