appium ios 真机自动化环境搭建

近期由于工作需要，本小菜在弄appium+ios+iphone真机的移动自动化，在网上找寻各种资料，发现针对IOS方面的资料少之又少，公司其它部门的弄过的同事也寥寥无几，即使有，也是安卓方面的。本次书写此文章，是为了帮助依然在坑里摸爬滚打的伙伴们，早日出坑。

一、环境：

macBook Pro：10.13.4

iphone真机：iphone6 plus 11.3.1

appium 1.8.1

xcode 9.3.1

二、appium原理（转自https://blog.csdn.net/achang21/article/details/60956618的介绍）

Appium是一个开源、跨平台的测试框架，可以用来测试原生及混合的移动端应用。Appium支持IOS、Android及FirefoxOS平台。Appium使用WebDriver的json wire协议，来驱动Apple系统的UIAutomation库、Android系统的UIAutomator框架。Appium对IOS系统的支持得益于Dan Cuellar’s对于IOS自动化的研究。Appium也集成了Selendroid，来支持老android版本。

Appium支持Selenium WebDriver支持的所有语言，如java、Object-C、JavaScript、Php、Python、Ruby、C#、Clojure，或者Perl语言，更可以使用Selenium WebDriver的Api。Appium支持任何一种测试框架。如果只使用Apple的UIAutomation，我们只能用javascript来编写测试用例，而且只能用Instruction来运行测试用例。同样，如果只使用Google的UIAutomation，我们就只能用java来编写测试用例。Appium实现了真正的跨平台自动化测试。

appium选择了client-server的设计模式。只要client能够发送http请求给server，那么的话client用什么语言来实现都是可以的，这就是appium及webdriver如何做到支持多语言的；

三、环境搭建步骤：

---------------------必要的库安装--------------------------------------

1.xcode安装，app store里安装xcode

2.如果没有安装 过homebrew，请先安装

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

3.如果没有安装过npm及node.js，请先安装

brew install npm，此命令执行后，npme和node.js会全部安装完毕

4.安装依赖库

brew install libimobiledevice --HEAD

npm install -g ios-deploy  #如果是iOS10以上的系统才需要安装

如果没有安装 libimobiledevice，会导致Appium无法连接到iOS的设备，所以必须要安装，如果要在iOS10+的系统上使用appium，则需要安装ios-deploy

5.appium-doctor 安装

npm install appium-doctor -g

安装后执行appium-doctor --ios指令，可以查看与iOS相关配置是否完整，下图是全部配置都成功,如果有哪一项是打叉的，则进行安装就可以了。比如如果carthage项是打叉的，则需要安装：

brew install carthage

---------------------webdriverAgent--------------------------------------

1.安装webdriverAgent

(1)在github上下载最新webdriverAgent代码

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

(2)下载依赖

cd /Users/yourname/WebDriverAgent

mkdir -p Resources/WebDriverAgent.bundle

sh ./Scripts/bootstrap.sh

该脚本会使用Carthage下载所有的依赖，使用npm打包响应的js文件。执行完成后，直接双击打开WebDriverAgent.xcodeproj这个文件。

2.配置WebDriverAgent

配置WebDriverAgentLib，选择开发者账号

配置WebDriverAgentRunner，选择开发者账号

3.连接并选择自己的ios设备，运行

运行成功后，iphone手机上会新建一个无图标的WebDriverAgent的应用，自动打开后马上又返回桌面

而在xcode控制台会打印如下日志：里面有IP地址与端口号

4.在网址上输入http://(ip地址):(端口号)/status，如果网页上返回一些json格式的数据，说明运行成功http://10.0.223.58:8100/status，有些iphone手机通过手机的IP和端口号还不能访问，此时需要将手机的端口转发到mac上

iproxy 8100 8100

执行命令后，通过访问 http://localhost:8100/ status来验证, 如果网页上返回一些json格式的数据，说明运行成功

而如果是想查看UI的图层，则可访问http://localhost:8100/inspector，方便书写测试用例

备注：通常来说为了持续集成，自动化会比较好一些，我们不必每次都通过这种方式来启动xcode、WebDriverAgent，这种方式只在第1次搭建环境时运行即可，我们可以在自动化脚本中加入如下代码，这样只要在以后启动appium后，运行自动化脚本，就会直接启动WebDriverAgent

