前言：

前段時間學習Android自動化測試，網上關于Appium的介紹和學習資料比較散亂，大多不齊全，官網API看的也是一臉懵，所以決定自己整理一份文檔，供自己學習，也希望能幫助到正在學習Appium和自動化測試的朋友們。
在本地寫了一個md文檔之后，放到了GitHub上維護。鑒于簡書的顏值，我決定轉戰簡書寫博客，但是簡書的Markdown貌似不只是頁內錨點跳轉，所以本文的所有錨點都無效了。文章有些長，需要pdf的朋友們可以去我的GitHub上拿。

為什么選擇Appium

學習Android自動化測試的時候，看了google官方推薦的幾個工具和測試框架，比如Espresso和UI Automator，其中在使用UI Automator來做UI自動化測試的時候，發生一點問題：向控件輸入字符的時候無效！不管是中文還是英文都無法輸入，而且最終竟然還顯示測試通過。經過多方搜索都找不到解決辦法，最終還是選擇Appium，并且Appium是跨平臺的，可以測試ios和Android還有webApp；其中Android平臺上是基于UI Automator的，所以可以無縫切換使用UI Automator的API。

作者：GeeJoe
郵箱：geejoe_developer@outlook.com
GitHub：https://github.com/GeeJoe/AppiumDoc
更新時間：2017-09-14 16:44

Appium使用指南

• 環境配置
• 啟動Appium Server
• 學習DesiredCapabilities
• Session簡介
• 元素定位
• 使用UI Automator定位元素
• 使用JUnit組織測試用例
• 顯式等待和隱式等待

環境配置

• 安裝Nodejs
• 安裝Appium
• 配置IDE

安裝NodeJs

到 Nodejs官網 下載最新版本的NodeJs并直接安裝。安裝完畢后，打開命令行，輸入 node -v ，出現類似下面的信息說明安裝成功。

V4.0.0

安裝Appium

到 Appium 官網 載和你所使用系統一致的版本進行安裝。

驗證安裝

當確認Appium安裝完畢后，我們可以通過 appium-doctor 的命令來檢查當前appium安裝是否完善，當前的JDK、SDK等環境是否配置正確。

如果 appium-doctor 返回的內容是有錯的，請根據返回的具體的提示，將你的環境搭建完善。
如果返回的結果類似如下，說明安裝成功

...
...
Android Checks were successful.
All Checks were successful

需要注意的是，如果你是通過安裝包安裝的，使用 appium-doctor 命令時必須切換到
C:\Program Files (x86)\Appium\node_modules.bin 目錄;為了方便，需要把.bin目錄添加到環境變量Path中。

配置IDE

配置AndroidStudio

1. 新建一個項目，AndroidStudio新建項目會自動生成一個 androidTest 包和 test 包
2. 下載 Appium java client 及 Selenium Java standalone server 兩個庫對應的 jar 包
3. 將兩個jar包復制到項目module里的 libs 目錄
4. 選擇兩個jar包，單擊鼠標右鍵，選擇Add as Library
5. 配置成功，可以在 test 包中新建測試用例了

啟動Appium Server

通過圖形化界面啟動

雙擊Appium圖標，打開Appium應用

appium_start.png

點擊箭頭所指的按鈕即可啟動

從命令行啟動

只需要一個命令：

appium

若顯示如下信息則啟動成功：

info: Welcome to Appium v1.4.16 (REV ae6877eff263066b26328d457bd285c0cc62430d)
info: Appium REST http interface listener started on 0.0.0.0:4723
info: Console LogLevel: debug

若需要退出，按下 ctrl+c 即可

配置啟動參數

啟動時可以手動配置參數，了解所有參數，可查閱 Appium 官方文檔

這些參數同樣可以在圖形界面設置：

setting.png

學習DesiredCapabilities

DesiredCapabilities簡介

DesiredCapabilities 攜帶了一些配置信息，在啟動session的時候是必須提供，如啟動模式、apk/app配置、package/activity配置、瀏覽器配置、鍵盤配置等。

Desired Capabilities關鍵字

Desired Capabilities的重要作用是在啟動時傳遞信息給Appium Server。
下表中列舉了Appium常用的 Desired Capabilities 關鍵字。

