官网：https://sonic-cloud.gitee.io/#/Home

github: https://github.com/SonicCloudOrg

一、安装Docker

1、安装wsl

双击wsl_update_x64.msi 默认安装

2、安装docker

https://www.docker.com/products/docker-desktop

下载Docker Desktop Installer 双击安装

左下角的docker已经是running状态，安装成功

安装docker-compose

Docker Desktop for Windows 自带 docker-compose

测试, win+r 输入 cmd

1	docker-compose --version

二、安装Mysql

1、下载安装包，以及安装mysql开发或服务器版本

2、新建数据库sonic，用户名root  密码123456

选择字符集utf-8，排序规则为utf8_general_ci

3连接数据库

4、添加root用户远程权限

use mysql;

select host,user FROM user;

update user set host='%' where user='root';

flush privileges;

select host,user,password from user;

三、部署服务端

1、docker-compose.yml文件配置

下载docker-compose.yml文件，创建sonic目录，

下载最新的docker-compose.yml文件到 工作目录 sonic

下载config文件夹到 工作目录 sonic

在工作目录sonic 新建logs、keepFiles、imageFiles、recordFiles、packageFiles五个文件夹

│  docker-compose.yml

│

├─config

│      actuator-prod.yml

│      common-prod.yml

│      feign-prod.yml

│      jdbc-prod.yml

│      knife4j-prod.yml

│      logging-prod.yml

│      sonic-server-bus-prod.yml

│      sonic-server-controller-prod.yml

│      sonic-server-folder-prod.yml

│      sonic-server-gateway-prod.yml

│      sonic-server-task-prod.yml

│      sonic-server-transport-prod.yml

│

├─imageFiles

├─keepFiles

├─logs

├─packageFiles

└─recordFiles

2、在docker-compose.yml中修改数据库及服务器的ip地址以及账号密码

version: '3'

services:

sonic-server-simple:

image: "sonicorg/sonic-server-simple:v1.3.2-release"

environment:

#以下为MySql配置，localhost请替换为自己MySql服务的ipv4地址

- MYSQL_HOST=192.168.7.33

- MYSQL_PORT=3306

- MYSQL_DATABASE=sonic

- MYSQL_USERNAME=root

- MYSQL_PASSWORD=123456

#在服务器部署的话，localhost改为服务器ip，port更改为sonic-server-simple暴露的port（一般不变）

- SONIC_API_HOST=192.168.7.33

- SONIC_API_PORT=8094

- SONIC_NETTY_PORT=8095

#token加密的key值

- SECRET_KEY=sonic

#身份验证token有效天数

- EXPIRE_DAY=14

#前端页面访问地址，不填默认为http://localhost:3000

- CLIENT_HOST=http://localhost:3000

#文件保留天数（指测试过程产生的文件，包括图片、录像等等）

- FILE_KEEP_DAY=60

#测试结果保留天数

- RESULT_KEEP_DAY=60

#以下均为Cron表达式

#清理文件定时任务

- FILE_CRON=0 0 12   ?

#清理测试结果定时任务

- RESULT_CRON=0 0 12   ?

#发送日报定时任务

- DAY_CRON=0 0 10   ?

#发送周报定时任务

- WEEK_CRON=0 0 10 ? * Mon

networks:

- sonic-network

volumes:

- files:/keepFiles/

- files:/imageFiles/

- files:/recordFiles/

- files:/packageFiles/

- files:/logs/

ports:

- "8094:8094"

- "8095:8095"

sonic-client-web:

image: "sonicorg/sonic-client-web:v1.3.2-release"

environment:

#192.168.1.1改为你的ipv4，port更改为sonic-server-simple暴露的port（一般不变）

- SONIC_API_HOST=192.168.7.33

- SONIC_API_PORT=8094

networks:

- sonic-network

ports:

- "3000:80"

volumes:

files:

networks:

sonic-network:

driver: bridge

2、启动服务端

