Appium移动自动化

一、 安装node.js

因为Appium是使用nodejs实现的，所以node是解释器，首先需要确认安装好

官网下载node.js：https://nodejs.org/en/download/

安装完成后，运行cmd，输入node –v 查看版本号，输出版本号则说明安装成功

二、安装android jdk并配置环境变量

1、在Java官方网站上下载相应系统的jdk文件安装，如win7 64 位系统下安装jdk-6u45-windows-x64，全部选择默认的安装路径即可安装完成。

2、配置JAVA_HOME
　　新建 JAVA_HOME 环境变量，变量值是自己安装JDK 的路径，我的是：D:\Java\jdk1.7.0；

3、配置ClASSPATH
新建 CLASSPATH 环境变量，变量值：%JAVA_HOME%/lib/dt.jar;%JAVA_HOME%/lib/tools.jar

4、配置PATH
　　找到PATH变量，追加如下目录：%JAVA_HOME%/bin;%JAVA_HOME%/jre/bin;

5、验证安装是否成功
　　1）打开cmd命令行窗口
　　2）在命令行窗口中输入java -version,显示如下内容表示安装成功：

　　

三、Android SDK环境搭建

1、下载ADT Bundle，ADT Bundle包含了Eclipse、ADT插件和SDK Tools，是已经集成好的IDE，只需安装好Jdk即可开始开发，不用再折腾开发环境。

2、解压下载下来的文件

3. 配置sdk环境变量

   环境变量：计算机—属性—高级系统设置—高级—环境变量

1）新建ANDROID_HOME 环境变量，变量值是android sdk 路径

本人是：C:\Users\Administrator\adb\android-sdk-windows

C:\Program Files\Java\jdk1.8.0_91

2）  追加sdk如下目录到PATH变量：

1) tools目录：%ANDROID_HOME%\tools

　　　2) platform-tools目录：%ANDROID_HOME%\platform-tools

　　　3) build-tools目录：%ANDROID_HOME%\build-tools

4、验证 Android SDK 相关环境变量

首先打开cmd命令行

1、验证 platform-tools 环境变量：

　　1) 在cmd命令行输入 adb shell，可以进入到当前的虚拟机系统（可用eclipse建立虚拟的手机，若用真机测试，就不需要了）则安装成功

　　2) 进行虚拟机系统后，输入ls命令，可以查看文件目录

　　3) 输入exit退出虚拟机环境

2、验证 tools 目录下的环境变量：

　　1)在命令行输入 android,该命令会启动Android SDK Manager

3、验证 build-tools 目录下的环境变量

　　1) 在命令行输入 aapt，会看到这条命令的使用帮助信息

至此，Android的测试环境基本搭建完毕。

四. 下载安装appium

　1）下载安装文件：https://bitbucket.org/appium/appium.app/downloads?tab=download

按提示安装就好

1、如何查看python selenium的api：

python -m pydoc -p 4567

http://localhost:4567

 

appium模拟键盘回车键：

driver.press_keycode("66")

 

2、关于输入 Appium 设置支持输入中文后，键盘无法调出

 //设置中文输入的属性，可以输入中文 
            capabilities.setCapability("unicodeKeyboard", "True");
            capabilities.setCapability("resetKeyboard", "True");

//可输入中文，但此时键盘不可用，输入法键盘为Appium unicodeKeyboard
        inputById("com.ccigmall.b2c.android:id/search_input","回归150608163530");
        //使用adb shell 切换输入法-更改为谷歌拼音
        excuteAdbShell("adb shell ime set com.android.inputmethod.pinyin/.PinyinIME");
        //再次点击输入框，调取键盘，谷歌键盘被成功调出
        clickById("com.ccigmall.b2c.android:id/search_input");
        //点击右下角的搜索，即ENTER键
        sendKeyEvent(AndroidKeyCode.ENTER);
        //再次切回 输入法键盘为Appium unicodeKeyboard，方便下次输入中文
        excuteAdbShell("adb shell ime set io.appium.android.ime/.UnicodeIME");

 

driver是测试最基础最主要的类，可以看到我们在setup方法里面对driver进行了实例化，也可以直接在构造方法里面进行实例化。记得不要写漏了tearDown方法，如果缺少这个方法的话在很多用例一起测试的时候是不行的，只有使用这个才能完全的退出应用程序。

另外需要注意一点的是在使用的时候记得手机的锁屏时间调为永不锁屏，否则在多个用例一起执行的时候肯定是会出问题的。一些其他可能遇到其他的问题我的博客里面有

