Appium 在 MAC 上搭建 appium1.6.3 过程

自己研究好久ios10的真机测试今天算是成功了。新手发帖，仅供参考。原文地址https://github.com/appium/appium-xcuitest-driver

• 1，有一个MAC机器，或者虚拟机，能够联网，要求Xcode8+ MAC系统10.11+（我用的是Xcode8.2 ， MAC系统10.12）有一个Apple ID账号
• 2，安装brew

usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

• 3，安装libimobiledevice

brew install libimobiledevice --HEAD 

• 4，安装carthage

brew install carthage

• 5，安装node（目的是安装npm）按照官方的地址https://nodejs.org/en/download/。 下载.pkg文件安装
• 6，安装cnpm(由于某种原因,直接用npm下载安装会有好多网络问题，安装淘宝的cnpm要比npm好用) https://npm.taobao.org/

npm install -g cnpm --registry=https://registry.npm.taobao.org

• 7，安装ios-deploy

cnpm install -g ios-deploy

• 8，安装xcpretty

gem install xcpretty

• 10,安装appium1.6.3(到发帖为止，最新版本是1.6.3，要其他版本的跟上版本号就行了）这一步骤若出现安装jDK弹出框忽略就好

cnpm install -g appium@1.6.3

1-10 以上安装不要在root用户下安装。若出现权限问题，进入root用户将文件权限更改下。然后退出root用户继续安装即可

chmod -R 777 pathForFile

       关于如何进入root用户，我就不多说了，自己百度。
       以上都很简单，下面重点来了。

• 11，安装appium-xcuitest-driver依赖        进入WebDriverAgent安装目录。运行bootstrap

cd  /usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent （如果WebDriverAgent 所在路径和此不同，请自行查找）
mkdir -p Resources/WebDriverAgent.bundle
sh ./Scripts/bootstrap.sh -d

       在运行sh ./Scripts/bootstrap.sh -d很可能会有因为某种原因而网络连接失败。方法就是去App store下载了一个VPN代理软件，我下了一个评分最多且免费的，的确很好用。我就不说软件名称了。
       再次运行sh ./Scripts/bootstrap.sh -d 无报错就OK了

• 12，用Xcode打开WebDriverAgent，并且编译
         进入WebDriverAgent 文件夹，可用如下方法
  
  
         双击WebDriverAgent.xcodeproj打开此项目，这个项目由facebook开源 有兴趣的话可以研究https://github.com/facebook/WebDriverAgent/apple。在这里我们的目的就是更改一些配置，让他能够编译成功，首先编译之前你得有 ID账号，并且登录你的Xcode账户。当然如果有开发者账号那么会更好，不过我买不起，但是基于Xcode7之后，苹果放开了真机调试，所以没有开发者账号。也能在真机上跑起来，直接上截图。
         编译WebDriverAgentLib
  
  
         编译WebDriverAgentRunner
  
  
  
         关于为什么要设置Deployment Target，苹果官方宣称XCUItest支持9.3.4以上。但实际经过我测试9.0以上是没问题的，但是如果不调低最小安装的ios版本，会面临着WebDriverAgentRunner无法安装到ios9.0的手机上去的，所以无法测试ios9。
         若果编译的过程中有语法错误，应该是11步没有安装好
• 13，建立服务WebDriverAgent （手机和MAC都在同一个网段下，且都能连接外网）
         关闭Xcode，进入WebDriverAgent 文件夹

cd  /usr/local/lib/node_modules/appium/node_modules/appium-xcuitest-driver/WebDriverAgent
xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination 'id=真机的udid' test

       运行到最后会发现

       而iphone多了一个WebDriverAgentRunner的app。手动启动那个app的时候

       原因是我们手机并并没有信任这个apple id的开发者，到设置-通用-设备管理（描述文件） 信任你的apple id就可以了。再次运行上述命令，看到如下图，就成功了，

• 14，运行appium

appium -p 4723

 DesiredCapabilities cap = new DesiredCapabilities();
 cap.SetCapability(MobileCapabilityType.AutomationName, "XCUITest");
 cap.SetCapability(MobileCapabilityType.PlatformVersion, "10");
 cap.SetCapability(MobileCapabilityType.DeviceName, "iPhone 6s Plus");
 cap.SetCapability(MobileCapabilityType.PlatformName, "iOS");
// cap.SetCapability("webDriverAgentUrl", "http://localhost:8100");
 cap.SetCapability(MobileCapabilityType.Udid, "c8ff753c91ee2eda9be215e4109513c75b5b30c9");
 cap.SetCapability(MobileCapabilityType.NewCommandTimeout, 3600);
 cap.SetCapability("bundleId", "com.test.app");
 IOSDriver<IOSElement> driver = new IOSDriver<IOSElement>(new Uri("http://192.168.0.20:4724/wd/hub"), cap, TimeSpan.FromSeconds(120));

       就可以成功启动了。手机上的apple id的描述文件，需要时时连接到苹果官网去验证，所以一旦手机关闭外网，WebDriverAgentRunner就会启动不了，所以用apple ID这就是比较悲催事情的，如果用开发者账号应该不会有这种情况。
       第一次启动会比较慢，大约1分钟。因为第一次启动appium需要建立13步的服务，第二次启动默认会把WebDriverAgentRunner关掉再启动（这个就比较蛋疼了）每次启动都是1分钟。研究了好久。终于解决了。 把webDriverAgentUrl参数放开。appium就会直接用这个url和WebDriverAgentRunner通信，不会再去建立新的服务，启动一个app就很迅速了。实际跑下来，并没有网上说的那么慢。但是确实也不算快。
       上张成功启动后的appium日志截图。