自动化-Appium-环境搭建-Android（Java版）

环境搭建-Android

本章节主要讲解在Windows和Mac环境下，搭建Appium所需要的软件等。

针对Android为Windows和Mac环境。

第1章 JDK

JDK（Java Development Kit）是Java语言的软件开发工具包，主要用于移动设备、嵌入式设备上的Java应用程序。JDK是整个Java开发的核心，它包含了Java的运行环境，Java工具和Java基础的类库。

1.1JDK for Win

1.1.1安装

在Windows环境下安装JDK，执行jdk-8u121-windows-x64.exe，弹出安装向导，点击下一步；

JDK安装路径默认安装即可，这里安装到D:\Java\jdk1.8.0_121目录下；

JRE安装路径默认安装即可，这里安装到D:\Java\jre1.8.0_121目录下；

之后点击下一步直到安装完成。

1.1.2配置环境变量

鼠标选中我的电脑右键，点击属性--->高级系统配置--->高级--->环境变量。

点击环境变量，系统变量里：

1、点击新建，变量名填写 CLASSPATH

变量值填写 .;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar

2、点击新建，变量名填写 JAVA_HOME

变量值填写 D:\Java\jdk1.8.0_121

3、修改Path，点击编辑，在变量值最后添加 ;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin

确定后，打开命令行，输入java -version，提示以下信息表示JDK环境变量配置成功。

1.2JDK for Mac

1.2.1安装

在Mac环境下安装JDK，执行jdk-8u144-macosx-x64.dmg默认安装即可。

1.2.2配置环境变量

1、打开终端，进入用户的根目录。

2、在终端输入命令 ls –a ，查询 .bash_profile文件是否存在。如果不存在，创建文件：touch .bash_profile

3、编辑文件 vi ~/.bash_profile，输入内容如下：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_144.jdk/Contents/Home

export PATH=PATH:JAVA_HOME/bin

4、编辑后保存文件，之后输入source ~/.bash_profile，使环境变量生效。

5、在终端输入java -version，提示以下信息表示JDK环境变量配置成功。

第2章 Android SDK

Android SDK（Software Development Kit）提供了在Windows/Linux/Mac平台上开发Android应用的开发组件，Android支持所有的平台，其包含了在Android平台上开发移动应用的各种工具集。

工具集不仅包括了Android模拟器和用于Eclipse的Android开发工具插件（ADT），而且包括了各种用来调试、打包和在模拟器上安装应用的工具。

Android SDK主要是以Java语言为基础，用户可以使用Java语言来开发Android平台上的软件应用。通过SDK提供的一些工具将其打包成Android平台使用的apk文件，然后用SDK中的模拟器（Emulator）来模拟和测试软件在Android平台上运行情况和效果。

2.1Android SDK for Win

2.1.1安装

在Windows环境下安装Android SDK，将android-sdk-windows.rar解压后放到自己指定的目录即可。例如：解压到D盘下。

2.1.2组件

进入Android SDK目录下，例如：D:\android-sdk

双击该目录下的SDK Manager程序，之后会启动Android SDK Manager。

之后安装Tools、Platform-tools、Build-tools、API等相关组件。

在安装API时根据要测试的模拟器或真机的Android版本而定，例如：使用的真机是Android 6.0版本，则Android SDK要下载Android 6.0的API才可以。

最后下载Extras目录下的Intel x86 Emulator Accelerator(Haxm Installer)，模拟器加速器

下载之后需要自己去安装，例如：

D:\android-sdk\sdk\extras\intel\Hardware_Accelerated_Execution_Manager

目录下，双击intelhaxm-android.exe进行默认安装即可。

2.1.3配置环境变量

首选确保Android SDK中的相关组件都已经下载完毕。

鼠标选中我的电脑右键，点击属性--->高级系统配置--->高级--->环境变量。

点击环境变量，系统变量里：

1、点击新建，变量名填写 ANDROID_HOME

变量值填写 D:\android-sdk\sdk

2、修改Path，点击编辑，在变量值最后添加

;%ANDROID_HOME%\tools;%ANDROID_HOME%\platform-tools

确定后，打开命令行，输入adb，提示以下信息表示Android SDK环境变量配置成功。

2.2Android SDK for Mac

2.2.1安装

在Mac环境下安装Android SDK，将android-sdk-macosx.zip解压后放到自己指定的目录即可。例如：解压到/Users/automation目录下。

2.2.2组件

进入Android SDK目录的tools文件夹下，例如：/Users/automation/android-sdk-macosx/tools