Android 獨有

Session簡介

Session 是指我們的測試腳本從打開應用到最終執行完畢關閉應用的整個過程。
對于測試腳本，從申請到退出一個 session 的整個過程如下：

//打開一個應用，也可以稱為“申請一個Session”
AndroidDriver driver = new AndroidDriver<>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);

//此處的所有代碼處于一個Session中
...

//關閉應用，也可以稱為“退出一個Session”
driver.quit();

元素定位

注： 每一個方法對應著一個findElementsBy***方法，后者返回一個Element集合List，表示一個符合查找規則的一個Element集合

findElementByName

在Android中，沒有合適的方法可以找到控件的Name屬性，但是大多數情況下可以用控件的text代替name。

findElementByAndroidUIAutomator

使用UI Automator查找控件：

WebElement el = driver.findElementByAndroidUIAutomator("new UiSelector().text(\"Add note\")");

更多關于UI Automator定位元素的方法，詳見：UI Automator定位元素

findElementByClassName

WebElement el = driver.findElementByClassName("android.weight.TextView");

findElementById

WebElement el = driver.findElementById("android:id/title");

如果目標設備的API Level低于18則UIAutomatorViewer不能獲得對應的Resource ID，只有等于大于18的時候才能使用。

findElementByAccessibilityId

WebElement el = driver.findElementByAccessibilityId("menu_add_note_description");

Accessibility ID在Android上面就等同于contentDescription

findEelementByXPath

WebElement el = driver.findElementByXPath("http://android.widget.TextView[contains(@text,'Add note')]");  

xPath是一種路徑，在uiautomatorviewer中可以查看當前頁面的元素層級，XPath就是用來描述這種層級關系的一種路徑表達方式，比如，下圖中的例子，想找列表中第二個note1，則可以這樣寫：

UIAutomatorviewer.png

WebElement el = driver.findElementByXPath("http://android.widget.LinearLayout[1]/android.widget.FrameLayout/android.widget.ListView/android.widget.TextView[contains(@index,0)]");  

findElementByCssSelector

這個方法是針對WebView容器下面的控件定位的，因為現在針對的是Native App暫時還沒有用到，所以先標記下，今后需要的時候加上去。

findElementByLinkText

這個方法是針對WebView容器下面的控件定位的，因為現在針對的是Native App暫時還沒有用到，所以先標記下，今后需要的時候加上去。

findElementByPartialLinkText

這個方法是針對WebView容器下面的控件定位的，因為現在針對的是Native App暫時還沒有用到，所以先標記下，今后需要的時候加上去。

UI Automater定位元素

UI Automator中主要通過UISelector類查找元素

通過文本信息定位

通過description定位

通過ResourceId定位

通過類名定位

通過層級關系

使用JUnit組織測試用例

使用JUnit來組織Appium測試用例，可以添加@Before、@Test或者@After等注解來使測試代碼的運行變得更加靈活。

比如在開始測試之前，需要配置Capability和連接Appium服務器，而且一般需要安裝應用或者打開應用的某個Activity。這時候可把這些操作放到一個方法中，并且方法添加@Before注解，則在運行的時候，@Before方法會先于@Test方法執行。

同理，測試結束后需要關閉session，回收資源等等，可以把這些操作放到一個@After方法中，@After方法在所有@Test方法結束之后執行。

顯式等待和隱式等待

有時候，由于網絡或者其他原因，頁面跳轉之后，某些元素沒有立即顯示出來，此時查找元素會失敗。這種情況就需要引入顯式等待和隱式等待

線程等待

直接使用Thread.sleep();

隱式等待

driver.manage().timeouts().implicitlyWait(30, TimeUnit.SECONDS);

全局等待30秒，不管元素是否已經加載

顯式等待

WebDriverWait 顯示等待，顯示等待時間可以通過 WebDriverWait 和 util 來決定,比如這個 timeOut 是60，如果該元素60s以內出現就不在等待。

WebDriverWait wait = new WebDriverWait(driver, 60);
    WebElement e= wait.until(new  ExpectedCondition<WebElement>() {
            @Override
            public WebElement apply(WebDriver d) {
                return d.findElement(By.id("q"));
            }
        })