【Appium IOS】更新Appium中的WebDriverAgent

WDA: WebDriverAgent的简称，是Facebook为苹果开发的一个自动化测试框架

1、从github中克隆WebDriverAgent项目（cd到自定义的文件夹下下载）

git clone https://github.com/facebook/WebDriverAgent

2、运行初始化脚本

# 进入到WDA 根目录

        cd WebDriverAgent/

# 运行初始化脚本

        ./Scripts/bootstrap.sh

            ⚠️若执行./Scripts/bootstrap.sh时报错：如下图所示：

ImportDeclaration should appear when the mode is ES6 and in the module context.

AssertionError [ERR_ASSERTION]: ImportDeclaration should appear when the mode is ES6 and in the module context.

                        ------解决：升级eslint ： $ npm install -save eslint, 安装后还是报错--后续再解决。

                   

3、证书配置

免费、付费账号均可，修改bundleID，与其他人不同即可，随意设置。

1）Xcode打开WebDriverAgent目录下的WebDriverAgent.xcodeproj文件。按照下图进行操作：

⚠️ 1: 但是会提示问题，如上图所示：

问题：The app ID "com.facebook.WebDriverAgentRunner" cannot be registered to your development team. Change your bundle identifier to a unique string to try again.

解决：请进入WebDriverAgentRunner -> Build Settings设置中，找到Packaging中的选项，将其内容修改为唯一识别的字符串就不报错了，如下图所示：

4、运行与测试

1）iphone手机连接Mac，并添加信任

设置=》通用=》设备管理=》开发者应用=》验证应用

2）选择如下图后运行( 直接command+U运行，这是test模式，不能run，即一定要执行project>Test 才可以校验第三步)， 运行后会提示输入mac电脑的密码，提示编译成功，并且在IOS真机上看到了WDA的身影。

选择

编译成功

3）WDA安装校验（前提是project>Test 运行的，如下图所示）

           编译成功的同时，控制台会显示输出IP地址和端口，如下图所示（打开控制台方法：选择view->Debug Area->Activate console打开底部控制台。）：关键是最后一句话（ServerURLHere->http://192.168.11.236:8100<-ServerURLHere）

        3.1）复制url到输入在浏览器中，就会发现网页上显示出你的手机界面，然后，你就可以为所欲为啦。

不过有些iPhone，据说是国产的原因，直接使用ip不能连接手机（即输入打印出来的url无法显示手机界面），需要进行端口转发（终端执行 “iproxy 8300 8100” 回车后在浏览器中输入http://localhost:8300/出现json字符串即表示成功，同时说明WDA安装成功了）。

http://localhost:8300

        3.2）地址后面添加/status可以查看当前设备（你使用的哪个设备运行，就是哪个设备的状态）的状态。---http://localhost:8300/status，获取与wda通信session id

http://localhost:8300/status

        3.3）地址后添加/inspector即可打开WDA 的inspector （非Appium inspector），查看元素：-----http://localhost:8300/inspector ，点击下图中“home”后手机屏幕会切回到主屏幕。-------至此安装WDA以及连接IOS手机成功！！

http://localhost:8300/inspector

5、进阶：如何用命令启动webDriverAgent，即终端替代xcdode

------小结：1⃣️start_webDriverAgent.sh   2⃣️proxy 8300 8100

5.1）进入webDriverAgent目录，创建start2019.sh文件：

        $ touch start2019.sh    # 创建文件

5.2）vi （$ vi start2019.sh）输入以下内容:---这样就将启动webDriverAgent的命令保存在了start.sh文件中了!!

# 解锁keychain，以便可以正常的签名应用

PASSWORD="123"

security unlock-keychain -p $PASSWORD ~/Library/Keychains/login.keychain

# 获取设备的UDID

UDID=$(idevice_id -l | head -n1)

# 运行测试

xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination "id=$UDID" test

# [可选] 部分国产苹果手手机无法访问url，需要端口转发 ----貌似不执行，还是需要手动转发！！

iproxy 8300 8100

图中8100已改为8300

5.3）执行start2019.sh文件

$ chmod 777 start2019.sh   # 修改文件start.sh 的权限,使用命令：

$ ./start2019.sh       # 执行start.sh文件

5.4）验证WDA是否启动成功

        情况一：非国产手机，直接复制上面的url到浏览器中即可访问。

        情况二：国产手机或者复制url无法打开页面的情况时：

                        $ proxy 8300 8100   #开启iproxy 进行端口转发

                        浏览器中输入：http://localhost:8300 ，出现遗传json字符串即可。

---

// 更方便些的话，直接在终端打开时的默认路径下新建这个执行文件，然后文件中切换路径到WebDriverAgent下即可，如下图所示。

第一行新增：# 切换到webDriverAgent目录下  cd xcode_workspace/WebDriverAgent

6、替换Appium中的WebDriverAgent 

1）进入到Appium中的WebDriverAgent目录，目录路径如下：

            1.15.1版本：/usr/local/lib/node_modules/appium/node_modules/appium-webdriveragent

            旧版本本：/Applications/Appium.app/Contents/Resources/app/node_modules/appium/node_modules/appium-xcuitest-driver/

2）用刚刚运行成功的WebDriverAgent里的内容替换到appium-webdriveragent下。替换完成后要进入appium-webdriveragent目录，执行：

            $ mkdir -p Resources/WebDriverAgent.bundle

            $ sh ./Scripts/bootstrap.sh

            ⚠️遇到问题：ERROR in ./js/app.js Module parse failed: /usr/local/lib/node_modules/appium/node_modules/[email protected]@appium-webdriveragent/Inspector/js/app.js Unexpected token (67:6)。

                -- --解决：点击查看解决方案

3）打开Appium客户端，开启服务后点击启动检查器（inspector）会话，在 Desired Capabilities 中输入相关的参数后点击Start Session，运行成功后，会弹出一个控制界面，在该界面中可以控制手机上正在运行的程序，点击界面上方中心的录制按钮，可以将你对手机端的操作代码化

4）编写python测试用例