Plugin.xml

plugin.xml文件定义了你的插件所需的结构和设置。它有几个元素来提供有关你的插件的详细信息。

plugin

这个plugin元素是插件清单的顶级元素。

例子:

    <?xml version="1.0" encoding="UTF-8"?>
    <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
     xmlns:android="http://schemas.android.com/apk/res/android"
    id="my-plugin-id"
    version="1.0.2">        

engines and engine

在<engines>元素的子元素指定此插件支持基于科尔多瓦的Apache框架版本。该CLI中止与任何插件，其目标项目不符合engines的约束非零代码。如果没有指定标签，则CLI尝试安装到指定的cordova项目目录。

Examples:

<engines>
     <engine name="cordova-android" version="=1.8.0" />
</engines>

engines元件也可以使用'>'，'>='等，以避免重复指定模糊匹配，并且当底层的平台被更新，以减少维护。

<engines>
    <engine name="cordova-android" version=">=1.8.0" />
</engines>

在<engines>标签也对所有的cordova存在的主要平台默认的支持。指定科尔多瓦引擎标签意味着，在任何平台上cordova的所有版本都必须满足的引擎版本属性。你也可以列出特定平台及其版本，以覆盖包罗万象的cordova引擎：

<engines>
 <engine name="cordova" version=">=1.7.0" />
 <engine name="cordova-android" version=">=1.8.0" />
 <engine name="cordova-ios" version=">=1.7.1" />
</engines>

自定义框架例如：

<engines>
    <engine name="my_custom_framework" version="1.0.0" platform="android" scriptSrc="path_to_my_custom_framework_version"/>
    <engine name="another_framework" version=">0.2.0" platform="ios|android" scriptSrc="path_to_another_framework_version"/>
    <engine name="even_more_framework" version=">=2.2.0" platform="*" scriptSrc="path_to_even_more_framework_version"/>
 </engines>

name

name元素用于指定插件的名称。
Example:

 <name>Foo</name>

description

描述元素用于指定插件的描述。此元素不处理本地化。

Example:

<description>Foo plugin description</description>

author

author元素包含了插件作者的姓名。

Example:

<author>Foo plugin author</author>

keywords

keywords元素的内容包含逗号分隔的关键字来描述该插件。

<keywords>foo,bar</keywords>

license

此元素用于指定插件的许可证。PS:这里我也没有明白

Example:

<license>Apache 2.0 License</license>

asset

这个元素用来列出文件或目录被复制到cordova的应用程序的www目录。嵌套内的任何<asset>元素<platform>元素指定特定于平台的网络资源。

Examples:

<!-- a single file, to be copied in the root directory -->
<asset src="www/foo.js" target="foo.js" />
<!-- a directory, also to be copied in the root directory -->
<asset src="www/foo" target="foo" />

asset可以设置为有针对性地子目录为好。这将创建www目录内的js/experimental，除非已经存在，并复制新foo.js文件，重命名为foo.js.

<asset src="www/new-foo.js" target="js/experimental/foo.js" />

js-module

大部分插件包括一个或多个JavaScript文件。每个JS-module标签对应一个JavaScript文件,并防止插件的用户不必添加script标记为每个文件。不要用保鲜cordova.define的文件，因为它会自动添加。该模块被包裹在一个闭包，用模块，出口和范围要求，因为是正常的AMD模块。嵌套JS-module在platform声明特定平台的JavaScript绑定的模块元素。

Example:

当安装与下面的例子中的一个插件，socket.js被复制到www/plugins/my-plugin-id/socket.js，并添加为一个条目到www/cordova_plugins.js。在加载时，在cordova.js代码使用XHR来读取每个文件并注入 script 标记为HTML。

<js-module src="socket.js" name="Socket">
</js-module>

也正因为这个例子中，chrome-socket的插件ID，模块名称将是chrome-socket.Socket.

clobbers

JS-module元素内标记。用于指定module.exports被插入在window对象的命名空间。你可以有很多的clobbers只要你喜欢。创建window上的任何对象不可用。

Example:

<js-module src="socket.js" name="Socket">
    <clobbers target="chrome.socket" />
</js-module>

这里module.exports被插入到window对象window.chrome.socket。

merges

JS-module元素内标记。用来指定在哪里module.exports获取与任何现有的价值合并window对象的命名空间。如果已经存在，模块的版本取代原来的。你可以有很多的merges只要你喜欢。创建window上的任何对象不可用。

Example:

<js-module src="socket.js" name="Socket">
     <merges target="chrome.socket" />
</js-module>

这里module.exports得到与window.chrome.socket的任何现有值合并。

runs

runs 是JS-module元素内标记。这意味着你的代码应与cordova.require指定，但窗口对象上没有安装。初始化模块时，附加的事件处理程序或其他方式，这非常有用。您最多只能有一个runs标记。请注意，包括runs与<clobbers/>或<merges/>是多余的，因为它们也cordova.require您的模块。

Example:

<js-module src="socket.js" name="Socket">
     <runs/>
</js-module>

dependency

在dependency标签允许你指定在其当前插件依赖其他插件。该插件被其独特的NPM的ID或URL GitHub的引用。

Examples:

 <dependency id="cordova-plugin-someplugin" url="https://github.com/myuser/someplugin" commit="428931ada3891801" subdir="some/path/here" />
 <dependency id="cordova-plugin-someplugin" version="1.0.1">

platform

