为基于核心组件的自适应表单添加区域设置 supporting-new-locales-for-adaptive-forms-localization

URL区域设置选择器（[区域设置]）：

系统使用[区域设置]选择器优先处理URL中指定的区域设置。 此格式允许缓存以获得更好的性能。

格式： URL遵循以下格式： http:/[AEM Forms Server URL]/content/forms/af/[afName]。[区域设置].html？wcmmode=disabled。

示例： https://[server]/content/forms/af/contact-us.hi.html以印地语呈现表单。

afAcceptLang请求参数：

要覆盖用户的浏览器区域设置，可以在URL中使用afAcceptLang参数。

示例： https://[server]/forms/af/survey.ca-fr.html？afAcceptLang=ca-fr强制表单以加拿大法文呈现。

用户的浏览器区域设置（Accept-Language标题）：

如果未指定其他区域设置，AEM Forms会考虑使用Accept-Language标头发送的用户浏览器区域设置。

打开命令行或终端窗口。

导航到要在计算机上存储存储库的所需位置（例如，/adaptive-forms-core-components）。

运行以下命令以克隆存储库：

git clone https://github.com/adobe/aem-core-forms-components.git

此命令下载存储库，并在您的计算机上创建名为aem-core-forms-components的文件夹。 在本指南中，我们将此文件夹称为[Adaptive Forms Core Components repository]

打开命令行并选择要存储AEM as a Cloud Service存储库的目录，如/cloud-service-repository/。

运行以下命令以克隆存储库：

git clone https://git.cloudmanager.adobe.com/<organization-name>/<program id>/

要克隆Git存储库，您需要以下信息：

• 组织名称：用于在Adobe Experience Manager as a Cloud Service (AEM as a Cloud Service)中标识您的团队或项目。

• 项目ID：这指定了与存储库关联的项目。

• 凭据：您需要用户名和密码（或个人访问令牌）才能安全访问存储库。

在何处查找此信息？

有关查找这些详细信息的逐步说明，请参阅Adobe Experience League文章“访问Git”。

您的项目已准备就绪！

当命令成功完成时，您会看到在本地目录中创建了一个新文件夹。 此文件夹以您的程序（例如，program-id）命名。 此文件夹包含从AEM as a Cloud Service Git存储库下载的所有文件和代码。

在本指南中，我们将此文件夹称为[AEMaaCS project directory]。

在编辑器中打开存储库文件夹。

在编辑器中

找到Guide Localization Service.cfg.json文件。 此文件可控制AEM Forms应用程序支持的区域设置。 您可以编辑此文件以添加新区域设置。

• 现有文件：如果文件已存在，请在AEM Forms项目目录中查找该文件。 典型位置为：

  code language-shell
  [AEMaaCS project directory]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config`.

  将<appid>替换为您的项目特定应用程序ID。 您可以在archetype.properties文件中找到AEM项目的<appid>。

  

• 新文件：如果文件不存在，则需要在上述相同位置创建该文件。 请勿从此文档复制粘贴文件的名称，而是手动键入名称。 文件名Guide Localization Service.cfg.json包含空格。 这是有意为之，而不是文档中的打字错误。

  包含OOTB支持的区域设置列表的示例文件为：

  code language-none
  { "supportedLocales":[ "en", "fr", "de", "ja", "pt-br", "zh-cn", "zh-tw", "ko-kr", "it", "es" ] }

将所需语言的区域设置代码添加到文件中。

1. 使用ISO 639-1代码列表查找代表所需语言的双字母代码。

2. 将区域设置代码包含到Guide Localization Service.cfg.json文件中。 以下是一些示例：

   • 从左至右语言：

     • 英语（美国）：en-US
     • 西班牙语（西班牙）：es-ES
     • 法语（法国）：fr-FR

   • 从右至左语言：

     • 阿拉伯语（阿拉伯联合酋长国）： ar-ae
     • 希伯来语：he（或iw，供历史参考）
     • 波斯语： fa

进行更改后，请确保Guide Localization Service.cfg.json文件已正确格式化为有效的JSON文件。 JSON格式中的错误会妨碍其正常运行。 保存文件。

找到示例客户端库：

在[自适应Forms核心组件存储库]的本地副本中，导航到以下路径：

    /aem-core-forms-components/it/apps/src/main/content/jcr_root/apps/forms-core-components-it/clientlibs

复制并粘贴库：

1. 复制clientlib-it-custom-locale文件夹。

   

2. 导航到[AEMaaCS项目目录]中的以下目录：

   code language-none
   /ui.apps/src/main/content/jcr_root/apps/<app-id>/clientlib

   重要信息：将<app-id>替换为应用程序的实际ID。

3. 将复制的clientlib-it-custom-locale文件夹粘贴到此目录中。

   

导航到区域设置目录：

在您的[AEMaaCS project directory]中，导航到以下路径：

    /ui.apps/src/main/content/jcr_root/apps/<program-id>/clientlibs/clientlib-it-custom-locale/resources/i18n/

重要信息：将<program-id>替换为您的实际应用程序ID。

找到示例英语文件：

AEM Forms在GitHub🔗上提供了示例英语区域设置文件(.json)。

英语文件包含默认字符串集以供参考。 区域设置特定的文件应模拟英语文件的结构。

对于阿拉伯语、希伯来语和波斯语等语言，文本从右至左(RTL)而不是从左至右(LTR)像英语一样阅读。 为确保您的表单在这些语言中正确显示，我们建议使用示例区域设置文件作为指南。 这些文件就如何设置RTL语言的文本、日期和其他元素的格式提供了参考。 您可以找到以下示例区域设置文件：

• 阿拉伯语
• 希伯来语
• 波斯语

利用这些样例文件，您可以确保表单为使用RTL语言的用户提供无缝体验。

创建区域设置文件：

1. 在i18n目录中创建一个新的.json文件。
2. 使用适用于所需语言的相应区域设置代码命名文件（例如，法语为fr-FR.json，阿拉伯语为ar-ae.json）。 此文件的结构应镜像英文区域设置文件。

结构和翻译：

1. 在文本编辑器中打开新创建的文件。

2. 将英语值替换为目标语言的相应翻译。

3. 翻译完字符串后，保存文件。

找到配置文件夹：

导航到[AEMaaCS项目目录]中的以下目录：

/ui.content/src/main/content/jcr_root/etc

创建必要的文件夹（如果缺少）：

如果etc文件夹在jcr_root文件夹中不存在，请创建它。 在etc内，创建另一个名为languages的文件夹（如果缺少该文件夹）。

创建区域设置配置文件：

在languages文件夹中，创建一个名为.content.xml的新文件。 请勿从此文档复制粘贴文件的名称，而是手动键入名称。

的新文件

打开此文件并粘贴以下内容，将[LOCALE_CODE]替换为实际的区域设置代码（例如，阿拉伯语为ar-ae）。

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
      jcr:primaryType="nt:unstructured"
      languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi]"/>

警告：不要替换现有列表。 请改为将新的区域设置代码附加到方括号中，并用逗号分隔，如下所示（以ar-ae为例）：

languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi,ar-ae]"

在filter.xml中包含新文件夹：

导航到[AEMaaCS项目目录]中的/ui.content/src/main/content/meta-inf/vault/filter.xml文件。

打开文件，并在末尾添加以下行：

<filter root="/etc/languages"/>

下的filter.xml中添加已创建的文件夹

保存文件。