创建你的第一个App

HTML5 开发APP需要一个开发框架和编译环境，参阅了相关资料后选择开源的Cordova。Cordova是一个开源的开发框架，使用HTML5，CSS3和JavaScript来构建跨平台的的移动应用程序。下面介绍Cordova环境的搭建，及第一个Web APP。

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

安装Cordova CLI

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

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

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

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 文件。

参看

• 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 命令参考文档