需工具+環境準備說明

基于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發送到手機，安裝并使用。