[Android] 安裝 PhoneGap 3.3 流程(及問題排除)

在 windows 7 使用 npm 安裝 PhoneGap 3.3 遇到的問題排除

/*2014.1.16 Maple*/

安裝環境:Windows 7 / NodeJs 0.10.11

本次安裝: PhoneGap 3.3 

------

之前有安裝 PhoneGap 成功過,但是採用的是非常麻煩的從 Eclipse 建立 Android 專案後開始丟檔案改設定

這次要再安裝時發現官網提供了 npm 的安裝方式,整個就是簡單許多!!!

官方建議的安裝方式為下

 

Install

C:\> npm install -g phonegap
            

 

Usage

$ phonegap create my-app
$ cd my-app
$ phonegap run android

 

看似很容易,但是我在執行 $ phonegap run android 卡關了兩次....所以做了整理

以下是安裝準備:

1. 安裝 JAVA 的 JDK

2. 安裝 NodeJs (會一併安裝 npm)

3. 安裝 Apache Ant

4. 安裝 android 的 SDK

    預設載點會把 eclipse 抓下來(檔案有點大),可以點下方的 "DOWNLOAD FOR OTHER PLATFORMS" 單獨選 SDK Tools

5. 安裝 PhoneGap,用命令提示字元 cmd  執行 (我習慣用系統管理者身分執行)

C:\> npm install -g phonegap
            

要是 NodeJs 有安裝完畢,npm 指令卻找不到,那就是安裝時沒選到自動修改環境變數的選項,可參照下面 6 的作法檢查使用者變數或系統變數的 path 中是否有 npm 的路徑及 node 的路徑

6. 設定環境變數

    在我的電腦上按右鍵 -> 內容 -> 系統進階系統設定 -> 進階 -> 環境變數

    在使用者變數的區塊,新增名稱 JAVA_HOME 值為 JAVA 安裝路徑 C:\Program Files\Java\jdk1.7.0_21

                                   新增名稱 ANT_HOME 值為 ANT 安裝路徑 C:\Program Files (x86)\apache-ant-1.9.3

                                   修改 Path 屬性的值 

                                   保留原本的值,在原本的後面加上;%JAVA_HOME%\bin\;%ANT_HOME%\bin\;SDK安裝目錄\tools\;SDK安裝目錄\platform-tools\

7. 設定完成後,命令提示字元要關掉重開才會生效

   在命令提示字元 cmd 執行以下指令,檢測以上安裝是否成功,若安裝成功會印出版本資訊,失敗則會顯示找不到指令

C:\> java -version
C:\> ant -version
C:\> adb version
C:\> emulator -version

8. 用 SDK tools 裡的 AVD Manager 建立 Android 模擬器,請記住新增時的 AVD Name (下面會用到)

9. 終於到最後一個步驟了,我比官網多了第三個指令,也就是用 cmd 的方式把模擬器打開 (請等模擬器開啟完畢再執行下一個指令)

$ phonegap create my-app com.test.packagename "MyAppName"
$ cd my-app
$ emulator.exe -avd "AVD的名稱"
$ phonegap run android

要是模擬器有開啟成功,但是命令提示字元好像停住了,請嘗試按一下 Enter 鍵

注意: AVD 的名稱不是用指令 adb devices 查到的名稱唷! 是新增時自己設定的名稱

10. 應該在模擬器中已可看到 PhoneGap 運行,app 名稱是 MyAppName,畫面則是 create 時預設產生的程式 :)

      若想要用 Eclipse 開啟專案請參考官方教學文件,裡面提到的 cordova 指令,可用 c:\> npm install cordova 安裝

-------

以下是執行 phonegap run android 時出現的問題排除

[error] An error occured during creation of android sub-project.

可能原因:未安裝 ANT、JAVA 等環境,或者環境變數設定不正確導致 cmd 找不到指令

參考文章 http://stackoverflow.com/questions/19159253/an-error-occurred-during-creation-of-android-sub-project-because-a-path-is-not-f

Error: An error occurred while emulating/deploying the android project.

原因:無法自動開啟模擬器

參考文章

http://askquestions.in/cordova-android-emulator-stopped-working

https://github.com/phonegap/phonegap-cli/issues/220

另外有一個爬文看到的問題,
若手動開啟模擬器時,出現無法開啟的問題,有可能檔案不在 C 槽,
正常模擬器的檔案會在 C:\Users\使用者名稱\.android\avd 中