执行以下指令（确保logs、keepFiles、imageFiles、recordFiles、packageFiles、config、docker-compose.yml在同一目录！如果提示无镜像，可以先使用docker-compose pull）

docker-compose up -d

3、访问云真机平台

启动后可以打开浏览器访问 http://192.168.7.33:3000

注册账号，登录，查看以及配置服务端

点击右上角设备中心-》Agent中心

新增Agent，复制AgentKey

AgentKey在部署客户端部署客户端时，在application-prod.yml文件中，需要用到。

四、部署客户端

该方式将部署Agent端、Appium等等环境。

1、安装node，npm，

2、jdk16，

注意版本号，jdk必须16版本及以上。

将jdk路径设置到系统环境变量，命名为JAVA_HOME

3、安装SDK，

将安卓SDK设置到系统环境变量，命名为ANDROID_HOME。打开SDKManager，下载 built-tools 和 platform-tools。确保platform-tools目录存在，adb指令可用

4、谷歌浏览器，chromedriver.exe

下载与Agent本机谷歌浏览器 版本对应 的chromedriver.exe，并放到跟谷歌浏览器安装同目录下（可以谷歌浏览器地址栏输入chrome://version，就看到安装目录了。大部分在这个目录C:\Program Files\Google\Chrome\Application，有时候在Program Files(x86)里面）

5、安装appium

npm i -g appium

6、application-prod.yml文件配置

从部署好的前端界面【设备中心】的【Agent中心】新增Agent，记录Agent的Key

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

sonic-agent-v1.3.2-release-windows_x86_64.zip

赋予工作目录所有权限，然后确保解压后的mini、webview、config、plugins文件夹与jar同级

$ sudo chmod -R 777 xxxxx

然后可以列出文件夹检查一下

$ cd xxxxx    

$ tree

│  sonic-agent-xxxx.jar

│

├─config

│      application-prod.yml

├─plugins

├─mini

├─webview

2、修改config文件夹中 application-prod.yml 的配置信息，保存

sonic:

agent:

# 替换为部署Agent机器的ipv4

host: 192.168.7.33

# 替换为Agent服务的端口，可以自行更改

port: 7777

# 替换为前端新增Agent生成的key

key: 62108da4-1252-4b42-8eb5-51275546d634

server:

# 这个host改成后端的host

host: 192.168.7.33

# 这个port改成后端文件中心的port（一般不变）

folder-port: 8094

# 这个port改成后端传输中心的port（一般不变）

transport-port: 8095

modules:

# 安卓模块配置

android:

enable: true

# 是否开启远程adb调试功能

use-adbkit: true

# iOS模块配置

ios:

# 如果不需要连接iOS设备，请将true改为false。开启的windows用户请确保本机已安装iTunes

enable: false

# 替换为你自己使用的wda的bundleId，如果没有.xctrunner后缀会自动补全，建议使用公司的开发者证书

wda-bundle-id: com.facebook.WebDriverAgentRunner.xctrunner

appium:

enable: true

# 默认为0会自动寻找随机端口启动，如果需要指定appium server端口，请在这里设置

port: 0

# 在线webView调试模块配置

webview:

enable: true

# 谷歌调试端口，一般不需要修改（默认0使用随机端口，如果需要开启防火墙给外部使用，请设置固定端口如7778）

chrome-driver-debug-port: 0

# Agent机器上的chrome浏览器的driver路径，可以去http://npm.taobao.org/mirrors/chromedriver/下载

chrome-driver-path: C:\Program Files\Google\Chrome\Application\chromedriver.exe

7、启动客户端

快速启动

java -jar sonic-agent-xxxx.jar

部署完毕！自行插入设备即可.

五、成功部署效果展示

查看手机连接及远程操作手机设备，手机开启调试权限。

http://192.168.7.33:3000/ 注册，登录

进入设备中心，选择插入连接的手机，手机会提示你安装sonic，点击同意

进入马上使用

点击马上使用：点击元素控件

点击UI自动化，录入case，点击开始运行，查看运行日志。

❀❀❀完结撒花❀❀❀