Ionic CLI

既然Ionic CLI（命令行工具）依赖于Cordova，就可调用原生的API，那么在我们的Ionic项目中如何实现，今天我们了解下ionic中plugin的使用。

Ionic与Cordova/phoneGP都是基于HTML5的移动开发框架，Ionic在Cordova的基础上进行了优化，但其插件依然遵循Cordova插件的相关规范，同时提供类似于Cordova的plugin管理方法。

此处使用Ionic为最新的V3.9.2版本为例

  1. $ ionic -v

直接检测系统安装的Ionic版本

项目中插件目录

项目中插件目录（新建的Ionic项目，如果不添加platform，在项目中是没有plugins插件目录的）
如何添加platform？以Android为例：

  1. $ ionic cordova platform add android

tip：不同版本的Ionic，其CLI有可能不同，使用帮助命令查看即可
image.png

查看已经安装的插件

  1. E:\zhaikun\IonicProjects\Demo>ionic cordova plugin -list
  2. > cordova plugin ls
  3. √ Running command - done!
  4. cordova-plugin-console 1.0.5 "Console"
  5. cordova-plugin-device 1.1.4 "Device"
  6. cordova-plugin-splashscreen 4.0.3 "Splashscreen"
  7. cordova-plugin-statusbar 2.2.2 "StatusBar"
  8. cordova-plugin-whitelist 1.3.1 "Whitelist"
  9. ionic-plugin-keyboard 2.2.1 "Keyboard"

这是小编创建的项目中已经安装的plugin，由于添加的platform平台和自定义添加的plugin的不同，此处显示的plugin插件数目视具体的项目而定。

plugin帮助命令

  1. $ ionic cordova plugin --help

将显示有关plugin的操作命令

  1. $ ionic cordova plugin add [插件名] //添加插件
  2. $ ionic cordova plugin rm [插件名] //删除插件

5、plugins目录下android.json和ios.json文件说明
image.png
以android.json为例：文件中保存了对应Android平台所安装插件的条目，在使用plugin管理命令对plugin进行添加或删除时，文件中记录的插件条目也会随之变化。

  1. {
  2.     "prepare_queue": {
  3.         "installed": [],
  4.         "uninstalled": []
  5.     },
  6.     "config_munge": {
  7.         "files": {
  8.             "res/xml/config.xml": {
  9.                 "parents": {
  10.                     "/*": [
  11.                         {
  12.                             "xml": "<feature name=\"Whitelist\"><param name=\"android-package\" value=\"org.apache.cordova.whitelist.WhitelistPlugin\" /><param name=\"onload\" value=\"true\" /></feature>",
  13.                             "count": 1
  14.                         },
  15.                         {
  16.                             "xml": "<feature name=\"StatusBar\"><param name=\"android-package\" value=\"org.apache.cordova.statusbar.StatusBar\" /><param name=\"onload\" value=\"true\" /></feature>",
  17.                             "count": 1
  18.                         },
  19.                         {
  20.                             "xml": "<feature name=\"Device\"><param name=\"android-package\" value=\"org.apache.cordova.device.Device\" /></feature>",
  21.                             "count": 1
  22.                         },
  23.                         {
  24.                             "xml": "<feature name=\"SplashScreen\"><param name=\"android-package\" value=\"org.apache.cordova.splashscreen.SplashScreen\" /><param name=\"onload\" value=\"true\" /></feature>",
  25.                             "count": 1
  26.                         },
  27.                         {
  28.                             "xml": "<feature name=\"Keyboard\"><param name=\"android-package\" value=\"io.ionic.keyboard.IonicKeyboard\" /><param name=\"onload\" value=\"true\" /></feature>",
  29.                             "count": 1
  30.                         }
  31.                     ]
  32.                 }
  33.             }
  34.         }
  35.     },
  36.     "installed_plugins": {
  37.         "cordova-plugin-whitelist": {
  38.             "PACKAGE_NAME": "io.ionic.starter"
  39.         },
  40.         "cordova-plugin-console": {
  41.             "PACKAGE_NAME": "io.ionic.starter"
  42.         },
  43.         "cordova-plugin-statusbar": {
  44.             "PACKAGE_NAME": "io.ionic.starter"
  45.         },
  46.         "cordova-plugin-device": {
  47.             "PACKAGE_NAME": "io.ionic.starter"
  48.         },
  49.         "cordova-plugin-splashscreen": {
  50.             "PACKAGE_NAME": "io.ionic.starter"
  51.         },
  52.         "ionic-plugin-keyboard": {
  53.             "PACKAGE_NAME": "io.ionic.starter"
  54.         }
  55.     },
  56.     "dependent_plugins": {}
  57. }

具体插件分析

具体插件分析，以ionic-plugin-keyboard为例：
image.png
由于plugin插件的定义遵循Cordova插件的相关规范，因此每一个插件的命名格式是一致的。在自定义一个新的插件时，我们也推荐这样做。插件中将不同平台的实现代码放在了各自对应的平台文件夹中（android/ios），在使用Ionic CLI 构建应用程序时，会根据不同平台的实现代码，生成对应不同平台的应用程序。