Appium一些错误总结

开发的时候对方法多做一些封装，直接的使用API会对代码的复用会比较差。

下面是附上Appium的API

五、Appium 之 java API

AppiumDriver

getAppStrings()      默认系统语言对应的Strings.xml文件内的数据。

driver.getAppStrings(Stringlanguage)      查找某一个语言环境对应的字符串文件Strings.xml内数据

sendKeyEvent(intkey)       按下某个键，具体哪个键由key值决定，key值定义在AndroidKeyCode类中

sendKeyEvent(intkey, Integer metastate)  按下某个键的同时按下附加键（Ctrl/Alt/Shift等），具体是哪些键，由key值（AndroidKeyCode类中定义）和metastate（AndroidKeyMetastate类中定义）决定。

currentActivity()        获取当前activity,比如（.ApiDemos）

isAppInstalled(StringbundleId)   根据bundleId来判断该应用是否已经安装

installApp(StringappPath)    安装app，appPath为应用的本地路径

removeApp(StringbundleId)   卸载app.bundleId在android中代表的是报名，而在ios中有专门的bundleId号。

closeApp() 关闭应用，其实就是按home键把应用置于后台

launchApp()  启动应用

resetApp()   先closeApp然后在launchAPP

pushFile(StringremotePath, byte[] base64Data)   将字符数组用64位格式写到远程目录的某个文件中。也可以理解为把本地文件push到设备上。

pullFile(StringremotePath)     将设备上的文件pull到本地硬盘上

pullFolder(StringremotePath)    将设备上的文件夹pull到本地硬盘上，一般远程文件为/data/local/tmp下的文件。

setNetworkConnection(NetworkConnectionSettingconnection)   设置手机的网络连接状态，可以开关蓝牙、wifi、数据流量。通过NetworkConnectionSetting中的属性来设置各个网络连接的状态。

getNetworkConnection()   得到当前网络的状态

openNotifications()   打开通知栏

runAppInBackground(intseconds)    与resetApp类似，区别是resetApp关闭后立即启动，而这个方法是关闭后等待seconds秒后再启动。

hideKeyboard()   ios隐藏键盘

hideKeyboard(Stringstrategy, String keyName)   隐藏键盘，只能用于ios上。

performTouchAction(TouchActiontouchAction)   执行一个touch动作，该touch动作是由TouchAction封装的。

performMultiTouchAction(MultiTouchActionmultiAction)  执行多步touch动作，由MultiTouchAction封装的多步操作。

tap(intfingers, WebElement element, int duration)    点击element控件中心点按下，duration*5毫秒秒后松开，如此重复fingers次。

tap(intfingers, int x, int y, int duration)   点击(x,y)点按下，duration*5毫秒后松开，如此重复fingers次。

swipe(intstartx, int starty, int endx, int endy, int duration)   从(startx,starty)滑到（endx,endy），分duration步滑，每一步用时是5毫秒。

pinch(WebElementel)    2个手指操作控件，从对角线向中心点滑动。

pinch(intx, int y)   以（x,y）为基准，计算得出（x,y-100）,(x,y+100)两个点，然后2个手指按住这两个点同时滑到（x,y）

zoom(WebElementel) 与pinch(el)的动作刚好相反。两个手指由控件的中心点慢慢向控件的左顶点后右底点滑动。

zoom(intx, int y) 和pinch(x,y)相反。两个手指从（x,y）点开始向（x,y-100）和（x,y+100）滑动。

getNamedTextField(Stringname) 一般用在ios中。根据accessibility id获得控件对象。

endTestCoverage(Stringintent, String path) 结束测试覆盖率的检测。（没用过，不太了解）path为.ec文件的路径。

lockScreen(intseconds)   锁屏多少秒后解锁

shake() 模拟摇晃手机（目前还没实现）

scrollTo(Stringtext) 滚动到某个text属性为指定的字符串的控件

scrollToExact(Stringtext)  滚动到某个text属性包含传入的字符串的控件

