目标文件包（基于文件）

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

You can work with bundles in several ways:

  • 通过项目的“翻译”选项卡手动管理文件包。
  • Connect a VCS integration in Target file bundles mode.
  • 使用远程内容分发管理文件包。
  • 使用 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. （可选）您可以在按标记筛选和按标记排除字段中指定标记来筛选字符串，在生成的文件包中包含或排除它们。 了解标记的更多信息。
  8. 选择您想要导出字符串的文件格式。 要添加其他格式，请从我们的 商店 安装相应的应用程序。
    注意：您一次只能在一个文件包中选择一种格式。
  9. （可选）如果文件包文件格式带有 图标，则表示它具有其他选项（例如，对于 XLIFF（系统），将源复制到空目标和导出翻译员评论、对于 Android XML（系统），将占位符转换为目标文件格式等），您可以在设置文件包时使用这些选项。 单击所选包文件格式上的 图标，然后根据您的偏好进行配置。
    Configure Bundle File Format
  10. 单击创建。
    Create bundle

下载已配置的文件包

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

  1. 打开您的项目并前往翻译选项卡。
  2. 单击目标文件包以展开相应部分。
  3. 单击构建以构建所需的文件包。
  4. 文件包构建活动完成后，单击下载。

下载文件包

系统将构建并下载一个 ZIP 档案，其中包含项目每种目标语言的文件夹，其中包含所选格式的翻译文件。

注意：配置的文件包的下载独立于完整项目构建下载。

编辑文件包

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

  1. 打开您的项目并前往翻译选项卡。
  2. 单击目标文件包以展开相应部分。
  3. 单击所需文件包的 并选择 编辑。 或者，只需单击所需的文件包。
  4. 进行必要的编辑，然后单击 保存。

编辑文件包

删除文件包

要删除文件包，请按以下步骤操作：

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

删除文件包

VCS 集成中的文件包

在基于文件的项目中，VCS 集成允许您使用目标文件包模式处理包。

要配置在目标文件包模式下工作的 VCS 集成，请按照以下步骤操作：

  1. 选择目标文件包模式并在 VCS 端授权与 Crowdin 企业版的连接后，选择要将翻译发送到的仓库和分支。
  2. 单击 开始配置所选分支。
  3. 在 分支配置 对话框中，指定配置文件的首选名称或保留原样，然后单击 继续。
  4. 从列表中选择所需的文件包，或单击 新建 从头开始创建一个。
  5. 在 分支配置 对话框中选择所有所需的文件包后，单击 保存。
  6. 要完成 VCS 集成配置，请在选择仓库和分支的对话框中单击 保存。

VCS 目标文件包模式

详细了解在线配置 VCS 集成。

远程内容分发中的文件包

要添加使用文件包导出译文的分发，请按照以下步骤操作：

  1. 打开您的项目并前往翻译选项卡。
  2. 单击远程内容分发以展开相应部分。
  3. 使用 添加分发 按钮添加新的分发。
  4. 在出现的对话框中，命名您的分发。
  5. 在导出选项部分选择目标文件包。
  6. 从列表中选择所需的文件包，或单击 新建 从头开始创建一个。
  7. 在添加分发对话框中选择了所有需要的文件包后，单击创建。
    OTA Content Delivery Bundles
  8. 复制分发哈希值，以便您可以用它进行集成。

详细了解 远程内容分发。

CLI/API 中的文件包

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

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

详细了解 API 中的文件包。

本文是否有帮助？