目錄
1、下載、安裝JDK&配置Java環境變量
JDK下載地址:http://www.oracle.com/technetwork/java/javase/downloads/index.html
配置環境變量：
1、右鍵我的電腦--屬性--高級--環境變量
2、新建系統變量JAVA_HOME 和CLASSPATH
變量名：JAVA_HOME
變量值：C:\Program Files\Java\jdk1.7.0
變量名：CLASSPATH
變量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;
3、選擇“系統變量”中變量名為“Path”的環境變量，雙擊該變量，把JDK安裝路徑中bin目錄的絕對路徑，添加到Path變量的值中，並使用半角的分號和已有的路徑進行分隔。
變量名：Path
變量值：%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;
驗證配置是否成功：重新打開控制台輸入：java -verison，如果顯示Java版本信息表示安裝成功。
2、下載、安裝SDK、ADT&配置Android環境變量
ADT：http://developer.android.com/sdk/index.html
配置環境變量：
1、右鍵我的電腦--屬性--高級--環境變量
2、在系統變量域中新建ANDROID_HOME變量
變量名：ANDROID_HOME
變量值：E:\appium\adt-bundle-windows-x86_64-20131030\sdk\（根據實際情況而定）
3、選擇“系統變量”中變量名為“Path”的環境變量
變量名：Path
變量值：“;%Android_Home%\build-tools\android-4.4\;%Android_Home%\tools\;%Android_Home%\platform-tools”（android-4.4要視情況而定）
最后結果如圖：
ANDROID_HOME配置如下：
系統變量Path配置如下：
3、下載、安裝ANT&配置ANT環境變量
ANT下載地址:http://ant.apache.org
配置環境變量：
1、右鍵我的電腦--屬性--高級--環境變量
2、新建系統變量
變量名：ANT_HOME
變量值：C:\apache-ant-1.8.1
3、選擇“系統變量”中變量名為“Path”和“CLASSPATH”的環境變量
變量名：Path
變量值：%ANT_HOME%\bin;
變量名：CLASSPATH
變量值：%ANT_HOME%\lib;
4、創建UIAutomator工程
1、打開ADT自帶的Eclipse，新建Java Project
如圖：
2、添加JUnit庫
工程右鍵Build Path==>Configure Build Path==>Add Library
如圖：
3、添加android包和uiautomator包
工程右鍵Build Path==>Configure Build Path==>Add External JARs
如圖：
4、新建class，import jar包，編寫代碼，這部分參見下面案例
5、運行代碼
①查看SDK ID
CMD進入\Android-sdk\tools\目錄下，運行命令：android list ，查看對應android版本的SDK的ID值，當前是2；
②創建build文件
在\Android-sdk\tools\目錄下，運行命令：android create uitest-project -n <name> -t <android-sdk-ID> -p <path>
name是生成的jar包的名字，可以自定義，android-sdk-ID即上面看到的2，path是上面創建的工程路徑，比如：android create uitest-project -n UIAutomator -t 2 -p d:\code\LearnUiAutomator
運行成功后會在工程的根目錄下生成build.xml文件。
③編譯生成jar
CMD進入項目的工程目錄，運行命令：ant build，將使用ant編譯生成jar，成功將會提示：
然后會在bin目錄下生成jar文件。
④push並運行jar
adb push <jar文件路徑> data/local/tmp
adb shell uiautomator runtest <jar文件名> -c <工程中的類名，包含包名>
比如：
adb push d:\code\LearnUiAutomator\bin\UiAutomator.jar data/local/tmp
adb shell uiautomator runtest UiAutomator.jar -c com.UiAutomator
然后就能看到手機會按照TestDemo中的步驟自動執行。
5、UIAutomator簡單案例
package com.UIAutomator;
import com.android.uiautomator.core.UiObject;
import com.android.uiautomator.core.UiObjectNotFoundException;
import com.android.uiautomator.core.UiScrollable;
import com.android.uiautomator.core.UiSelector;
import com.android.uiautomator.testrunner.UiAutomatorTestCase;
public class TestDemo extends UiAutomatorTestCase {
public void setChineseLan() throws UiObjectNotFoundException {
//進入操作前，先用Home鍵進入待機界面
getUiDevice().pressHome();
//進入“系統設置”菜單。也可以通過點擊menu按鍵來實現
UiObject settingApp = new UiObject(new UiSelector().text("Settings"));
settingApp.click();
//等待3秒
try {
Thread.sleep(3000);
} catch (InterruptedException e1) {
e1.printStackTrace();
}
//用滾動的方式查找並進入“語言和輸入法設置”菜單
UiScrollable settingItems = new UiScrollable(
new UiSelector().scrollable(true));
UiObject languageAndInputItem = settingItems.getChildByText(
new UiSelector().text("Language & input"), "Language & input",
true);
languageAndInputItem.clickAndWaitForNewWindow();
//找到“English”的可點擊項（因為當前是英文環境）
UiObject setLanItem = new UiObject(new UiSelector().text("English"));
setLanItem.clickAndWaitForNewWindow();
//Log輸出
System.out.println("setLanItem-->" + setLanItem.getPackageName());
//由於無法識別中文，因此我們這里使用坐標去選擇“簡體中文”項
getUiDevice().click(350, 250);
//點擊返回鍵，回到待機界面
getUiDevice().pressBack();
getUiDevice().pressBack();
getUiDevice().pressBack();
}
}
6、UIAutomator對象介紹
UiDevice對象
getUiDevice()的方法可以得到一個UiDevice的對象，通過這個對象可以完成一些針對設備的動作：
click(int x, int y)
----在(x,y)表示的像素地方點擊
pressBack()
pressDelete()
pressEnter()
pressHome()
pressMenu()
pressSearch()
----點擊相應的按鍵
wakeUp()
----當手機處於滅屏狀態時，喚醒屏幕，並解鎖。
swipe(startX, startY, endX, endY, steps)
----在手機上滑動，從(startX,startY)到(endX,endY)。steps表示滑動的這個距離分為幾步完成，數目越少，滑動幅度越大。
setOrientationLeft()
setOrientationRight()
----將手機向相應方向旋轉。
setOrientationNatural()
----將手機旋轉狀態回歸正常。
UiSelector對象
這個對象可以理解為一種條件對象，描述的是一種條件，經常配合UiObject使用，可以得到某個（某些）符合條件的控件對象。
checked(boolean val)
----描述一種check狀態為val的關系。
className(className)
----描述一種類名為className的對象關系
clickable(boolean val)
----與checked類似，描述clickable狀態為val的關系
description(desc)
----不解釋
descriptionContains(desc)
----與description類似
focusable(boolean val)
----與checked類似
index(index)
----用當前對象在父對象集中的索引作為描述
packageName(String name)
----用包名作為條件描述
selected(val)
----描述一種選擇關系
text(text)
----最為常用的一種關系，用控件上的文本即可找到當前控件，需要注意，所有使用text屬性找到的控件，必須是英文的。也就是說，不支持通過中文查找控件！
textContains(text)
----與text類似
textStartsWith(text)
----與text類似
UiObject對象
這個對象可以理解為控件的對象。 一般一個UiObject對象可以通過一下形式得到：
UiObject mItem = new UiObject(new UiSelector().text("English"));
也就是配合一個UiSelector就可以得到一個控件。
click()
----點擊控件
clickAndWaitForNewWindow()
----點擊某個控件，並等待窗口刷新
longClick()
----長按
clearTextField()
----清除文本，主要針對編輯框
getChildCount()
----這個方法可以看出，其實UiObject也可以是一個控件的集合
getPackageName()
----得到控件的包名
getSelector()
----得到當前控件的選擇條件
getText()
----得到控件上的Text
isCheckable()
isChecked()
isClickable()
isLongClickable()
isScrollable()
isScrollable()
isSelected()
----判斷是否具備某個屬性
UiCollection對象
這個對象可以理解為一個對象的集合。因為UiSelector描述后得到的有可能是多個滿足條件的控件集合，因此可以用來生成UiCollection:
UiCollection mUiCollection = new UiCollection(new UiSelector().text("Settings"));
getChild(selector)
----從集合中再次通過UiSelector選擇一個UiObject對象
getChildByDescription(childPattern, text)
----從一個匹配模式中再次以text為條件選擇UiObject
getChildByText(childPattern, text)
----與上面類似。
getChildCount()
----得到當前集合中控件的個數
UiScrollable對象
UiScrollable可以生成一個滾動動作的對象，其最大的作用就是可以實現滾動的查找某個元素。用法如下：
UiScrollable settingItems = new UiScrollable( new UiSelector().scrollable(true));
等待操作和添加Log
如果是對於一個標准的UiObject對象，可以通過clickAndWaitForNewWindow的方法在點擊之后主動等待一段事件，但是如果需要額外的等待一段時間，特別對於getUiDevice().pressHome();這種操作，可能需要很長的事件去為下一步操作獲取更多的事件，此時我們可以使用線程的sleep方法去實現：
Thread.sleep(5000);
而添加Log的方法也可以通過Java標准的println來實現：
System.out.println("This used to print some log!!!" + setLanItem.getText());
以上Log將會在jar被運行時通過CMD窗口打印出來。