什么是Cordova
Cordova前身是PhoneGap,而PhoneGap是Nitobi软件公司2008年推出的一个框架,旨在弥补web和iOS之间的不足,使得web
和iPhone SDK
之间的交互更容易,后来又陆续加入了更多的平台。
- Cordova提供了一组设备相关的API,通过这组API,移动应用能够以JavaScript访问原生的设备功能,如摄像头、麦克风等。
- Cordova还提供了一组统一的JavaScript类库,以及为这些类库所用的设备相关的原生后台代码。
- Cordova支持如下移动操作系统:iOS, Android,ubuntu phone os, Blackberry, Windows Phone, Palm WebOS, Bada 和 Symbian。
安装Cordova
- 下载和安装Node.js,安装成功后在命令行使用
$ node -v
$ npm -v
- 查看是否安装成功,
npm
是node.js
的包管理器(Package manager)。 - 下载和安装Git,安装成功后,你可以在命令行使用
git
,在自定义导入插件时使用。 - 安装
cordova
使用node.js
的npm
工具。cordova
模板会被自动下载
- 在Mac或Linux中,使用终端,安装
cordova
$ sudo npm install -g cordova
- 在Windows中,使用
cmd
命令行全局安装cordova
:
C:\>npm install -g cordova
创建App
打开命令或终端
$ cordova create hello com.hello.demo HelloWorld
这将会为你的cordova
应用创造必须的目录。默认情况下,cordova create
命令生成基于web的应用程序的骨骼,项目的主页是 www/index.html
文件。
项目结构介绍
hello/
| -- hooks/
| -- node_modules/
| -- platforms/
| | | -- android/
| | | -- ios/
| -- plugins
| -- res
| -- www
| -- config.xml
| -- package.json
- hooks 包含自定CLI命令的脚本,用于集成自己的版本控制系统或构建系统。
- node_modules 文件夹是项目npm中所依赖的文件
- platforms 添加平台后的目录文件
- plugins 项目包含插件目录
- res 资源文件目录
- www 存放web项目的目录
- config.xml 项目配置文件
- package.json npm依赖项目配置
注意:
www目录下内容,在项目编译时,将把此文件下文件复制至/platforms/android/app/src/main/assets/
下
node_moduses文件出错,可删除文件夹,检查package.json
,使用命令$ npm install
重新添加
添加平台
所有后续命令都需要在项目或项目目录中进行
$ cd hello
进入hello
目录,根据需要添加ios
和android
平台,并确保他们保存在config.xml
中。
$ cordova platform add android --save
$ cordova platform add ios --svae
删除已添加平台
$ cordova platform remove android
检查当前平台设置状态
$ cordova platform ls
运行add
或remove
平台的命令将会影响项目platform
的内容,在这个平台中,每个平台都有一个子目录。
注意:在使用CLI创建应用的时候,不要修改
/platform/
目录中的任何文件,当准备构建应用和安装插件时这个目录会被重写。
编译安装
要构建和运行App,需要安装每个你所需要的平台。
检查是否满足构建标准
$ cordova requirements
Requirements check results for android:
Java JDK: installed .
Android SDK: installed
Android target: installed android-19,android-21,android-22,android-23,Google Inc.:Google APIs:19,Google Inc.:Google APIs (x86 System Image):19,Google Inc.:Google APIs:23
Gradle: installed
Requirements check results for ios:
Apple OS X: not installed
Cordova tooling for iOS requires Apple OS X
Error: Some of requirements check failed
系楼主android
开发,所以只配置了 JDK SDK Gradle
环境变量,具体配置及安装百度。
构建App
默认情况下,cordova create
创建基于web
应用程序的结构,项目开始界面位于www/index.html
文件。任何初始化任务应该放在www/js/index.js
文件的deviceready
事件的处理函数中。
运行以下命令为所有添加的平台构建
$ cordova build
如果需要单独为某个平台构建
$ cordova build android
$ cordova build ios
测试App
以下命令使用SDK默认模拟器打开
$ cordova emulate android
或者,插入你的android
手机,在手机上直接测试App
$ cordova run android
注意,在运行App时,可能会出现长时间编译不动,或者构建出错,是因为gradle被墙,项目依赖等文件无法下载导致的问题,可使用国内阿里云镜像。
具体使用过程,打开目录的/platforms/android/build.gradle
文件 和 /platforms/android/app/build.gradle
文件中添加。
repositories {
maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }
jcenter()
mavenCentral()
}
添加插件
如果App要接触设备级别的特性,就需要添加插件了,你可以在插件搜索页去查找自己所需的插件。
- 例:添加相机插件
cordova plugin add cordova-plugin-camera
插件也可以通过目录
和git
地址去添加
通过plugin ls
或者 plugin list
可查看项目所有已添加的插件
$ cordova plugin ls
cordova-plugin-camera 4.0.3 "Camera"
cordova-plugin-whitelist 1.3.3 "Whitelist"
更新Cordova和项目
在安装cordova工具之后,可运行一下命令更新到最新版本
$ sudo npm update -g cordova
用下面语法安装指定版本:
$ sudo npm install -g cordova@3.1.0-0.2.0
运行cordova -v查看当前版本。要查找最新的cordova版本,可以运行:
$ npm info cordova version
更新完cordova后,更新目标项目的平台:
$ cordova platform update android --save
$ cordova platform update ios --save
...etc.
网友评论