環境: css
WIN系統,JDK,Android,Eclipse,Ant,Git,PhoneGap3.x (Cordova) html
1. 安裝JRE,設置JAVA_HOME,好比JAVA_HOME=C:\program\Java\jre6\bin。 java
2. Cordova支持Android 2.2, 2.3, and 4.x. node
下載安裝SDK: http://developer.android.com/sdk/index.html android
安裝Android SDK,好比安裝在c:\android-sdk\,須要把c:\android-sdk\tools和platform-tools添加到系統PATH環境變量中。 ios
要不出後面第8步出錯誤: git
[Error: The command `android` failed. Make sure you have the latest Android SDK github
installed, and the `android` command (inside the tools/ folder) added to your pa apache
th. Output: 'android' ... ... npm
]
3. 安裝Eclipse,要能支持Android項目。http://www.eclipse.org/downloads/
4. 安裝ant,並將ant.bat所在目錄加到path環境變量,如c:\apache-ant\bin\,http://ant.apache.org .
5. 安裝Node.js,安裝成功後,可在命令行輸入命令:node 或 npm . http://nodejs.org/ 。
(注:如下全部命令都在nodejs命令行窗口中輸入的)
6. 安裝PhoneGap工具集: 打開命令行,運行:npm install -g phonegap
7. 把盤符轉到想要建立項目的目錄,好比 c:\。
8. 建立App,運行:phonegap create hello com.vmeitime.hello HelloWorld
將在c:\hello下建立名爲HelloWorld的項目,HTML5文件在C:\hello\www目錄裏。
第一個參數hello表示項目文件夾名,在此文件夾下會生成www子目錄做爲主頁面存入目錄,包括有css,js和img資源。 其中config.xml包括了重要的資源描述和項目配置信息.
第2個參數是可選的,com.vmeitime.hello表示項目包名; 第3個參數:HelloWord表示顯示的文本;
也可用-i 和-n 命令選項:
c:\> phonegap create hello -n HelloWorld -i com.vmeitime.hello
c:\> phonegap create hello --name HelloWorld --id com.vmeitime.hello
固然,命令執行後,以上信息也可在後續開發中修改comfig.xml中的相應值。
9. 後續操做都要在建立的項目目錄下進行:cd hello
10. 運行build命令,輸入不一樣平臺標識,生成不一樣平臺下的相應文件。以下以android設備爲例:
c:\hello> phonegap build android
要查看詳細(verbose)執行過程,可增長命令參數-V :
c:\hello> phonegap -V build android
以後能夠看到C:\hello\platforms\android裏出現Android項目。
11. 在模塊器或移動設備上測試App: c:\hello>phonegap install android
也可用參數e專門指定運行在模塊器上: c:\hello>phonegap -e install android
12. build和運行(至關於上面build和install兩步驟操做):c:\hello>phonegap run android
也可用參數e專門指定運行在模塊器上:c:\hello>phonegap -e run android
13. 打開Eclispe,導入項目C:\hello\platforms\android,HelloWorld。
14. 可能項目有一些錯誤,把Android Project Build Target設置爲最高等級的API Level通常就能解決。
15. 而後就能夠用Eclipse啓動項目了。
16. 能夠用命令phonegap emulate android在模擬器裏啓動項目,不過感受比Eclipse麻煩,老是啓動一個新的模擬器。
用這個方法還要注意Android虛擬設備的版本,彷佛至少是API Level 10,由於自動生成的AndroidManifest.xml裏:
<uses-sdk android:minSdkVersion="10" android:targetSdkVersion="17" />
17. 能夠用命令phonegap run android在真實設備上運行App。
18. 添加插件(須要先安裝git工具 https://help.github.com/articles/set-up-git):
PhoneGap 3.0 最須要關注的是徹底的插件體系結構,全部的功能特性包括攝像頭等都是使用插件方式提供。也就是說新建項目後不少功能是沒法使用的,你必須將其對應的插件添加到項目中。
例如在 cordova 中添加插件的方法是:
cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-camera.git
而經過 phonegap 命令行工具的方法是:
phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-camera.git
這意味着在開始 PhoneGap 項目時你要先考慮項目須要什麼功能,而後經過命令行來添加這些功能。
1). 添加的插件都將放在C:\hello\plugins目錄下.
2). 同時會在全部平臺下的config.xml文件中增長feature插件配置,如:C:\hello\platforms\<平臺>\res\xml\config.xml)
3). 增長相應的插件java文件:C:\hello\platforms\android\src
4). 增長相應的插件js文件:C:\hello\platforms\android\assets\www\plugins
下面是完整的插件列表,我直接拷貝過來,可能會有變化:
Basic device information (Device API):
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device.git
Network Connection and Battery Events:
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-battery-status.git
Accelerometer, Compass, and Geolocation:
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion.git
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-orientation.git
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
Camera, Media playback and Capture:
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-camera.git
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media-capture.git
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-media.git
Access files on device or network (File API):
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-file.git
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-file-transfer.git
Notification via dialog box or vibration:
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-dialogs.git
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-vibration.git
Contacts:
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-contacts.git
Globalization:
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization.git
Splashscreen:
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-splashscreen.git
Open new browser windows (InAppBrowser):
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-inappbrowser.git
Debug console:
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-console.git
查看當前已安裝的插件: $ phonegap local plugin list
刪除指定的插件: $ phonegap local plugin remove org.apache.cordova.core.console
19 自定義各平臺資源(merges):
在www/merges/目錄下建立各平臺不一樣的資源文件,如css,js,圖片等,引用相應的文件路徑時,不須要寫各平臺路徑。如:
在www/index.html文件中添加自定義的css文件overrides.css以下:
<link rel="stylesheet" type="text/css" href="css/overrides.css" />
在www/merges/android/目錄下建立針對於android平臺的overrides.css,(若是是ios,由是www/merges/ios/overrides.css文件。)
overrides.css文件中添加以下內容,覆蓋www/css/index.css文件中默認的12px文字大小樣式:
body { font-size:14px; }
這樣,在android平臺下,顯示的文件是14px,其餘平臺下顯示的文字是12px;
也可添加各平臺自定義的圖片資源,如 merges/ios/img/back_button.png, 在www/index.html頁面引用的寫法是img/back_button.png.
20. 遠程編譯:
默認狀況下,是編譯本地安裝SDK環境的相應平臺,生成目標在platforms。 但也可經過遠程編譯本地沒有安裝SDK(或已安裝SDK)的相應平臺。也可遠程測試。
1). 首先,你要在PhoneGap Build網站(https://build.phonegap.com/) 上註冊帳號,並使用login命令登陸操做。
$ phonegap remote login -u iamreallyadog@gmail.com -p mYpASSw0RD
$ phonegap remote login --username iamreallyadog@gmail.com --password mYpASSw0RD
使用loginout命令退出登陸phonegap build.
$ phonegap remote logout
2). 遠程編譯:$ phonegap remote build ios
3). 要使用插件,你必須先添加插件到本地,而後再遠程編譯。如:
$ phonegap local plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git
$ phonegap remote build ios
4) $ phonegap remote install ios
# ...or...
$ phonegap remote run ios
5) 默認狀況下是local本地編譯,以下兩命令是同樣效果:
$ phonegap local build ios
$ phonegap build ios
21. 更新phonegap到最新版本命令:c:\> npm update -g phonegap
22. 查看phonegap版本命令:
$ phonegap version
$ phonegap -v
23. 查看phonegap詳細信息命令:
$ npm info phonegap
24。安裝指定版本的phonegap命令:
c:\> npm install -g phonegap@2.9.0-rc1-0.12.2
參考:
http://www.cocoachina.com/applenews/devnews/2013/0724/6665.html
http://docs.phonegap.com/en/edge/guide_platforms_android_index.md.html#Android%20Platform%20Guide
http://docs.phonegap.com/en/3.0.0/guide_cli_index.md.html#The%20Command-line%20Interface