appium安裝及環境搭建、入門

1 appium安裝及環境搭建

1.1 安裝JDK並配置環境變量

1. 在Java官方網站上下載相應系統的jdk文件安裝，所有選擇默認的安裝路徑便可安裝完成。
2. 配置JAVA_HOME：新建 JAVA_HOME 環境變量，變量值是本身安裝JDK 的路徑
3. 配置ClASSPATH：新建 CLASSPATH 環境變量：.;%JAVA_HOME%/lib/dt.jar;%JAVA_HOME%/lib/tools.jar
4. 配置PATH：找到PATH變量，追加以下目錄：%JAVA_HOME%/bin;%JAVA_HOME%/jre/bin;
5. 驗證安裝是否成功：java -version

--------------------------------------

C:\Users\zhouxy>java –version  

Java version "1.8.0_91"       

-------------------------------------- 

1.2 Android SDK環境搭建

下載Android SDK：http://tools.android-studio.org/index.php/sdk

• 新建 ANDROID_HOME 環境變量，變量值是SDK解壓的路徑
• 追加sdk以下目錄到PATH變量：

1. 1. tools目錄：%ANDROID_HOME%\tools
   2. platform-tools目錄：%ANDROID_HOME%\platform-tools
   3. build-tools目錄：%ANDROID_HOME%\build-tools\android-4.4W

• 驗證：在命令行窗口中輸入adb

-------------------------------------------------

C:\Users\zhouxy>adb
Android Debug Bridge version 1.0.40
Version 4797878
Installed as D:\Android\android-sdk\platform-tools\adb.exe

---------------------------------------------------

1.3 Python環境搭建

略。pip install Appium-Python-Client

 

1.4 安裝node.js

1. 到官網下載node.js： https://nodejs.org/en/。獲取到安裝文件後，直接雙擊安裝文件，根據程序的提示，完成nodejs的安裝
2. 把Node.js的安裝路徑（也就是node.exe文件所在的目錄）追加到環境變量Path
3. 驗證：在命令行窗口中輸入node –v

---------------------------------        

C:\Users\zhouxy>node -v
v8.11.3

--------------------------------

1.5 安裝Appium

• 下載appium安裝文件，連接：http://pan.baidu.com/s/1dE8hJ81   密碼：t8yc

      下載後解壓，直接雙擊appium-installer.exe文件安裝，桌面會生成一個appium的圖標

• 手動在Path中配置appium環境變量：

      將安裝的Appium文件夾所在目錄\Appium\node_modules\.bin添加進path

• 驗證：輸入appium-doctor ，出現如下提示說明環境成功。

--------------------------------------------------------

C:\Users\zhouxy>appium-doctor
Running Android Checks
✔ ANDROID_HOME is set to "D:\Android\android-sdk"
✔ JAVA_HOME is set to "D:\sunline-ide\jdk1.8.0_91."
✔ ADB exists at D:\Android\android-sdk\platform-tools\adb.exe
✔ Android exists at D:\Android\android-sdk\tools\android.bat
✔ Emulator exists at D:\Android\android-sdk\tools\emulator.exe
✔ Android Checks were successful.

✔ All Checks were successful

--------------------------------------------------------

2 安裝Android版本

雙擊 SDK Manage.exe 啓動SDK管理器

雙擊 AVD Manage.exe 啓動AVD管理器

點擊 「Create…」 按鈕，建立Android虛擬機

不要選擇超過電腦屏幕分辨率的Device，其它選項參考上圖。點擊 「OK」 建立完成。在 AVD Manage 工具中選中建立的Android虛擬機，點擊 「Start…」 按鈕啓動

 

打開Appium，點擊右上角三角按鈕，注意Appium的啓動日誌

 

3 獲取包名和launcherActivity

3.1 aapt工具

aapt即Android Asset Packaging Tool，在SDK的build-tools目錄下，該工具能夠查看apk包名和launcherActivity。

在build-tools安裝的版本下錄下找到aapt.exe，將這個路徑設置環境變量，添加到path下。

打開cmd，輸入aapt出現以下界面

3.2 獲取apk包名

• 將準備測試的APK放到D盤某個目錄，如D:\test
• 打開cmd，輸入指令aapt dump badging D:\test\xxx.apk(APK的全名，如手機淘寶.apk)
• package:name='包名'

3.3 獲取launcherActivity

• launchable-activity:name='launcherActivity名'

或者直接在tools啓動monitor.bat或者uiautomatorviewer.bat，可用來查看元素

4 Appium的API操做 

• deviceName：啓動哪一種設備，是真機仍是模擬器？iPhone Simulator，iPad Simulator，iPhone Retina 4-inch，Android Emulator，Galaxy S4…

• automationName：使用哪一種自動化引擎。appium（默認）仍是Selendroid。

• platformName：使用哪一種移動平臺。iOS, Android, orFirefoxOS。

• platformVersion：指定平臺的系統版本。例如指的Android平臺，版本爲5.1。

• appActivity：待測試的app的Activity名字。好比MainActivity、.Settings。注意，原生app的話要在activity前加個」.「。

• appPackage：待測試的app的Java package。好比com.example.android.myApp, com.android.settings。

from appium import webdriver

desired_caps={}
desired_caps['platformName']='Android'
desired_caps['platformVersion']='4.4.2'
desired_caps['deviceName']='Android Emulator'
desired_caps['appPackage']='com.android.calculator2'
desired_caps['appActivity']='.Calculator'

driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub',desired_caps)

driver.find_element_by_name('9').click()
driver.find_element_by_accessibility_id('plus').click()
driver.find_element_by_name('8').click()
driver.find_element_by_accessibility_id('equals').click()

driver.quit()

4.1 API之應用操做

4.1.1 安裝應用

• installApp() #指定apk路徑

4.1.2 卸載應用

• removeApp() #指定包名

4.1.3 關閉應用

• closeApp()

4.1.4 啓動應用

• launchApp()

4.1.5 檢查應用是否安裝

• isAppInstalled() #指定包名

4.1.6 將應用置於後臺

• runAppInBackground() #指定置於後臺的時長

4.1.7 應用重置

• resetApp()

4.2 API之上下文操做

4.2.1 獲取當前上下文

• getContext()

4.2.2 當前全部上下文句柄

• getContextHandles()

4.2.3 切換上下文

• context() #指定上下文名稱

4.3 API 之鍵盤操做

4.3.1 sendKeys()方法

4.3.2 pressKeyCode()方法

下面提供Android keycode參考表：

電話鍵：

KEYCODE_CALL 撥號鍵 5

KEYCODE_ENDCALL 掛機鍵 6

KEYCODE_HOME 按鍵Home 3

KEYCODE_MENU 菜單鍵 82

KEYCODE_BACK 返回鍵 4

KEYCODE_SEARCH 搜索鍵 84

KEYCODE_CAMERA 拍照鍵 27

KEYCODE_FOCUS 拍照對焦鍵 80

KEYCODE_POWER 電源鍵 26

KEYCODE_NOTIFICATION 通知鍵 83

KEYCODE_MUTE 話筒靜音鍵 91

KEYCODE_VOLUME_MUTE 揚聲器靜音鍵 164

KEYCODE_VOLUME_UP 音量增長鍵 24

KEYCODE_VOLUME_DOWN 音量減少鍵 25

控制鍵：

KEYCODE_ENTER 回車鍵 66

KEYCODE_ESCAPE ESC鍵 111

KEYCODE_DPAD_CENTER 導航鍵 肯定鍵 23

KEYCODE_DPAD_UP 導航鍵 向上 19

KEYCODE_DPAD_DOWN 導航鍵 向下 20

KEYCODE_DPAD_LEFT 導航鍵 向左 21

KEYCODE_DPAD_RIGHT 導航鍵 向右 22

KEYCODE_MOVE_HOME 光標移動到開始鍵 122

KEYCODE_MOVE_END 光標移動到末尾鍵 123

KEYCODE_PAGE_UP 向上翻頁鍵 92

KEYCODE_PAGE_DOWN 向下翻頁鍵 93

KEYCODE_DEL 退格鍵 67

KEYCODE_FORWARD_DEL 刪除鍵 112

KEYCODE_INSERT 插入鍵 124

KEYCODE_TAB Tab鍵 61

KEYCODE_NUM_LOCK 小鍵盤鎖 143

KEYCODE_CAPS_LOCK 大寫鎖定鍵 115

KEYCODE_BREAK Break/Pause鍵 121

KEYCODE_SCROLL_LOCK 滾動鎖定鍵 116

KEYCODE_ZOOM_IN 放大鍵 168

KEYCODE_ZOOM_OUT 縮小鍵 169

組合鍵：

KEYCODE_ALT_LEFT Alt+Left

KEYCODE_ALT_RIGHT Alt+Right

KEYCODE_CTRL_LEFT Control+Left

KEYCODE_CTRL_RIGHT Control+Right

KEYCODE_SHIFT_LEFT Shift+Left

KEYCODE_SHIFT_RIGHT Shift+Right

基本：

KEYCODE_0 按鍵’0’ 7

KEYCODE_1 按鍵’1’ 8

KEYCODE_2 按鍵’2’ 9

KEYCODE_3 按鍵’3’ 10

KEYCODE_4 按鍵’4’ 11

KEYCODE_5 按鍵’5’ 12

KEYCODE_6 按鍵’6’ 13

KEYCODE_7 按鍵’7’ 14

KEYCODE_8 按鍵’8’ 15

KEYCODE_9 按鍵’9’ 16

KEYCODE_A 按鍵’A’ 29

KEYCODE_B 按鍵’B’ 30

KEYCODE_C 按鍵’C’ 31

KEYCODE_D 按鍵’D’ 32

KEYCODE_E 按鍵’E’ 33

KEYCODE_F 按鍵’F’ 34

KEYCODE_G 按鍵’G’ 35

KEYCODE_H 按鍵’H’ 36

KEYCODE_I 按鍵’I’ 37

KEYCODE_J 按鍵’J’ 38

KEYCODE_K 按鍵’K’ 39

KEYCODE_L 按鍵’L’ 40

KEYCODE_M 按鍵’M’ 41

KEYCODE_N 按鍵’N’ 42

KEYCODE_O 按鍵’O’ 43

KEYCODE_P 按鍵’P’ 44

KEYCODE_Q 按鍵’Q’ 45

KEYCODE_R 按鍵’R’ 46

KEYCODE_S 按鍵’S’ 47

KEYCODE_T 按鍵’T’ 48

KEYCODE_U 按鍵’U’ 49

KEYCODE_V 按鍵’V’ 50

KEYCODE_W 按鍵’W’ 51

KEYCODE_X 按鍵’X’ 52

KEYCODE_Y 按鍵’Y’ 53

KEYCODE_Z 按鍵’Z’ 54