双击该目录下的android程序，之后会打开一个终端窗口并启动Android SDK Manager。

之后安装Tools、Platform-tools、Build-tools、API等相关组件。

在安装API时根据要测试的模拟器或真机的Android版本而定，例如：使用的真机是Android 6.0版本，则Android SDK要下载Android 6.0的API才可以。

最后下载Extras目录下的Intel x86 Emulator Accelerator(Haxm Installer)，模拟器加速器

下载之后需要自己去安装，例如：

/Users/automation/android-sdk-macosx/extras/intel/Hardware_Accelerated_Execution_Manager目录下，双击IntelHAXM_6.2.1.dmg进行默认安装即可。

2.2.3配置环境变量

1、首选确保Android SDK中的相关组件都已经下载完毕，之后打开终端，进入用户的根目录。

2、在终端输入命令 ls –a ，查询 .bash_profile文件是否存在。如果不存在，创建文件：touch .bash_profile

3、编辑文件 vi ~/.bash_profile，输入内容如下：

直接进行追加：

export ANDROID_HOME=/Users/automation/android-sdk-macosx

在PATH变量后继续追加：

:ANDROID_HOME/tools:ANDROID_HOME/platform-tools

完整的.bash_profile内容（包含了JAVA、Android的环境变量配置）：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_144.jdk/Contents/Home

export ANDROID_HOME=/Users/automation/android-sdk-macosx

export PATH=PATH:JAVA_HOME/bin:ANDROID_HOME/tools:ANDROID_HOME/platform-tools

4、编辑后保存文件，之后输入source ~/.bash_profile，使环境变量生效。

5、在终端输入adb，提示以下信息表示Android SDK环境变量配置成功。

第3章 Node.js

Node.js就是运行在服务端的JavaScript，是一个基于Chrome JavaScript运行时建立的一个平台。Node.js是一个事件驱动I/O服务端JavaScript环境，基于Google的V8引擎，V8引擎执行JavaScript的速度非常快，性能非常好。

官方网址：https://nodejs.org/en/

npm是随同Node.js一起安装的包管理工具，能解决Node.js代码部署上的很多问题，常见的使用场景有以下几种：

1、允许用户从npm服务器下载别人编写的第三方包到本地使用。

2、允许用户从npm服务器下载并安装别人编写的命令行程序到本地使用。

3、允许用户将自己编写的包或命令行程序上传到npm服务器供别人使用。

3.1Node.js for Win

在Windows环境下安装Node.js，双击执行node-v6.11.0-x64.msi应用程序默认安装即可。

安装完成后，环境变量自动添加到系统里，直接打开命令行，输入node -v，提示以下信息表示Node.js安装成功。

由于新版的Node.js已经集成了npm，同样在命令行输入 npm -v， 来测试是否安装成功。

3.2Node.js for Mac

在Mac环境下安装Node.js，执行node-v6.11.3.pkg默认安装即可。

安装完成后，环境变量自动添加到系统里，直接打开终端输入node -v，提示以下信息表示Node.js安装成功。

由于新版的Node.js已经集成了npm，同样在终端输入 npm -v， 来测试是否安装成功。

第4章 Appium

本章节讲解的Appium是服务端，包括：Appium Server和Appium Desktop。

Appium Server是在命令行或终端以命令安装，安装完成后直接输入命令来启动Appium服务。

Appium Desktop是一个应用程序，安装完成后直接运行即可，执行后是有图形界面的Appium服务，与Appium Server功能是一致的，但它附带了一个检查器，用来调试定位应用程序很方便。

所以Appium服务端，可以只安装Appium Server或Appium Desktop或者两个都可以安装。

Appium Desktop官方下载地址：https://github.com/appium/appium-desktop/releases/

4.1Appium for Win

4.1.1Appium Server

在Windows环境下，由于Node.js已经安装完成，直接打开命令行输入命令进行安装（由于国内网络问题，安装过程中可能需要FANQIANG）。

默认安装（安装最新版本Appium Server）

npm install -g appium

默认安装（安装最新版本Appium Server，使用淘宝NPM镜像，不需要FANQIANG）

npm install -g appium --registry=https://registry.npm.taobao.org

安装指定版本（有时Appium Server当前版本可能是有问题的，需要指定版本来安装）

例如安装1.6.5版本

npm install -g appium@1.6.5

查看Appium Server所有的版本号

npm view appium versions #

安装完成后，Windows下默认安装路径，例如：

C:\Users\Administrator\AppData\Roaming\npm\node_modules\

打开命令行，输入appium，提示以下信息表示Appium Server安装成功且Appium服务已经开启。

