什么是Sonic

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

前后端一键部署

安装docker

Docker Desktop官网下载。不过比较慢，也可以网盘下载（提取码：7788）。
安装完成后，docker version 查看版本信息，看是否安装成功。

下载并修改 docker-compose.yml 配置

1. 点击这里 下载最新版本的docker-compose.yml文件到任意目录（如链接失效，请自行前往 这里 下载）。下载完成，我放到了 E:\sonic 文件夹中，大家放到任意目录中均可。
2. 修改配置：

拉取镜像

打开 PowerShell 执行命令，等待镜像拉取完成（途中需要执行两次该命令）：

docker-compose up -d

前后端部署成功后，可以看到docker容器中已经有了三个服务，此时可以直接打开浏览器访问 http://localhost:3000

Agent部署

安装 npm

在NodeJS官网自行选择版本安装，安装时会自动添加环境变量，完成后查看npm的版本；

安装 jdk17

1. 目前官网推荐下载jdk17
2. 安装到合适的目录，如D:\java\jdk-17；
3. 进行环境变量配置：
   • 系统变量 添加 JAVA_HOME 填入jdk所在路径；
   • Path 中添加 %JAVA_HOME%\bin ，%JAVA_HOME%\jre\bin。
     
     
4. 打开cmd查看jdk版本
   

安装 Android SDK

下载Android SDK。

1. 将SDK安装目录添加为 ANDROID_HOME 环境变量 ：
   

2. 把 platform-tools、tools 目录路径添加到 系统变量Path 中。
   
   

3. adb --version 查看版本信息
   

下载 chromedriver.exe

1. 谷歌浏览器地址栏输入chrome://version，查看版本和安装目录。
   
2. 下载与Agent本机谷歌浏览器版本对应的 chromedriver.exe
3. 找到对应版本进行下载，解压到文件目录C:\Program Files (x86)\Google\Chrome\Application下面。
   

全局安装 appium 和 adbkit

# 全局安装 appium 和 adbkit
npm i -g appium adbkit

查看版本：

下载 Sonic-agent

选择 PC对应的平台zip 下载并解压到任意目录（标记为 工作目录）

生成 AgentKey

在Sonic平台的设备中心–Agent中心新增一个Agent,会生成一个AgentKey：

配置 application-prod.yml

进入Agent文件夹， 找到config，根据提示修改application-prod.yml文件：

1. agent host
2. agent key
3. server host
4. chrome-driver-path
   

启动 Sonic-agent

进入 Sonic-agent 目录，打开cmd，先输入 chcp 65001 并回车，再执行java命令并启动：

cd E:\sonic\agent-windows
java -Dfile.encoding=utf-8 -jar sonic-agent-windows-x86_64.jar

启动成功：

测试接口(可跳过)

我们可以使用 tcping 工具，测试本地接口是否通畅



说明Agent端链接是通畅的。

链接设备

• adb 检查设备是否链接

# 查看设备连接
adb devices

可以看到这台设备已经加上了：

• 也可以在Agent端 查看设备连接日志
  
• 使用设备
  

参考资料

• 官网部署文档 https://sonic-cloud.gitee.io/#/Deploy
• 《Sonic开源的云真机测试平台搭建记录》 https://blog.csdn.net/ljh824144294/article/details/122308444
• 《Sonic测试平台搭建–设备接入》 https://blog.csdn.net/ljh824144294/article/details/122311091