跨平台框架Cordova 命令行简介（CLI）

这一节，咱们将看到如何经过Cordova命令行（CLI）建立新的项目，针对不一样平台进行编译，并利用仿真器或真实设备进行测试。CLI是跨平台工做方式的主要工具。

固然，你也能够利用CLI进行一些项目的初始化工做，好比建立初始代码等等。稍后，你就能够针对不一样平台提供的SDK进行持续开发。

如下咱们以Windows下Android应用开发为例。

前提条件

1） JDK

下载地址：http://www.oracle.com/technetwork/java/javase/downloads/index.html

设置环境变量：

JAVA_HOME= C:\Program Files (x86)\Java\jdk1.8.0

Classpath=.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;

注意：

具体路径根据你安装选项而定。

2） Apache Ant

下载地址：http://apache.fayea.com/apache-mirror/ant/binaries/

设置环境变量：

新建ANT_HOME=C:\ant193

Path中添加：%ANT_HOME%\bin;

3）Android SDK

运行命令行工具以前，你应该确保你已经安装了目标平台所需的SDK。以Android为例，咱们能够到如下网址下载一个安装套件：

http://developer.android.com/sdk/index.html

点击页面右侧的“Download the SDK ADT Bundle for Windows”下载安装。

固然你也能够逐个下载和配置，不过针对初学者我推荐下载上面的安装套件，省时省力。

其余平台的SDK，请参照官方文档：

http://cordova.apache.org/docs/en/3.4.0/guide_platforms_index.md.html#Platform%20Guides

注意：

请把SDK的路径添加到系统环境变量Path中去，总共两个。好比d:\adt-bundle\sdk\tools和d:\adt-bundle\sdk\platform-tools

4）安装Node.js

下载地址：http://nodejs.org/download/

提示：

64位版的我试了不少次，都没法安装Cordova，暂时不清楚缘由。

32位版的下载后安装正常。

5）安装Cordova

安装Node.js后，命令行执行如下语句：

npminstall -g cordova

我 试过 以上语报错

修改以下 npm install -g cordova

耐心等候直至安装完成。

建立应用程序

命令行，切换到你的项目工做目录，执行如下语句建立HelloWord应用：

cordovacreate hello com.example.hello HelloWorld –d

耐心等待直至命令完成。

第一个参数hello，指定目录名称。

第二个参数com.example.hello相似C#的命名空间，或Java的包名。（不太肯定，读者自行鉴别，原文写的是a reversedomain-style identifier）

第三个参数指定了应用程序的显示标题。

完成后能够查看Hello目录及其子目录结构。

添加特定平台支持

注意，如下全部命令都要在项目根目录下运行（用cd命令进入）。

首先，你须要添加你所须要支持的平台，好比：

cordovaplatform add android

cordovaplatform add ios

注：貌似ios开发只能在Mac机器上进行，因此上面的add ios不会出如今Windows机器上。

完成后运行如下命令查看：

cordovaplatfrom list

若是之后须要移除Android平台支持，能够运行：

cordovaplatform rm android

运行platform add或platform rm命令会影响项目目录下的内容。每个被添加的平台会在项目根目录下的platform下产生一个对应平台的子目录。你能够看到各个平台下也存在www目录，好比platforms\android\assets\www。由于CLI会不断的复制项目根目录下的www中的内容，因此你应确保不要对平台下的www目录中的内容进行修改。若是你实在有这个需求，请参照本章末尾的“Merges目录”。

警告：

若是你使用CLI管理你的项目，请尽可能不要更改platforms目录下的任何内容，除非你有明确的把握知道你在作什么。这是由于该目录下的内容会在一些条件下被覆盖。

若是你但愿此时能经过针对特定平台的SDK（好比Eclipse）来进行开发，你应该打开那些位于platforms子目录下的内容。这是由于平台相关的一些配置信息是存储在platforms特定子目录下的。

编译应用程序

默认状况下，cordova create脚本将建立一个很是简单的基于Web的应用程序。

运行如下命令编译应用程序：

cordovabuild

或

cordovabuild android  //只针对Andorid平台编译

若是最终提示：BUILD SUCCESSFUL，则编译成功。

实际上build命令对应于如下两个命令：

cordovaprepare android

cordovacompile android

这意味着你能够仅执行prepare命令，而后用SDK开发环境去另外编译。

仿真器中测试

打开Eclipse，选择菜单New­->Project->Android->AndroidProject From Existing Code，选择项目根目录为hello\platforms\android，并确保hello和hello-CordoraLib两个项目均被选中。（须要选中hello-CorodoraLib项目是由于这个项目将取代传统的.jar文件）

若是项目名上有红色的叉叉，则表明有未解决的问题。此时能够尝试：

1） 项目名上点击右键，选择Properties。

2） 选中左侧导航栏中的Android。

3） 在右侧选中对应的目标平台。好比Android4.4。

