1 appium安装及环境搭建
1.1 安装JDK并配置环境变量
- 在Java官方网站上下载相应系统的jdk文件安装,全部选择默认的安装路径即可安装完成。
- 配置JAVA_HOME:新建 JAVA_HOME 环境变量,变量值是自己安装JDK 的路径
- 配置ClASSPATH:新建 CLASSPATH 环境变量:.;%JAVA_HOME%/lib/dt.jar;%JAVA_HOME%/lib/tools.jar
- 配置PATH:找到PATH变量,追加如下目录:%JAVA_HOME%/bin;%JAVA_HOME%/jre/bin;
- 验证安装是否成功:java -version
--------------------------------------
C:Userszhouxy>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变量:
- tools目录:%ANDROID_HOME% ools
- platform-tools目录:%ANDROID_HOME%platform-tools
- build-tools目录:%ANDROID_HOME%uild-toolsandroid-4.4W
- 验证:在命令行窗口中输入adb
-------------------------------------------------
C:Userszhouxy>adb
Android Debug Bridge version 1.0.40
Version 4797878
Installed as D:Androidandroid-sdkplatform-toolsadb.exe
---------------------------------------------------
1.3 Python环境搭建
略。pip install Appium-Python-Client
1.4 安装node.js
- 到官网下载node.js: https://nodejs.org/en/。获取到安装文件后,直接双击安装文件,根据程序的提示,完成nodejs的安装
- 把Node.js的安装路径(也就是node.exe文件所在的目录)追加到环境变量Path
- 验证:在命令行窗口中输入node –v
---------------------------------
C:Userszhouxy>node -v
v8.11.3
--------------------------------
1.5 安装Appium
- 下载appium安装文件,链接:http://pan.baidu.com/s/1dE8hJ81 密码:t8yc
下载后解压,直接双击appium-installer.exe文件安装,桌面会生成一个appium的图标
- 手动在Path中配置appium环境变量:
将安装的Appium文件夹所在目录Appium ode_modules.bin添加进path
- 验证:输入appium-doctor ,出现以下提示说明环境成功。
--------------------------------------------------------
C:Userszhouxy>appium-doctor
Running Android Checks
✔ ANDROID_HOME is set to "D:Androidandroid-sdk"
✔ JAVA_HOME is set to "D:sunline-idejdk1.8.0_91."
✔ ADB exists at D:Androidandroid-sdkplatform-toolsadb.exe
✔ Android exists at D:Androidandroid-sdk oolsandroid.bat
✔ Emulator exists at D:Androidandroid-sdk oolsemulator.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: est
- 打开cmd,输入指令aapt dump badging D: estxxx.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