创建你的第一个App
这个指南像你展示如何创建JS/HTMLCordova应用并发布他们到不同的原生移动平台通过使用cordova命令行接口(CLI)。Cordova命令行详细参考查看[CLI参考]。
安装Cordova CLI
Cordova命令行工具作为npm包分发。
安装cordova命令行工具，通过下面这些步骤:
下载和安装Node.js。安装完成后你可以在命令行中使用
node和npm。(可选)下载和安装git client, 如果你没有。安装成功后，你可以在命令行中使用
git。 这个命令行使用下载git仓库中的资源。安装
cordova模块使用Nodejs的npm工具。cordova模块会被npm工具自动下载。
在OS X和Linux上:
$ sudo npm install -g cordova在OS X和Linux上,
npm命令加上前缀sudo因为cordova可能需要安装在其他的受限制目录比如/usr/local/share。如果你使用可选工具nvm/nave或者具有安装目录的写权限，那么你可以省略sudo前缀。这里有更多提示 可用在使用npm没有sudo前缀时，如果你想那么做。在Windows上:
C:\>npm install -g cordova
-g标志是告诉 npm 我们全局安装 cordova。否则我们将会安装在当前工作目录的 node_modules子目录。
安装完成后，你应该能够在命令行中运行cordova命令，在没有任何参数的时候会打印一些帮助信息。
创建App
跳转到你维护源代码的目录中，并创建你的cordova项目：
$ cordova create hello com.example.hello HelloWorld
这将会为你的cordova应用创造必须的目录。默认情况下，cordova create命令生成基于web的应用程序的骨骼，项目的主页是 www/index.html 文件。
参看
- Cordova create 命令参考文档
- Cordova项目目录结构
添加平台
所有后续命令都需要在项目目录或者项目目录的任何子目录运行:
$ cd hello
给你的App添加目标平台。我们将会添加'ios'和'android'平台，并确保他们保存在了config.xml中:
$ cordova platform add ios --save
$ cordova platform add android --save
检查你当前平台设置状况:
$ cordova platform ls
运行add或者remove平台的命令将会影响项目 platforms的内容，在这个目录中每个指定平台都有一个子目录。
注意:在你使用CLI创建应用的时候， 不要 修改
/platforms/目录中的任何文件。当准备构建应用或者重新安装插件时这个目录通常会被重写。
参见
- Cordova平台命令参考文档
安装构建先决条件
要构建和运行App，你需要安装每个你需要平台的SDK。另外，当你使用浏览器开发你可以添加 browser平台，它不需要任何平台SDK。
检测你是否满足构建平台的要求:
$ 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平台的要求
- iOS平台的要求
- Windows平台的要求
构建App
默认情况下, cordova create生产基于web应用程序的骨架，项目开始页面位于www/index.html 文件。任何初始化任务应该在www/js/index.js文件中的deviceready事件的事件处理函数中。
运行下面命令为所有添加的平台构建:
$ cordova build
你可以在每次构建中选择限制平台范围 - 这个例子中是'ios':
$ cordova build ios
参见
- Cordova build 命令参考文档
测试App
移动平台的SDK通常会绑定模拟器，它是一个可执行的设备镜像，这样你就可以在主屏幕启动你的App，看看它在多个平台是如何交互的。 在命令行运行下面的命令，会重新构建App并可以在特定平台的模拟器上查看:
$ cordova emulate android
伴随着cordova emulate命令，它会刷新模拟器镜像，用来展示最新的应用程序，现在你可以在主屏幕启动它:
或者，你可以将你的手机插入电脑，在手机上直接测试App:
$ cordova run android
在运行命令之前，你需要设置用于测试的设备，以下是每个平台的流程。
参见
- 设置Android模拟器
- Cordova run 命令参考文档
- Cordova emulate 命令参考文档
添加插件
你可以修改默认生成的App通过标准的web技术，但是App要接触设备级别的特性，就需要你添加插件了。
一个插件 通过JavascriptAPI暴露原生SDK功能。插件通常由npm分发，你可以搜索他们在 插件搜索页。一些关键的API由Apache Cordova开源项目提供并且这些插件是作为[核心插件API]的。你也可以使用CLI启动搜索页:
$ cordova plugin search camera
plugin要添加camera插件，我们需要指定camera的npm包名:
$ cordova plugin add cordova-plugin-camera
Fetching plugin "cordova-plugin-camera@~2.1.0" via npm
Installing "cordova-plugin-camera" for android
Installing "cordova-plugin-camera" for ios
插件也可以通过目录或者git仓库添加。
注意:CLI增加了适合各个平台的插件代码。如果你想伴随着低级别壳工具和平台SDK开发你可以看概述中讨论的, 你需要运行Plugman工具去给每个平台单独添加。 (要知道更多信息, 请看 使用Plugman管理插件.)
使用 plugin ls (或者 plugin list, 或者 plugin自己)查看当前安装的插件。每个插件现实它的标识:
$ cordova plugin ls
cordova-plugin-camera 2.1.0 "Camera"
cordova-plugin-whitelist 1.2.1 "Whitelist"
参见
- Cordova plugin 命令参考文档
- Cordova plugin 搜索页
- [核心插件API]
使用 merges自定义每个平台
虽然Cordova允许你轻松的部署App在各个平台，但是有时我们需要在某些平台做一些自定义。在这种情况下， 你不要想去修改顶级platforms目录下的www目录，因为，通常会被顶级 www目录的跨平台源码替换。
取而代之，顶级merges目录提供了特定平台部署特定资源的地方。每个特定平台在merges中的子目录反映了www 源代码树中的结构， 允许你重写和添加文件。例如，这是如何使用merges来提供Android设备中的默认字体大小。:
编辑
www/index.html文件,添加link标签来添加额外的css文件,overrides.css在这种情况下:<link rel="stylesheet" type="text/css" href="css/overrides.css" />（可选）创建一个空的
www/css/overrides.css文件，适合所有非Android构建，来防止文件找不到的错误。在
merges/android里面创建一个css子目录,然后添加对应的overrides.css文件。特定的CSS重写www/css/index.css文件中的12px的默认大小，例子:body { font-size:14px; }
当你重写构建项目，Android具有自定义的字体大小，而其他平台的不变。
你也可以在merges目录中添加www目录中不存在的文件。例如，一个应用程序在iOS界面中要包含一个 后退按钮,存储在 merges/ios/img/back_button.png,而Android版本则可以捕获后退按钮事件通过对应的硬件按钮。
更新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.