Apache Cordova 插件遗产白名单安装与使用指南

Apache Cordova 插件遗产白名单安装与使用指南

cordova-plugin-legacy-whitelist[DEPRECATED] Apache Cordova plugin legacy whitelist项目地址:https://gitcode.com/gh_mirrors/co/cordova-plugin-legacy-whitelist

1. 项目目录结构及介绍

在 https://github.com/apache/cordova-plugin-legacy-whitelist.git 中，Cordova-plugin-legacy-whitelist 的目录结构大致如下：

├── CONTRIBUTING.md       # 贡献者指南
├── LICENSE               # 许可证文件
├── NOTICE                # 注意事项文件
├── README.md             # 项目README文档
├── RELEASENOTES.md       # 发布说明
├── package.json          # Node.js 包配置文件
└── plugin.xml            # 插件配置文件

• CONTRIBUTING.md：描述如何向项目贡献代码的规则。
• LICENSE: 提供该项目使用的许可证类型（通常是Apache 2.0）。
• NOTICE: 提醒开发者关于版权或其他法律方面需要注意的信息。
• README.md: 项目的基本介绍、用途、弃用通知以及如何使用等信息。
• RELEASENOTES.md: 列出每个版本的更新内容和改进。
• package.json: 描述插件的依赖和其他元数据，用于npm包管理。
• plugin.xml: 插件的核心配置文件，定义了插件的功能、平台支持和资源。

2. 项目的启动文件介绍

由于这是一个Cordova插件，它并没有一个传统的“启动文件”。Cordova插件在Cordova应用运行时由Cordova框架加载。当添加此插件到你的Cordova项目后，它的功能通过Cordova的生命周期事件如deviceready来激活。在JavaScript中，你可以通过<script>标签引入相应的JS文件或在你的index.js里调用插件方法。

3. 项目的配置文件介绍

config.xml

在你的Cordova项目根目录下的config.xml是主要的配置文件，用于设置应用程序的行为和特征。要使用cordova-plugin-legacy-whitelist，你需要在config.xml中添加 <access> 标签以指定允许的网络源。例如：

<access origin="*" />
<!-- 允许访问所有网址 -->
<access origin="http://example.com" subdomains="true" />
<!-- 只允许访问 example.com 及其子域名 -->

请注意，这个插件已经废弃，推荐使用 cordova-plugin-whitelist，它提供了更安全的白名单策略。要在config.xml中使用新插件，可能需要调整以下部分：

<plugin name="cordova-plugin-whitelist" spec="^1.3.3" />
<!-- 添加 whitelist 插件 -->

<allow-navigation href="*" />
<!-- 全局允许所有导航请求 -->
<allow-intent href="*" />
<!-- 全局允许所有意图（URL点击） -->
<platform name="android">
    ...
    <!-- 可能还需要其他安卓特定的配置 -->
</platform>
<platform name="ios">
    ...
    <!-- 可能还需要其他iOS特定的配置 -->
</platform>

以上就是对 cordova-plugin-legacy-whitelist 项目结构、启动文件以及配置文件的简要介绍。为了提高应用安全性，建议遵循现代的白名单策略并移步到cordova-plugin-whitelist。

cordova-plugin-legacy-whitelist[DEPRECATED] Apache Cordova plugin legacy whitelist项目地址:https://gitcode.com/gh_mirrors/co/cordova-plugin-legacy-whitelist