需工具+环境准备说明

基于win10 64位系统

• JDK 1.8（64位）
• Android SDK
• Appium desktop
• 夜神模拟器

Step1：安装配置JDK

下载JDK

浏览器访问下面的地址（我们选择jdk1.8进行下载）

https://www.oracle.com/java/technologies/javase/javase8-archive-downloads.html

选择操作系统相应的版本，注意操作系统如果为32则选择i586，64位则选择x64，点击链接开始下载。

安装JDK

下载完成，双击安装包进行安装：

点击下一步，记录下jdk安装的路径，C:\Program Files\Java\jdk1.8.0_65，也可以更改安装目录到指定目录。

然后连续点击下一步：

点击关闭，JDK就已经安装完成了。

配置JDK环境变量

打开环境变量设置窗口：打开开始菜单→右键计算机→系统属性→高级系统设置→高级→环境变量。

新建 JAVA_HOME 变量

点击新建，在弹出框中变量值填写jdk安装的根目录（即上面记录下来的C:\Program Files\Java\jdk1.8.0_141)，如下图示：

在系统变量找到Path 变量，点击新建，增加两行配置%JAVA_HOME%\bin %JAVA_HOME%\jre\bin

打开Windows的cmd窗口，输入以下命令回车，得到如下提示表示JDK安装和配置没有问题。

Step2：安装配置Android SDK

下载Android SDK

默认官方网址由于不可描述的原因不能访问：

http://developer.android.com/sdk/index.html

所以给大家推荐国内下载SDK的网址：

http://www.android-studio.org/

要注意选择ADT进行下载，为什么要选择这个呢？因为选择SDK进行下载的话，它只包含有基本的SDK工具，后面还需要自己手动通过AVD manager来下载对应的软件包，所以建议初学者就下载ADT，这个已经包含android app自动化所需的相关SDK工具，不需要另外下载了，省事。

和你的操作系统对应选择对应的版本下载即可，下载完后解压得到对应的目录。

配置Android SDK环境变量

解压完成后进入到对应的adt-bundle-windows-x86_64-20140702\sdk\platform-tools目录，这个目录有存放appium自动化所需要的相关组件和工具，所以接下来我们需要来将这个目录配置到系统环境变量中，方便全局使用。

进入到系统环境变量设置中->新建ANDROID_HOME，变量值为你的SDK对应的目录，比如我的ADT软件包解压之后是在D盘，那么SDK对应的目录就是：D:\adt-bundle-windows-x86_64-20140702\sdk

接下来我们就需要把SDK对应的platform-tools目录以及tools配置到系统变量Path里面去：Path里面点击新建->增加%ANDROID_HOME%\platform-tools以及%ANDROID_HOME%\tools

系统的cmd窗口输入adb version来检测是否安装成功，如果有下面的信息显示成功的话，那么SDK配置就OK了。

Step3：安装Appium-desktop

有一点大家要注意，下载的时候Appium有两个不同的版本类型，Appium-desktop以及Appium-server，这两者有什么区别呢？

• Appium-server是最先出来的，他的下载地址：https://bitbucket.org/appium/appium.app/downloads/，但是很久没有更新了
• Appium-desktop是Appium的桌面版本，它封装了运行 Appium服务端的所有依赖，而且不需要担心怎样安装Node.js。所以强烈建议大家选择Appium-desktop进行安装，并且安装也非常的容易。

Appium-desktop是GitHub上面的开源项目，代码地址是：https://github.com/appium/appium-desktop

对应安装包下载地址：https://github.com/appium/appium-desktop/releases

进入到安装包的下载地址，下载Appium-desktop的对应版本安装包（这里建议不要用最新的，可能会存在一些BUG），这里以V1.14.0为例：展开Assets选项，选择windows平台的安装包

下载完一步步点击安装即可（Appium-desktop安装速度会比较的慢），最后安装完成会在桌面显示图标：

Step4：安装模拟器

可能部分童靴手上没有Android手机/平板电脑，我们可以选择在windows上安装模拟器（一个可以运行在自己电脑上的虚拟设备，不需要使用物理设备即可开发、调试android应用程序）。市面上有很多的模拟器，如：海马玩、夜神、BlueStacks、逍遥等，大家可以随意选择，以夜神模拟器为例：

官网：https://www.yeshen.com/

下载安装完直接打开会是平板电脑模式，调整为手机竖屏显示模式步骤为：夜神模拟器设置->性能设置->分辨率设置->选择手机版即可

至此，我们的环境就初步搭建成功了，接下来愉快的开始我们app自动化之旅吧。

发环境

1、Android Studio下载地址：https://developer.android.google.cn/studio/index.html

2、HBuilderX（开发工具，地址https://www.dcloud.io/hbuilderx.html）

3、App离线SDK下载：最新android平台SDK下载

（https://nativesupport.dcloud.net.cn/AppDocs/download/android）

注意：HBuilderX版本要跟SDK版本一致。

SDK目录说明

    |-- HBuilder-Hello                App离线打包演示应用
    |-- HBuilder-Integrate-AS         集成uni-app或5+ app的最简示例
    |-- SDK                           SDK库文件目录
    |-- Feature-Android.xls           Android平台各扩展Feature API对应的详细配置
    |-- readme                        版本说明文件及注意事项
    |-- UniPlugin-Hello-AS            uni原生插件开发示例

准备工程

1、安装android Studio并解压SDK下载包；

2、运行android studio，选择导入项目HBuilder-Hello；

3、导入项目后，按提示安装所需即可；安装完成后，项目会重新rebuild，等待结束，运行项目到测试机，可以看到传感器，音频，二维码等应用示例；

4、打开 HBuilderX 写好的项目，点击 发行 > 原生app-本地打包 > 生成本地打包资源，打包完成后，HBuilderX 控制台会输出打包信息和打包路径；

5、打开 android studio 切换项目到project目录，依次打开 HBuilder-Hello > app > src > main > assets，能看到 apps.HelloH5.www 和 data 两个文件夹；

6、删除 android studio 的 apps 文件夹内容后，将 HBuilderX 刚才打包路径下的 resources 文件夹内容替换；

7、复制 www > manifest.json 中的id，替换 data > dcloud_control.xml 中的 appid；

8、点击运行项目，如果运行后测试机所显示的内容和HBuilderX项目中所展示一致，则表示替换成功；

补充一些打包过程遇到问题的解决方法：

1）运行APP提示“当前运行环境无法运行启用“自定义组件模式”的uni-app引用”，只需要在“app-libs”引入文件“ uniapp-release.aar”（该文件在SDK下载包的路径“SDK\libs”下）即可解决）；

2）报错“Entry name 'assets/SDK_Default_Route_Texture_Gray_Arrow.png' collided”，删除文件“HBuilder-Hello\app\build”下的所有数据，重新生成就没问题；

3）uniApp引入“vconsole.min.js”会导致打包运行后，只显示底部菜单，内容区域显示空白；

4）工程增加package.json，并执行“npm install”后，打包App运行后会导致引用组件的页面无法跳转；

5）uniapp调用接口使用了Promise，打包App运行后会导致打开调用接口的页面一直加载中。

发布版本

1、android studio > build > Generate Signed Bundle / APK，创建新的 jks文件或选择原有jks，一路下一步，直至完成；

2、把文件app-debug.apk发送到手机，安装并使用。