创建你的第一个App

这个指南像你展示如何创建JS/HTMLCordova应用并发布他们到不同的原生移动平台通过使用cordova命令行接口(CLI)。Cordova命令行详细参考查看[CLI参考]。

安装Cordova CLI

Cordova命令行工具作为npm包分发。

安装cordova命令行工具,通过下面这些步骤:

  1. 下载和安装Node.js。安装完成后你可以在命令行中使用nodenpm

  2. (可选)下载和安装git client, 如果你没有。安装成功后,你可以在命令行中使用git。 这个命令行使用下载git仓库中的资源。

  3. 安装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 文件。

参看

添加平台

所有后续命令都需要在项目目录或者项目目录的任何子目录运行:

$ 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/目录中的任何文件。当准备构建应用或者重新安装插件时这个目录通常会被重写。

参见

安装构建先决条件

要构建和运行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

参见

构建App

默认情况下, cordova create生产基于web应用程序的骨架,项目开始页面位于www/index.html 文件。任何初始化任务应该在www/js/index.js文件中的deviceready事件的事件处理函数中。

运行下面命令为所有添加的平台构建:

$ cordova build

你可以在每次构建中选择限制平台范围 - 这个例子中是'ios':

$ cordova build ios

参见

测试App

移动平台的SDK通常会绑定模拟器,它是一个可执行的设备镜像,这样你就可以在主屏幕启动你的App,看看它在多个平台是如何交互的。 在命令行运行下面的命令,会重新构建App并可以在特定平台的模拟器上查看:

$ cordova emulate android

伴随着cordova emulate命令,它会刷新模拟器镜像,用来展示最新的应用程序,现在你可以在主屏幕启动它:

或者,你可以将你的手机插入电脑,在手机上直接测试App:

$ cordova run android

在运行命令之前,你需要设置用于测试的设备,以下是每个平台的流程。

参见

添加插件

你可以修改默认生成的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"

参见

使用 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.