安卓设备接入

1、安装 npm

登录 NodeJS 官网：https://nodejs.org/en/
下载左侧的稳定版本：Recommended For Most Users
双击安装包，一路 next 完成安装，其中环境变量已自动配置
cmd窗口验证：node --version

2、安装 jdk16

登录 jdk 官网：http://jdk.java.net/archive/
点击 " 16 GA (build 16+36) "下的 > “Windows 64-bit zip(sha256) 187M” 的zip，完成下载
解压到合适目录，例如：C:\Program Files\jdk-16.0.1
在 ”环境变量“ > “系统变量” 中，点击新建，输入以下：

变量名：JAVA_HOME
变量值：C:\Program Files\jdk-16.0.1

在 “系统变量” path 中添加以下内容：

%JAVA_HOME%\bin
%JAVA_HOME%\jre\bin

cmd窗口中验证安装: java --version

3、安装 sdk

找开发获取到安卓 sdk 包，并解压到相关目录，如：E:\android-sdk_r24.4.1-windows
在 ”环境变量“ > “系统变量” 中，点击新建，输入以下：

变量名：ANDROID_HOME
变量值：E:\android-sdk_r24.4.1-windows

在 “系统变量” path 中添加以下内容：

%ANDROID_HOME%\tools
%ANDROID_HOME%\platform-tools

cmd窗口验证：adb --version

4、安装 chromedriver.exe

谷歌浏览器中输入：chrome://version，看到以下内容：

浏览器版本为：98.0.4758.102
安装路径：C:\Program Files\Google\Chrome\Application

打开谷歌浏览器驱动网站：https://registry.npmmirror.com/binary.html?path=chromedriver/
点选对应版本驱动，下载里面的 *_win32.zip，并将解压后的驱动文件放入上面的安装路径。

5、安装 appium

配置淘宝镜像：npm config set registry https://registry.npm.taobao.org
清理缓存：npm cache clear --force
安装appium：npm i -g appium
安装adbkit：npm i -g adbkit
cmd窗口验证：appium --version

6、配置 agent

打开agent网站：https://github.com/SonicCloudOrg/sonic-agent/releases
下载 agent-sources.zip、sonic-agent-windows-x86_64.jar

下载慢，如下配置：

1、打开：https://www.ipaddress.com/
2、查询 github.com 的 ip 为 xxx
3、查询 github.global.ssl.fastly.net 的 ip 为 xxx
4、打开 C:\Windows\System32\drivers\etc 下的 hosts 文件，最后两行添加以下内容：

xxx.xx.xx.xx github.com
xxx.xx.xx.xx github.global.ssl.fastly.net

5、cmd 窗口执行：ipconfig /flushdns

新建目录：agent-souces，把 agent-sources.zip 拖进去，解压到当前目录，删掉zip文件
把 sonic-agent-windows-x86_64.jar 拖进 agent-souces 中。

别拖到agent-souces里面目录去了

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

例如：AgentKey : 33daf188-967b-4cc4-bf03-c62e96aac283

打开 agent-souces/config/application-prod.yml，如下配置：

sonic:
  agent:
    # 【你部署 agent 的ip地址，也就是你办公电脑的ip】
    host: xx.xx.xx.xx
    port: 7777
    # 4 步骤中的 AgentKey
    key: xxxxxxxxxxxxx
  server:
    # 【你部署sonic server 的 ip 地址】
    host: xx.xx.xx.xx
    folder-port: 8094
    transport-port: 8095

modules:
  android:
    enable: true
    use-adbkit: true
  ios:
    # 安卓接入，这里不考虑ios,所以设置了false
    enable: false
    wda-bundle-id: com.facebook.WebDriverAgentRunner.xctrunner
  appium:
    enable: true
  webview:
    enable: true
    chrome-driver-debug-port: 0
    chrome-driver-path: C:\Program Files\Google\Chrome\Application\chromedriver.exe

logging:
  file:
    name: logs/sonic-agent.log
  logback:
    rollingpolicy:
      clean-history-on-start: true
      max-history: 3
  pattern:
    console: "%clr(%d{${LOG_DATEFORMAT_PATTERN:yyyy-MM-dd HH:mm:ss.SSS}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:%wEx}"