4） 点击OK。

稍后，在Eclipse中启动Android SDK Manager。以下图：

打开Manger后，点击菜单Tools->Manage AVDs…，而后点击Device definitions栏，以下图：

选择一个你想要的仿真器，而后点击Create AVD，接受默认设置便可。完成后你将在列表中看到新建的仿真器。

在列表中选中仿真器，点击窗体右侧的“Start”按钮启动仿真器（启动提示窗口中点击Launch便可）。

项目名称上点击右键，选择Run As->Android Application，而后耐心等待仿真器加载。

若是你的CPU支持虚拟化技术，你能够参照相关文档进行设置以提升仿真器运行效率。

加载后你就能够经过操做仿真器看到你的第一个Android程序，以下：

或者你也能够在命令行中运行如下命令启动仿真器：

cordovaemulate android

添加插件支持（原文:Add Plugin Features）

如以上咱们看到的，Cordova默认提供的程序界面和功能很是简单。固然你能够根据你的须要，运行标准Web开发技术对页面进行设计。可是当你须要和不一样的设备进行通信交互时，你就须要借助于一些插件，以便可以访问Cordova提供的核心API。

通常来讲，你添加一个插件的目的是为了利用Cordova的API访问设备。详细的可用插件列表你能够在社区中看到（http://plugins.cordova.io/）。固然你也能够自定义本身的插件。

你能够用CLI搜索可用的插件，好比：

cordovaplugin search bar code

你能够经过如下命令安装插件，好比:

cordovaplugin add org.apache.cordova.device                   //设备API

cordovaplugin add org.apache.cordova.network-information  //网络（事件）

cordovaplugin add org.apache.cordova.battery-status      //电池（事件）

cordovaplugin add org.apache.cordova.device-motion     //加速器

cordovaplugin add org.apache.cordova.device-orientation     //罗盘

cordovaplugin add org.apache.cordova.geolocation         //定位

cordovaplugin add org.apache.cordova.camera                 //摄像头

cordovaplugin add org.apache.cordova.media-capture     //媒体文件处理

cordovaplugin add org.apache.cordova.media                   //媒体文件处理

cordovaplugin add org.apache.cordova.file                        //文件访问

cordovaplugin add org.apache.cordova.file-transfer          //文件传输

cordovaplugin add org.apache.cordova.dialogs                 //对话框

cordovaplugin add org.apache.cordova.vibration              //震动

cordovaplugin add org.apache.cordova.contacts               //联系人

cordovaplugin add org.apache.cordova.globalization       //全球化

cordovaplugin add org.apache.cordova.splashscreen       //闪屏

cordovaplugin add org.apache.cordova.inappbrowser             //打开新的浏览器窗口

cordovaplugin add org.apache.cordova.console                //调试控制台

你能够用如下命令查看全部已经安装的插件

cordovaplugin ls

使用如下命令删除插件：

cordovaplugin rm org.apache.cordova.console    

Plugin add高级选项

上面的安装方式是从registry.cordova.io库中按照id获取插件，这是一个很是通用的作法。你能够在安装时指定版本，好比：

cordovaplugin add org.apache.cordova.console@latest

cordovaplugin add org.apache.cordova.console@0.2.1

其中的latest表示获取最新版本。中间用@分隔。

若是插件不是在默认库中，而是在其余地方，则你能够指定URL：

cordovaplugin add https://github.com/apache/cordova-plugin-console.git

固然你须要先安装git。

Merge目录

前面提到，通常状况下最好不要修改各自平台下的www目录下的文件。可是若是你确实须要为某个平台定制一些内容，又该怎么办呢？

项目根目录下有一个merges目录。咱们以一个实例来说解：

1） 修改www\css目录下的index.css文件，设置event.received的样式为红色：  background-color:#FF0000;

2） 修改platforms\android\assets\www\css中的index.css文件，设置.event.received的样式为蓝色：background-color:#0000FF;

3） 在merges\android目录下新建一个css目录。

复制www\css中的index.css文件到该目录下。

修改该目录下的index.css文件中的.event.received的样式为绿色：background-color:# 00FF00;

仿真器中运行，你会发现最终呈现的结果为绿色。由此咱们可知：

1） Merges目录中没有对应文件时，platform下的文件会被跟目录（www）下的文件覆盖。（即：若是Merges目录中不存在index.css文件，最终颜色将为红色）

2） Merges目录中存在对应文件时，platform下的文件会被merges下的文件覆盖。可见Merges目录主要用于为平台定制功能。

帮助命令

经过如下命令查看帮助信息:

cordovahelp

更新命令

如下语句更新cordova：

npmupdate -g cordova

cordova更新完成后，你还须要更新项目：

cordovaplatform update android

注意：

由于各版本之间差别较大，执行更新时请事先仔细阅读官方文档，以避免发生数据丢失或错误。