如果命令行安装Appium失败或者不完整，可以拷贝已有命令行安装过的完整包覆盖到此Windows下Appium默认安装路径位置也是可以的。

例如：命令行安装后的Appium-v1.6.5包.zip进行解压，将解压后的appium文件拷贝覆盖到C:\Users\Administrator\AppData\Roaming\npm\node_modules目录下的appium文件。

4.1.2Appium Desktop

在Windows环境下安装Appium Desktop，执行appium-desktop-Setup-1.2.1.exe默认安装即可。

安装完成后，Windows下默认安装路径，例如：

C:\Users\Administrator\AppData\Local\Programs\appium-desktop

安装完成后，自动在桌面添加应用程序的快捷方式，直接执行Appium来启动Appium Desktop。

点击Start Server v1.6.5来开启Appium服务，如下图服务开启成功。

4.2Appium for Mac

4.2.1Appium Server

在Mac环境下，由于Node.js已经安装完成，直接打开终端输入命令进行安装（由于国内网络问题，安装过程中可能需要FANQIANG）。

默认安装（安装最新版本Appium Server）

npm install -g appium

默认安装（安装最新版本Appium Server，使用淘宝NPM镜像，不需要FANQIANG）

npm install -g appium --registry=https://registry.npm.taobao.org

安装指定版本（有时Appium Server当前版本可能是有问题的，需要指定版本来安装）

例如安装1.6.5版本

npm install -g appium@1.6.5

查看Appium Server所有的版本号

npm view appium versions #

注1：在Mac环境下安装可能会有权限的限制，导致无法安装，可以在命令前加sudo

例如：sudo npm install -g appium

注2：有时候Appium无法安装上，即使加sudo也无法安装上，例如：

输入npm install -g appium，无法安装上。

输入sudo npm install -g appium，也无法安装上。

解决方法：

　　1、卸载Appium和Node.js（pkg/dmg安装方式无需卸载）。

　　2、打开终端输入sudo chmod -R 777 /usr/local

　　3、重新安装Appium（例如：输入npm install -g appium）

安装完成后，Mac下默认安装路径，例如：

/usr/local/lib/node_modules/

打开终端，输入appium，提示以下信息表示Appium Server安装成功且Appium服务已经开启。

如果命令行安装Appium失败或者不完整，可以拷贝已有命令行安装过的完整包覆盖到此Mac下Appium默认安装路径位置也是可以的。

例如：命令行安装后的Appium-v1.6.5包.zip进行解压，将解压后的appium文件拷贝覆盖到/usr/local/lib/node_modules/目录下的appium文件。

4.2.2Appium Desktop

在Mac环境下安装Appium Desktop，执行appium-desktop-1.2.1.dmg默认安装即可。

安装完成后，Mac下默认安装路径，例如：

/Applications

在应用程序里，直接执行Appium.app来启动Appium Desktop。

点击Start Server v1.6.5来开启Appium服务，如下图服务开启成功。

第5章 Appium Clients

Appium Clients为Appium的客户端，支持Java、Ruby、Python、PHP、JavaScript和C#。

本书是Java版，所以需要下载jar包的。下载java-client-x-x-x.jar包即可。

各版本下载地址：

https://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22io.appium%22%20AND%20a%3A%22java-client%22

本书Appium会用到java-client-4.1.2.jar或java-client-6.1.0.jar。

将下载的jar包引用到项目里就可以使用Appium了。

第6章 Appium Doctor

Appium Doctor是一个用于验证Appium安装环境的工具，可以诊断出Node.js、Android、IOS环境配置方面的常见问题。

6.1Appium Doctor for Win

在Windows环境下，直接打开命令行输入命令进行安装

npm install -g appium-doctor

安装完成后，在命令行执行appium-doctor，会检测Appium的基础环境是否正确，如提示以下信息，证明环境没有问题。

6.2Appium Doctor for Mac

在Mac环境下，直接打开终端输入命令进行安装

npm install -g appium-doctor

安装完成后，在终端执行appium-doctor --android，会检测Appium的Android基础环境是否正确，如提示以下信息，证明环境没有问题。

在终端执行appium-doctor，会检测Appium的Android与IOS基础环境是否正确，如提示以下信息，证明环境没有问题。

第7章 模拟器/真机

自动化测试执行的时候是需要在移动设备上的，此时就需要准备模拟器或者是真机。

7.1模拟器

当前市面上Android版本的模拟器还是挺多的，本书介绍三款Android模拟器。

