Cordova命令行界面（CLI）参考

1.语法：

cordova <command> [options] -- [platformOpts]

2.全局命令列表

3.项目命令列表

当前工作目录是有效的Cordova项目时，支持这些命令。（cordova  <command>  [option]）

这些选项适用于所有cordova-cli命令。

这个例子演示了如何使用cordova-cli来创建一个camera插件项目并运行它的android平台。具体而言，--keystore可以提供特定于平台的选项：

# 创建一个科尔多瓦项目
cordova create myApp com.myCompany.myApp myApp
cd myApp
# 将相机插件添加到项目中，并记在config.xml中
cordova plugin add cordova-plugin-camera --save
#将android平台添加到项目中，并记在config.xml中
cordova platform add android --save
#检查您的系统是否配置为构建android平台
cordova requirements android
# 构建android并发出详细的日志
cordova build android --verbose
# 在android平台上运行项目
cordova run android
# 使用指定的签名参数在发布模式下构建android平台。
cordova build android --release -- --keystore="..\android.keystore" --storePassword=android --alias=mykey

目录结构

myapp/
|-- config.xml
|-- hooks/
|-- www/
|-- platforms/
| |-- android/
| |-- windows/
| |-- ios/
|-- plugins/
  |--cordova-plugin-camera/

管理cordova平台 - 允许您添加，删除，更新，列出和检查更新。运行命令来添加或删除平台会影响项目的平台目录的内容。

cordova {platform | platforms} [
    add <platform-spec> [...] {--save | link=<path> } |
    {remove | rm}  platform [...] |
    {list | ls}  |
    check |
    save ]

• 添加的固定版本android和ios平台，并保存下载的版本到config.xml：

  cordova platform add android ios --save
  

• 使用android 5.0.0版本 添加平台并将其保存到config.xml：

  cordova platform add android@^5.0.0 --save
  

• 通过克隆指定的git仓库添加平台cordova-android4.0版本

  cordova platform add https://github.com/myfork/cordova-android.git#4.0.0
  

• 使用本地目录名为android添加平台：

  cordova platform add ../android
  

• 使用指定的tarball添加平台：

  cordova platform add ../cordova-android.tgz
  

• 从项目及config.xml中删除android平台：

  cordova platform rm android --save
  

• 列出安装的可用平台版本号。报告问题时，查找版本号很有用：

  cordova platform ls
  

• 保存当前添加到项目中的所有平台的版本config.xml。

  cordova platform save

cordova {plugin | plugins} [
    add <plugin-spec> [..] {--searchpath=<directory> | --noregistry | --link | --save | --browserify | --force} |
    {remove | rm} {<pluginid> | <name>} --save |
    {list | ls} |
    search [<keyword>] |
    save |
]

• 添加cordova-plugin-camera和cordova-plugin-file保存到项目及config.xml中。使用../plugins目录搜索插件。

  cordova plugin add cordova-plugin-camera cordova-plugin-file --save --searchpath ../plugins
  

• 添加cordova-plugin-camera^2.0.0 版本并保存到config.xml：

  cordova plugin add cordova-plugin-camera@^2.0.0 --save
  

• 克隆指定的git仓库，检出版本2.1.0，在plugin目录中查找plugin.xml ，并将其添加到项目中。保存plugin-spec到config.xml：

  cordova plugin add https://github.com/apache/cordova-plugin-camera.git#2.1.0:plugin --save
  

• 从指定的本地目录添加插​​件：

  cordova plugin add ../cordova-plugin-camera
  

• 从指定的tarball文件添加插件：

  cordova plugin add ../cordova-plugin-camera.tgz --save
  

• 从项目及config.xml中删除该插件：

  cordova plugin rm camera --save
  

• 列出安装在项目中的所有插件：

  cordova plugin ls

7.cordova 构建命令

cordova build [<platform> [...]]
    [--debug|--release]
    [--device|--emulator]
    [--buildConfig=<configfile>]
    [--browserify]
    [-- <platformOpts>]

例子：

• 为设备部署android和windows平台搭建debug调试模式：

  cordova build android windows --debug --device
  

• android在release模式下为平台构建并使用指定的构建配置：

  cordova build android --release --buildConfig=..\myBuildConfig.json
  

• 构建android平台的发布模式，并将自定义平台选项参数传递给android构建过程：

  cordova build android --release -- --keystore="..\android.keystore" --storePassword=android --alias=mykey

8.cordova 运行命令

• 在android平台模拟器上运行当前cordova项目的发布版本Nexus_5_API_23_x86。运行时使用特定版本配置：

  cordova run android --release --buildConfig=..\myBuildConfig.json --target=Nexus_5_API_23_x86
  

• 使用设备或仿真器在平台上运行当前cordova项目的调试版本（如果没有设备连接）。跳过构建：

  cordova run android --nobuild
  

• 在ios设备上运行当前cordova项目的调试版本：

  cordova run ios --device
  

• 枚举可用于运行此应用程序的所有连接设备和可用模拟器的名称：

  cordova run ios --list

cordova help [command]    帮助信息

cordova info    打印出有用的信息有助于提交错误报告并获得帮助。在项目的底部创建一个info.txt文件

cordova run --emulator   启动模拟器而不是设备、

检查并打印出指定平台的所有需求（如果没有指定，则将所有平台添加到项目中）。如果满足每个平台的所有要求，则以代码0退出，否则以非零代码退出。这在设置用于构建特定平台的机器时非常有用。

cordova requirements android  

cordova clean [<platform> [...]] 通过运行特定于平台的构建清理，清除指定平台或所有平台的构建工件。