目标文件包(基于文件)

目标文件包或简称为文件包(Bundle)的功能允许您以您选择的格式导出字符串或文件集合,而不管原始文件格式如何。 默认情况下,您可以从以下三种格式中进行选择:XLIFF、Android XML 和 iOS 字符串。 您可以通过从 Crowdin 商店 安装相应的应用程序来添加更多目标文件格式。

You can work with bundles in several ways:

  • 通过项目的“翻译”选项卡手动管理文件包。
  • Connect a VCS integration in Target file bundles mode.
  • 使用 OTA 内容交付管理文件包。
  • 使用 Crowdin CLI 和 API 管理文件包。

当您使用文件包时,管理(创建、编辑和删除)它们的主要位置是项目的“翻译”选项卡(对于基于文件的项目)。 Once you’ve created a bundle, you can use it with all the aforementioned tools.

Use Cases

最常见的用例如下:

  • You can upload a single source file (e.g., Android XML) to your project, translate it, and then, using bundles, export translations for multiple platforms (e.g., Android XML for the Android app, iOS strings for the iOS app, JSON for the web app, etc.).
  • 您可以拥有一个电子表格(例如 XLSX 或 CSV),其中存储您的应用程序所针对的所有平台的源字符串,并且每个字符串都标有相应的标签。 将此文件上传到您的项目,进行翻译,然后使用源文件路径和字符串标签的组合为多个平台创建单独的文件包。
  • 您可以通过结合 Crowdin 设计工具插件(Figma、Sketch、Adobe XD)将字符串直接发送到 Crowdin 项目并使用文件包以首选格式导出译文,从而本地化您的移动应用程序而无需源文件。
  • 您可以以 XLIFF 格式导出特定的字符串集合以进行离线翻译,然后将完成的翻译上传回 Crowdin。

在“翻译”选项卡中管理文件包

要手动使用文件包,您可以在项目的翻译选项卡中配置和下载它们。

配置文件包

要配置文件包,请按照下列步骤操作:

  1. 打开您的项目并前往翻译选项卡。
  2. 单击目标文件包以展开相应部分。
  3. 点击添加文件包
  4. 在出现的对话框中,为您的文件包命名。
  5. 指定源文件和结果文件路径。 如果需要,您可以使用 添加多个源路径模式。 在右侧面板中,您可以根据指定的路径预览源文件和翻译文件的结构。
  6. (可选)要忽略某些文件夹或文件,请单击添加忽略的模式,指定其各自的模式,Crowdin 将在生成文件包时跳过这些特定的文件或文件夹。 如果需要,您可以使用 添加多个忽略模式。
  7. (Optional) You can specify labels in the Filter by labels and Exclude by labels fields to filter strings, including or excluding them in the generated bundle. Read more about Labels.
  8. Select the file format you’d like your strings to be exported in. To add other formats, install the respective applications from our Store.
    Note: You can select only one format at once within a single bundle.
  9. (Optional) If a bundle file format has a icon, it indicates that it has additional options (e.g., Copy source to empty target and Export Translator’s Comments for XLIFF (system), Convert placeholders to target file format for Android XML (system), etc.) you may use when setting up your bundle. Click the icon on a selected bundle file format and configure it according to your preferences.
    Configure Bundle File Format
  10. Click Save.
    Create Bundle

下载已配置的文件包

要下载已配置的文件包,请按照以下步骤操作:

  1. 打开您的项目并前往翻译选项卡。
  2. 单击目标文件包以展开相应部分。
  3. Click Download toward the needed bundle.

下载文件包

The system will build and download a ZIP archive with folders for each of the project’s target languages containing the translation files of the selected format.

Note: The download of the configured bundles works independently of the full project build download.

编辑文件包

要编辑已配置的文件包,请按照以下步骤操作:

  1. 打开您的项目并前往翻译选项卡。
  2. 单击目标文件包以展开相应部分。
  3. Click toward the needed bundle and select Edit. Alternatively, just double-click on the needed bundle.
  4. Make the necessary edits and click Save.

编辑文件包

删除文件包

要删除文件包,请按以下步骤操作:

  1. 打开您的项目并前往翻译选项卡。
  2. 单击目标文件包以展开相应部分。
  3. 单击 所需文件包并选择删除
  4. 在出现的对话框中单击删除确认删除。

删除文件包

VCS 集成中的文件包

In file-based projects, VCS integrations allow you to work with bundles using the Target file bundles mode.

To configure a VCS integration that works in Target file bundles mode, follow these steps:

  1. Once you select Target file bundles mode and authorize the connection with Crowdin on the VCS side, select the repository and branches to which you want to send translations.
  2. Click to start the configuration of the selected branch.
  3. In the Branch Configuration dialog, specify the preferred name for your configuration file or leave it as is and click Continue.
  4. Select the needed bundles from the list or click Create new to create one from scratch.
  5. Once you’ve selected all the needed bundles in the Branch Configuration dialog, click Save.
  6. To complete the VCS integration configuration, click Save in the dialog where you selected your repo and branches.

VCS 目标文件包模式

Read more about configuring VCS integrations online.

OTA 内容交付中的文件包

To add a distribution that exports translations using bundles, follow these steps:

  1. 打开您的项目并前往翻译选项卡。
  2. Click Over-The-Air Content Delivery to expand the respective section.
  3. Add new distribution using the Add distribution button.
  4. In the appeared dialog, name your distribution.
  5. 导出选项部分选择目标文件包
  6. Select the needed bundles from the list or click Create new to create one from scratch.
  7. Once you’ve selected all the needed bundles in the Add distribution dialog, click Next.
    OTA Content Delivery Bundles
  8. Copy the distribution hash so you can use it for integration.

Read more about OTA Content Delivery.

CLI/API 中的文件包

使用 Crowdin CLI 和 API 时,您还可以使用文件包导出译文。

阅读有关 CLI 中的文件包 的更多信息。

阅读有关 API 中的文件包的更多信息。

本文是否有帮助?