android - Cordova Android Plugin : config. xml 被cordova 覆盖准备好了吗？

Question

我正在为 Android 平台开发一个 Cordova 插件。

如所述here ，我编辑了 platforms/android/res/xml/config.xml 文件以包含插件的类映射。

除了每次我运行 cordova prepare android 这个文件都会被覆盖:

Generating config.xml from defaults for platform "android"

所以，我每次都必须撤消更改，这很烦人。有没有办法告诉cordova不要这样做或在其他地方插入类映射？

Answer 1

您需要创建一个插件包并安装它来解决此问题。

一个插件包有一个plugin.xml文件、一个JS文件和你的本地代码存储在这个结构中:

PLUGIN_NAME\
 src\
  PLATFORM_NAME\
   PLAFORM_SPECIFIC_FILES
 www\
  PLUGIN_JS_FILE
 plugin.xml

示例:

BackgroundAPI\
 plugin.xml
 src\
  android\
   BackgroundAPI.java
  ios\
   BackgroundAPI.h
   BackgroundAPI.m
 www\
  BackgroundAPI.js

在您的 plugin.xml 中，您定义在安装插件时将放入 config.xml 中的项目。这样可以确保每次运行 build 或 prepare 命令时都不会删除您的代码。

例子:

<?xml version="1.0" encoding="UTF-8"?>
<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
    id="com.dawsonloudon.backgroundapi"
    version="1.0.0">
    <name>backgroundapi</name>
    <description>run external api calls on a background thread</description>
    <license>MIT</license>

    <js-module src="www/BackgroundAPI.js" name="BackgroundAPI">
        <clobbers target="BackgroundAPI" />
    </js-module>

    <platform name="ios">
        <config-file target="config.xml" parent="/*">
            <feature name="BackgroundAPI">
                <param name="ios-package" value="BackgroundAPI" />
            </feature>
        </config-file>

        <header-file src="src/ios/BackgroundAPI.h" />
        <source-file src="src/ios/BackgroundAPI.m" />
    </platform>

    <platform name="android">
        <config-file target="res/xml/config.xml" parent="/*">
            <feature name="BackgroundAPI" >
                <param name="android-package" value="com.dawsonloudon.backgroundapi.BackgroundAPI"/>
            </feature>
        </config-file>

        <config-file target="AndroidManifest.xml" parent="/*">
            <uses-permission android:name="android.permission.INTERNET" />
        </config-file>
        <source-file src="src/android/BackgroundAPI.java" target-dir="src/com/dawsonloudon/backgroundapi" />
    </platform>

</plugin>

一旦你在项目之外的一个单独的目录中构建了这一切，进入你的项目目录并运行:

cordova plugin add /PATH/TO/YOUR/PLUGIN

现在插件已安装，您的项目中将有一个 plugins 文件夹，并且您的所有 config.xml 编辑将始终存在。

要编辑您的插件，您需要更改/plugins/PLUGIN_NAME/www 中的 JS 文件

要编辑 native 代码，请浏览到/platforms/PLATFORM/并找到您的 native 代码。

每次构建或准备时，您的 JS 文件都会从插件目录重写到特定于平台的路径，但您的 native 代码只会在安装插件时写入/platforms/路径一次。

我建议，一旦您的插件完成，您应该收集所有插件特定文件并将它们复制回您的插件包目录，以便您可以在以后的项目中再次使用它们(或将它们发布以供其他人使用开源)。