官网文档:
http://docs.phonegap.com/en/edge/guide_overview_index.md.html
http://cordova.apache.org/
http://cordova.apache.org/docs/en/3.4.0/guide_overview_index.md.html#Overview
中文文档:http://www.phonegapcn.com/
各系统对插件功能支持情况:http://cordova.apache.org/docs/en/5.0.0/guide_support_index.md.html#Platform%20Support
Cross-platform (CLI) workflow
CLI (described in The Command-Line Interface)
一、基本操作
安装cordova: npm install -g cordova
创建APP: $ cordova create hello com.example.hello HelloWorld
hello指所创建的APP目录名称
com.example.hello指域名标识,可能过config.xml修改
HelloWorld指APP名称,可能过config.xml修改
添加支持平台(需进入当前APP所在目录):
$ cordova platform add ios
$ cordova platform add amazon-fireos
$ cordova platform add android
$ cordova platform add blackberry10
$ cordova platform add firefoxos
$ cordova platform add wp8
$ cordova platform add windows
$ cordova platform add amazon-fireos
$ cordova platform add android
$ cordova platform add blackberry10
$ cordova platform add firefoxos
查看当前支持的平台: $ cordova platforms ls
删除支持的平台:
$ cordova platform remove blackberry10
$ cordova platform rm amazon-fireos
$ cordova platform rm android
构建APP: $ cordova build
构建指定平台APP: $ cordova build ios
运行prepare后可修改指定平台下cordova生成的代码,再通过compile打包
$ cordova prepare ios
$ cordova compile ios</body>
在模拟器中查看APP: $ cordova emulate android
手机连接到电脑运行APP: $ cordova run android
二、cordova插件:
http://plugins.cordova.io/#/
查找插件: $ cordova plugin search bar code
添加插件:
设备API:Basic device information (Device API):
$ cordova plugin add cordova-plugin-device
网络连接、电池管理:Network Connection and Battery Events:
$ cordova plugin add cordova-plugin-network-information
$ cordova plugin add cordova-plugin-battery-status
加速度传感器,指南针,地理位置:Accelerometer, Compass, and Geolocation:
$ cordova plugin add cordova-plugin-device-motion
$ cordova plugin add cordova-plugin-device-orientation
$ cordova plugin add cordova-plugin-geolocation
相机、媒体播放和捕获:Camera, Media playback and Capture:
$ cordova plugin add cordova-plugin-camera
$ cordova plugin add cordova-plugin-media-capture
$ cordova plugin add cordova-plugin-media
文件访问API:Access files on device or network (File API):
$ cordova plugin add cordova-plugin-file
$ cordova plugin add cordova-plugin-file-transfer
弹窗(对话框或振动):Notification via dialog box or vibration:
$ cordova plugin add cordova-plugin-dialogs
$ cordova plugin add cordova-plugin-vibration
Contacts:
$ cordova plugin add cordova-plugin-contacts
Globalization:
$ cordova plugin add cordova-plugin-globalization
Splashscreen:
$ cordova plugin add cordova-plugin-splashscreen
在浏览器中打开:Open new browser windows (InAppBrowser):
$ cordova plugin add cordova-plugin-inappbrowser
调试控制台:Debug console:
$ cordova plugin add cordova-plugin-console
查看已添加插件: $ cordova plugin ls
删除插件:
$ cordova plugin rm cordova-plugin-console
$ cordova plugin remove cordova-plugin-console
批量添加或删除插件(以空格分隔):$ cordova plugin add cordova-plugin-console cordova-plugin-device
添加指定版本号插件:
$ cordova plugin add cordova-plugin-console@latest
$ cordova plugin add
[email protected]
添加在registry.cordova.io之外的代码仓库的插件:
$ cordova plugin add https://github.com/apache/cordova-plugin-console.git
指定版本号: $ cordova plugin add https://github.com/apache/cordova-plugin-console.git#r0.2.0
指定添加到本地的目录:
$ cordova plugin add https://github.com/someone/aplugin.git#:/my/sub/dir
$ cordova plugin add https://github.com/someone/aplugin.git#r0.0.1:/my/sub/dir
指定本地插件目录:
$ cordova plugin add ../my_plugin_dir
三、各平台差异化设置
在根目录下新建merges目录,允许不同平台子目录的合并与替换
目录规则举例:merges/android/www/css/index.css
例如:针对android设置个性化样式,在index.html上添加<link rel="stylesheet" type="text/css" href="css/overrides.css" />,在www目录下新建一个空文件css/overrides.css(防止文件找不到报错),建立merges/android/www/css/overrides.css放置针对android的样式。
四、帮助
$ cordova help
$ cordova
显示指定命令的帮助细节:$ cordova run --help
$ cordova info
显示当前安装的版本,config.xml,插件信息,支持的平台,可用模拟器版本等
五、cordova版本更新
cordova版本更新:
显示cordova插件各版本更新细节:
$ npm info cordova
更新平台信息:
$ cordova platform update android
$ cordova platform update ios
从旧版本迁移到新版本:
1、安装新版本后新建cordova项目,添加支持平台
2、把旧项目的www目录拷贝到新项目
3、旧项目的配置信息在新项目config.xml重新设置
4、在新项目添加所需的插件