分别是：Android Virtual Devices、Genymotion、逍遥模拟器

Android Virtual Devices是Android SDK自带的模拟器，根据Android SDK不同平台版本，可在Windows或Mac等上进行创建与使用模拟器。

Genymotion是一款比较出名的模拟器，一般使用Android模拟器的话都会使用它，运行速度快，也是根据不同平台版本，也可在Windows或Mac等上创建与使用模拟器。

官方下载地址：https://www.genymotion.com/download/

逍遥模拟器只有Windows版本，但有时候为什么不用Genymotion或Android Virtual Devices模拟器，非要用逍遥模拟器呢？是因为有些App程序无法安装上Genymotion或Android Virtual Devices的，即使安装成功也无法运行（比如微信、微博），但又不想使用真机，这时候可以试试逍遥模拟器，启动速度很快，App程序都可以安装成功与运行。

7.1.1模拟器 for Win

7.1.1.1Android Virtual Devices

Android SDK是自带模拟器的，为Android Virtual Devices（AVD）。

Android SDK之前我们已经搭建部署好了，此时只需要创建模拟器即可。

1、进入Android SDK目录，打开SDK Manager.exe。

2、点击Tools--->Manage AVDs…，进入Android虚拟设备管理。

3、点击Create…，创建Android虚拟设备。

4、之后填写虚拟设备的配置信息。如图所示，虚拟Android 6.0，则Android SDK必须下载此6.0的API，否则选不上此版本。

5、配置完成后，选中此虚拟设备，点击Start…。

6、点击Launch，进行启动。

7、如图所示，模拟器已经启动完成。

7.1.1.2Genymotion

在Windows环境下安装Genymotion，执行genymotion-2.10.0-vbox.exe默认安装即可。

注意：安装Genymotion是需要先安装VirtualBox的，此安装程序已经包含VirtualBox，所以不需要另外安装VirtualBox。

安装完成后，点击桌面上的快捷方式打开Genymotion。

点击Settings--->Account，进行账户登录。

配置ADB的路径，如图所示：

添加虚拟设备，点击Add。

选择Android版本、设备后，进行下载。

虚拟设备下载成功后，点击Start进行启动模拟器。

模拟器启动成功。

之后在模拟器上安装Genymotion-ARM-Translation

Genymotion-ARM-Translation是能让Genymotion运行在ARM架构程序的兼容包，原生的Genymotion模拟器只支持X86架构，很多使用了.so文件的应用不支持X86架构，因此无法运行。如果想要运行，必须安装ARM转换包。

Genymotion-ARM-Translation虚拟机支持文件，能够完美仿真ARM APP，在安卓上能够模拟使用，正常运行APP程序，运行速度明显快于SDK自带的模拟器，需要注意的是，虚拟机的安卓版本必须是4.4以上才行。

安装方法：

在Genymotion里面建立Android模拟器。

开机后把Genymotion-ARM-Translation_v2.0.zip（请勿解压）拖到模拟器中，确认后自动安装。

安装完成后重启模拟器。

7.1.1.3逍遥模拟器

在Windows环境下安装逍遥模拟器，执行XYAZ-Setup.exe默认安装即可。

例如：安装到D:\Microvirt\MEmu

配置环境变量：

鼠标选中我的电脑右键，点击属性--->高级系统配置--->高级--->环境变量。

点击环境变量，系统变量里：

修改Path，点击编辑，在变量值最后添加 ;D:\Microvirt\MEmu

连接逍遥模拟器，21503为逍遥模拟器的默认端口号：

1、打开命令行，进入安装目录下的D:\Microvirt\MEmu目录。

2、执行连接命令adb connect 127.0.0.1:21503

3、执行查看所有模拟器命令adb devices

如图所示：已经连上模拟器。

其他命令：

删除数据adb -s 127.0.0.1:21503 shell pm clear 删除的package包名

安装软件包adb -s 127.0.0.1:21503 install 你的APK文件

可否直接在命令行执行adb devices操作，而不用先连接逍遥模拟器？

是可以的，因为已经安装过Android SDK了，目录D:\android-sdk\sdk\platform-tools存在adb.exe，但逍遥模拟器目录D:\Microvirt\MEmu里也有adb.exe，并且都配置了环境变量，存在adb版本不一致。将Android SDK目录下的adb.exe文件直接覆盖掉逍遥模拟器目录下adb.exe文件即可。

之后打开命令行，直接输入adb devices

如图所示：模拟器已经连上了。

