Apache Cordova全球化插件（cordova-plugin-globalization）使用指南

Apache Cordova全球化插件（cordova-plugin-globalization）使用指南

1. 目录结构及介绍

Apache Cordova的全球化插件cordova-plugin-globalization允许应用访问用户的本地化和全球化偏好设置。该插件的仓库在GitHub上的目录结构大致如下：

• 根目录 包含了核心的源代码、文档以及管理文件。
  • RELEASENOTES.md: 记录了各个版本的更新日志。
  • package.json: 描述了插件的元数据，包括依赖项和版本信息。
  • src 目录：存放平台特定的源码实现。
    • 分别有Android、iOS等子目录，对应不同平台的实现代码。
  • www 目录：包含了插件在Webview中使用的JavaScript接口。
  • tests 目录（可能不在所有分支或版本中存在）：测试用例。
  • README.md: 提供快速入门和基本说明。

2. 项目的启动文件介绍

在Cordova项目中，并没有单一的“启动文件”概念，而是通过Cordova CLI工具管理整个项目的构建和运行流程。不过，当涉及到cordova-plugin-globalization时，开发者通常会在应用的主JavaScript文件中引入并使用该插件提供的API，这可以视为“启动使用”的开始。例如，在你的应用的主要JavaScript文件中，你会有类似以下的导入和调用来启用全球化功能：

if (window.cordova && cordova.plugins && cordova.plugins.globalization) {
    // 使用全球化插件的功能，比如获取用户首选语言
    cordova.plugins.globalization.getPreferredLanguage(function(language){
        console.log('用户的首选语言是: ' + language.value);
    }, function(error){
        console.error('获取首选语言失败: ' + error);
    });
}

3. 项目的配置文件介绍

主配置文件：config.xml

对于Cordova项目而言，config.xml是其心脏，它存储了应用程序的基本信息、权限声明、预加载资源和各种配置选项。当你安装cordova-plugin-globalization时，Cordova会自动在你的项目的config.xml中添加对该插件的引用，形如：

<widget ...>
    ...
    <feature name="Globalization">
        <param name="android-package" value="org.apache.cordova.Globalization" />
    </feature>
    ...
</widget>

这段配置告知Cordova在构建过程需要包含这个插件。

此外，虽然插件本身不直接控制配置文件的内容变化，但你可以利用插件提供的功能，通过JavaScript API来影响应用的行为，间接地在某些情况下需要在config.xml中配置相应的权限或调整其他设置，以支持全球化需求，比如确保网络权限以获取在线翻译服务。

总结，了解上述三个部分对于开发使用cordova-plugin-globalization的Cordova应用至关重要，能够帮助你正确集成和利用全球化特性。