标识具有相关联的本机代码或需要修改其配置文件的平台。工具使用这个规范可以识别支持的平台和代码安装到cordova项目。无platform标记插件被假定为JavaScript的唯一的，因此在任何和所有平台安装。

Example:

<platform name="android">
    <!-- android-specific elements -->
</platform>

source-file

标识应安装到一个项目中的可执行文件的源代码。

Examples:

<!-- android -->
<source-file src="src/android/Foo.java" target-dir="src/com/alunny/foo" />
<!-- ios -->
<source-file src="src/ios/CDVFoo.m" />
<source-file src="src/ios/someLib.a" framework="true" />
<source-file src="src/ios/someLib.a" compiler-flags="-fno-objc-arc" />

header-file

这就像source-file元素，但专门为平台，例如iOS和Android的源文件，头文件和资源加以区分。这不是由Windows支持。

Example:

For iOS:

<header-file src="CDVFoo.h" />

resource-file

这就像source-file元素，但专门为平台，例如iOS和Android的源文件，头文件和资源加以区分。

Examples:

For Android:

    <resource-file src="FooPluginStrings.xml" target="res/values/FooPluginStrings.xml" />

config-file

标识一个基于XML的配置文件进行修改，其中在该文件中所述修改应该发生，什么应该进行修改。已经过测试，修改与此元素的两个文件类型是XML和的plist文件。在配置文件中的元素只允许新的儿童追加到XML文档树。孩子们在目标文档中插入XML文本。

Examples:

For XML:

  <config-file target="AndroidManifest.xml" parent="/manifest/application">
    <activity android:name="com.foo.Foo" android:label="@string/app_name">
      <intent-filter>
      </intent-filter>
    </activity>
 </config-file>

For plist:

<config-file target="*-Info.plist" parent="CFBundleURLTypes">
  <array>
      <dict>
          <key>PackageName</key>
          <string>$PACKAGE_NAME</string>
      </dict>
  </array>
</config-file>

plugins-plist

指定键和值将追加到在在iOScordova项目的正确AppInfo.plist文件。这是过时，因为它仅适用于科尔多瓦-IOS2.2.0及以下。使用config-file标记科尔多瓦的较新版本。
Example:

<plugins-plist key="Foo" string="CDVFoo" />

lib-file

链接源，资源和头文件。

Examples:

<lib-file src="src/BlackBerry10/native/device/libfoo.so" arch="device" />
<lib-file src="src/BlackBerry10/native/simulator/libfoo.so" arch="simulator" />

framework

标识的框架（通常是系统/平台的一部分）该插件依赖。

Examples:

For iOS:

 <framework src="libsqlite3.dylib" />
 <framework src="social.framework" weak="true" />
 <framework src="relative/path/to/my.framework" custom="true" />

在Android（如cordova-android@4.0.0的），使用框架的标签，包括Maven依赖，或者包括捆绑的库项目。

<!-- Depend on latest version of GCM from play services -->
<framework src="com.google.android.gms:play-services-gcm:+" />
<!-- Depend on v21 of appcompat-v7 support library -->
<framework src="com.android.support:appcompat-v7:21+" />
<!-- Depend on library project included in plugin -->
<framework src="relative/path/FeedbackLib" custom="true" />

info

向用户提供更多的信息。当你需要不容易自动或超出了CLI的范围，额外的步骤，这是非常有用的。此标记的内容被打印出来的时候，CLI安装插件。

Example:

<info>
You need to install __Google Play Services__ from the `Android  Extras` section using the Android SDK manager (run `android`).

  You need to add the following line to the `local.properties`:

android.library.reference.1=PATH_TO_ANDROID_SDK/sdk/extras/google/google_play_services/libproject/google-play-services_lib
</info>

hook

表示将由cordova当某些行为发生时被调用自定义脚本（例如，插件添加或平台准备逻辑后调用）。当你需要扩展默认cordvoa的功能，这非常有用。

Example:

  <hook type="after_plugin_install" src="scripts/afterPluginInstall.js" />

uses-permission

在某些情况下，插件可能需要使依赖于目标应用程序配置的改变。例如，要在Android，应用程序的包ID是我-APP-ID将需要的权限，如注册C2DM：

<uses-permission android:name="my-app-id.permission.C2D_MESSAGE"/>

在从plugin.xml文件中插入的内容是不是提前知道这样的情况下，变量可以通过一个美元符号后面是一系列大写字母，数字或下划线的表示。对于上面的例子中，plugin.xml文件将包括此标记：

<uses-permission android:name="$PACKAGE_NAME.permission.C2D_MESSAGE"/>

如果没有找到该CLI替换指定的值，或空字符串变量的引用。可变基准的值可以被检测（在此情况下，从AndroidManifest.xml文件），或者由工具的用户指定;确切的过程是依赖于特定的工具。

Plugman可以要求用户指定插件的必需的变量。例如，对于C2M和谷歌地图API密钥可以被指定为一个命令行参数：

plugman --platform android --project /path/to/project --plugin name|git-url|path --variable API_KEY=!@CFATGWE%^WGSFDGSDFW$%^#$%YTHGsdfhsfhyer56734

preference

正如上一节中看到的，有时插件可能需要用户为他们的变量赋值。为了使这些变量强制性的，在<平台>标签必须包含一个<优先>标记。在CLI检查，这些要求的偏好中通过。如果不是，则应当警告用户如何在可变和出口通过带有非零码。

Example:

 <preference name="API_KEY" default="default-value" />