已安装的逍遥模拟器Android版本号为4.4.4，有些旧，将逍遥模拟器MEmu安卓5.1.1镜像.rar文件解压后得到的MEmu51.ova文件拷贝到D:\Microvirt\MEmu目录里。

打开逍遥安卓多开管理器。

点击导入模拟器，选择MEmu51.ova文件进行导入，之后点击启动，Android版本5.1.1模拟器即可用。

7.1.2模拟器 for Mac

7.1.2.1Android Virtual Devices

Android SDK是自带模拟器的，为Android Virtual Devices（AVD）。

Android SDK之前我们已经搭建部署好了，此时只需要创建模拟器即可。

1、进入Android SDK目录，点击android，打开SDK Manager.exe。

2、点击Tools--->Manage AVDs…，进入Android虚拟设备管理。

3、点击Create…，创建Android虚拟设备。

4、之后填写虚拟设备的配置信息。如图所示，虚拟Android 6.0，则Android SDK必须下载此6.0的API，否则选不上此版本。

5、配置完成后，选中此虚拟设备，点击Start…。

6、点击Launch，进行启动。

7、如图所示，模拟器已经启动完成。

7.1.2.2Genymotion

在Mac环境下安装Genymotion，需先安装VirtualBox。

官方下载地址：https://www.virtualbox.org/wiki/Downloads

例如：VirtualBox-5.1.28-117968-OSX.dmg，默认安装即可。

之后执行genymotion-2.10.0.dmg默认安装即可。

安装完成后，点击应用程序里的Genymotion.app快捷方式打开Genymotion。

点击Settings--->Account，进行账户登录。

配置ADB的路径，如图所示：

添加虚拟设备，点击Add。

选择Android版本、设备后，进行下载。

虚拟设备下载成功后，点击Start进行启动模拟器。

模拟器启动成功。

之后在模拟器上安装Genymotion-ARM-Translation

Genymotion-ARM-Translation是能让Genymotion运行在ARM架构程序的兼容包，原生的Genymotion模拟器只支持X86架构，很多使用了.so文件的应用不支持X86架构，因此无法运行。如果想要运行，必须安装ARM转换包。

Genymotion-ARM-Translation虚拟机支持文件，能够完美仿真ARM APP，在安卓上能够模拟使用，正常运行APP程序，运行速度明显快于SDK自带的模拟器，需要注意的是，虚拟机的安卓版本必须是4.4以上才行。

安装方法：

在Genymotion里面建立Android模拟器。

开机后把Genymotion-ARM-Translation_v2.0.zip（请勿解压）拖到模拟器中，确认后自动安装。

安装完成后重启模拟器。

7.2真机

准备系统为Android版本的手机，注意：Android SDK下载的API要与手机的Android版本号对应，如果没有就下载对应版本号的API。

例如：使用的真机是Android 6.0版本，则Android SDK要下载Android 6.0的API才可以。

第8章 Selenium jar

除了使用Appium Clients 的jar包，还要使用Selenium的jar包，比如在测试脚本里使用DesiredCapabilities就需要用到这个包。下载selenium-server-standalone-x-x-x.jar包即可。

下载地址：http://selenium-release.storage.googleapis.com/index.html

根据不同的版本进行下载。

本书Appium章节会用到selenium-server-standalone-2.53.1.jar或selenium-server-standalone-3.12.0.jar。

将下载的jar包引用到项目里就可以使用了。

注意（Appium Clients要与Selenium版本匹配，否则执行脚本会报错）：

Appium Clients使用java-client-4.1.2.jar包，则Selenium使用selenium-server-standalone-2.53.1.jar包。

Appium Clients使用java-client-6.1.0.jar包，则Selenium使用selenium-server-standalone-3.12.0.jar包。

第9章 Eclipse

Eclipse是一个开放源代码的、基于Java的可扩展开发平台。就其本身而言，它只是一个框架和一组服务，用于通过插件组件构建开发环境。Eclipse附带了一个标准的插件集，包括Java开发工具（Java Development Kit，JDK）。

官方下载地址：https://www.eclipse.org/downloads/

9.1Eclipse for Win

在Windows环境下安装Eclipse，解压eclipse-jee-neon-2.rar文件（此Eclipse版本已经集成了TestNG、SVN、ADT等插件），例如解压到D盘，进入文件目录双击eclipse.exe，即可运行Eclipse程序。

9.2Eclipse for Mac

在Mac环境下安装Eclipse，执行eclipse-jee-oxygen-R-macosx-cocoa-x86_64.dmg默认安装即可。安装完成后，进入应用程序，执行Eclipse.app，即可运行Eclipse程序。