desiredCapabilities.setCapability("useNewWDA", true);

如果xcode在先启动wda，而代码中又用此行代码，运行时xcode中会显示执行失败，报出冲突的错误哦，所以后期只在代码中启动WebDriverAgent即可，不再需要用xcode启动

---------------------appium--------------------------------------

appium安装

我是使用源码安装的，在appium的版本选择上，我不建议一味的追求最新版，因为最新的版本相配套的其它依赖有可能还没有同步更新，可能会报各种各样的错误，而且最新版可能还不稳定，在此次搭建环境过程中，我用最新版appium会发现appium的bug，经在github上与appium开发者反复讨论，修复bug，才能解决问题。所以在版本的选择上，我建议使用稳定版本，而不必一味追求最新，小白鼠的角色并不好做，稳定才是最好的~

npm install –g appium

启动appium

appium --address 127.0.0.1 --port 4723

2.appium环境搭建的其它问题和调试方法：

(1)在appium执行过程中，我们可以根据appium的日志来查看哪个环节有错误，以下是我在网上随便找的一些日志分析，https://blog.csdn.net/jffhy2017/article/details/69372064，可以google找哦,网上关于日志分析的内容很多。

如果在appium执行中哪个环节出错，我们可以将post的命令直接输入在url中，看看返回的json串中的详细错误信息，根据此错误信息排错。

http://10.0.223.58:8100/(POST的命令)

(2)可以在github上给appium的开发者留言，来解决问题。自己的英文+google翻译，appium的开发者还是很耐心的，而且解决问题一针见血，非常对症~

附上我一个问题：https://github.com/appium/appium/issues/10775

---------------------appium实践实例-解锁九宫格-----------------------------------

（附上动态效果图：以后再加。。。）

代码如下：

public class SampleTest1 {

    private IOSDriver driver;

    @Before

    public void setUp() throws MalformedURLException {

        DesiredCapabilities desiredCapabilities = new DesiredCapabilities();

        desiredCapabilities.setCapability("deviceName", "iphone 6 Plus");

        desiredCapabilities.setCapability("platformVersion", "11.3.1");

        desiredCapabilities.setCapability("platformName", "iOS");

        desiredCapabilities.setCapability("app", "/Users/yangyang50/Desktop/work/JDMEIphone_4.6.0.ipa");

        desiredCapabilities.setCapability("udid", "*****************");//请填写手机的udid

        desiredCapabilities.setCapability("autoLaunch", false);

        desiredCapabilities.setCapability("useNewWDA", true);

        desiredCapabilities.setCapability("xcodeOrgId","******");//请填写开发者帐号对应的OrgId

        desiredCapabilities.setCapability("xcodeSigningId","iPhone Developer");

        URL remoteUrl = new URL("http://localhost:4723/wd/hub");

        driver = new IOSDriver(remoteUrl, desiredCapabilities);

    }

    @Test

    public void sampleTest1() throws InterruptedException{

        MobileElement element_cancel = (MobileElement) driver.findElementByAccessibilityId("取消");

        element_cancel.click();

        Thread.sleep(2000);

        MobileElement element_1 = (MobileElement) driver.findElementByXPath("(//XCUIElementTypeButton[@name="lock botton unselected"])[1]");

        MobileElement element_3 = (MobileElement) driver.findElementByXPath("(//XCUIElementTypeButton[@name="lock botton unselected"])[3]");

        MobileElement element_6 = (MobileElement) driver.findElementByXPath("(//XCUIElementTypeButton[@name="lock botton unselected"])[6]");

        TouchAction action = new TouchAction(driver);

        action.press(element_1).waitAction(500).moveTo(element_3).waitAction(500).moveTo(element_6).release().perform();

        Thread.sleep(1000);

    }

    @After

    public void tearDown() {

        driver.quit();

    }

}

---------------------
作者：softwareyan
来源：CSDN
原文：https://blog.csdn.net/u012873868/article/details/81132413
版权声明：本文为博主原创文章，转载请附上博文链接！