context(String name）设置上下文

getContextHandles()  可用上下文

getContext()  当前上下文

rotate(ScreenOrientationorientation)  设置屏幕横屏或者竖屏

getOrientation() 获取当前屏幕的方向

findElementByIosUIAutomation(Stringusing)    利用ios中的uiautomation中的属性来获取控件

findElementsByIosUIAutomation(Stringusing) 和上面一样，不过获得的是多个控件

findElementByAndroidUIAutomator(Stringusing) 利用android的uiautoamtor中的属性来获取单个控件。

findElementsByAndroidUIAutomator(Stringusing) 和上面一样，但是该方法获得是多个控件

findElementByAccessibilityId(Stringusing) 利用accessibility id来获取单个控件

findElementsByAccessibilityId(Stringusing)利用accessibility id来获得多个控件

TouchAction    AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等。TouchAction的原理是讲一系列的动作放在一个链条中，然后将该链条传递给服务器。服务器接受到该链条后，解析各个动作，逐个执行。

press(WebElementel)  在控件上执行press操作。

press(intx, int y) 在坐标为（x,y）的点执行press操作

press(WebElementel, int x, int y) 在控件el的左上角的x坐标偏移x单位，y左边偏移y单位的坐标上执行press操作。

release() 释放操作，代表该系列动作的一个结束标志。

moveTo(WebElementel) 以el为目标，从另一个点移动到该目标上

moveTo(intx, int y)以（x,y）点为目标，从另一个点移动到该目标上

moveTo(WebElementel, int x, int y)以控件el的左上角为基准，x轴向右移动x单位，y轴向下移动y单位。以该点为目标，从另一个点移动到该点上。

tap(WebElementel) 在控件的中心点上敲击一下

tap(intx, int y)在（x,y）点轻击一下

tap(WebElementel, int x, int y) 以控件el的左上角为基准，x轴向右移动x单位，y轴向下移动y单位。在该点上轻击。

waitAction() 代表一个空操作，等待一段时间

waitAction(int ms) 等待ms秒

longPress(WebElementel) 控件长按

longPress(intx, int y)  点长按

longPress(WebElementel, int x, int y)  偏移点长按

cancel() 取消执行该动作

perform()  执行该动作

一、 安装node.js

因为Appium是使用nodejs实现的，所以node是解释器，首先需要确认安装好

官网下载node.js：https://nodejs.org/en/download/

安装完成后，运行cmd，输入node –v 查看版本号，输出版本号则说明安装成功

二、安装android jdk并配置环境变量

1、在Java官方网站上下载相应系统的jdk文件安装，如win7 64 位系统下安装jdk-6u45-windows-x64，全部选择默认的安装路径即可安装完成。

2、配置JAVA_HOME
　　新建 JAVA_HOME 环境变量，变量值是自己安装JDK 的路径，我的是：D:\Java\jdk1.7.0；

3、配置ClASSPATH
新建 CLASSPATH 环境变量，变量值：%JAVA_HOME%/lib/dt.jar;%JAVA_HOME%/lib/tools.jar

4、配置PATH
　　找到PATH变量，追加如下目录：%JAVA_HOME%/bin;%JAVA_HOME%/jre/bin;

5、验证安装是否成功
　　1）打开cmd命令行窗口
　　2）在命令行窗口中输入java -version,显示如下内容表示安装成功：

　　

三、Android SDK环境搭建

1、下载ADT Bundle，ADT Bundle包含了Eclipse、ADT插件和SDK Tools，是已经集成好的IDE，只需安装好Jdk即可开始开发，不用再折腾开发环境。

2、解压下载下来的文件

3. 配置sdk环境变量

   环境变量：计算机—属性—高级系统设置—高级—环境变量

1）新建ANDROID_HOME 环境变量，变量值是android sdk 路径

本人是：C:\Users\Administrator\adb\android-sdk-windows

C:\Program Files\Java\jdk1.8.0_91

2）  追加sdk如下目录到PATH变量：

1) tools目录：%ANDROID_HOME%\tools

　　　2) platform-tools目录：%ANDROID_HOME%\platform-tools

　　　3) build-tools目录：%ANDROID_HOME%\build-tools

4、验证 Android SDK 相关环境变量

首先打开cmd命令行

1、验证 platform-tools 环境变量：

　　1) 在cmd命令行输入 adb shell，可以进入到当前的虚拟机系统（可用eclipse建立虚拟的手机，若用真机测试，就不需要了）则安装成功

　　2) 进行虚拟机系统后，输入ls命令，可以查看文件目录

　　3) 输入exit退出虚拟机环境

2、验证 tools 目录下的环境变量：

　　1)在命令行输入 android,该命令会启动Android SDK Manager

3、验证 build-tools 目录下的环境变量

　　1) 在命令行输入 aapt，会看到这条命令的使用帮助信息

至此，Android的测试环境基本搭建完毕。

四. 下载安装appium

　1）下载安装文件：https://bitbucket.org/appium/appium.app/downloads?tab=download

按提示安装就好