Target File Bundles (String-based)

Pacotes de arquivos de destino ou simplesmente Pacotes é o recurso que permite exportar conjuntos de strings ou arquivos nos formatos selecionados, independentemente do formato do arquivo original. Por padrão, você pode escolher entre os três formatos a seguir: XLIFF, Android XML e iOS Strings. You can add more target file formats by installing respective applications from the Crowdin Store.

You can work with bundles in several ways:

• Manage bundles manually via the project’s Download tab.
• Connect a VCS integration in Target file bundles mode. For string-based projects, this is the only mode that is selected by default.
• Gerencie pacotes usando a Entrega de Conteúdo OTA.
• Gerencie pacotes usando Crowdin CLI e API.

When you work with bundles, the primary location for managing (creating, editing, and deleting) them is the project’s Download tab (for String-based projects). Once you’ve created a bundle, you can use it with all the aforementioned tools.

Casos de Uso

Os casos de uso mais comuns são os seguintes:

• 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.).
• Você pode ter uma única planilha (por exemplo, XLSX ou CSV) onde armazena strings de origem para todas as plataformas para as quais seu aplicativo foi desenvolvido e cada string é rotulada com um rótulo respectivo. Carregue este arquivo em seu projeto, traduza-o e crie pacotes separados para várias plataformas usando uma combinação de caminhos de arquivo de origem e rótulos de string.
• Você pode localizar seu aplicativo móvel sem arquivos de origem combinando plugins de ferramentas de design Crowdin (Figma, Sketch, Adobe XD) para enviar strings diretamente para o projeto Crowdin e exportar traduções nos formatos preferidos usando pacotes.
• You can export specific sets of strings for offline translation in XLIFF format and then upload finished translations back to Crowdin.

Managing Bundles in Download tab

To work with bundles manually, you can configure and download them in your project’s Download tab.

Configurando Pacotes

Para configurar um pacote, siga estas etapas:

1. Open your project and go to the Download tab.
2. Click Target File Bundles to expand the respective section.
3. Click Add bundle.
4. Na caixa de diálogo exibida, nomeie seu pacote.
5. Specify the source branches and resulting file paths. If needed, you can add multiple source branch path patterns using . In the right panel, you can preview the source branches and structure of the translation files based on the specified paths.
6. (Optional) To ignore some branches, click Add ignored pattern, specify their respective pattern, and Crowdin will skip these specific branches during the bundle generation. If needed, you can add multiple ignore patterns using .
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.
8. Selecione o formato de arquivo no qual você gostaria que suas strings fossem exportadas. 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. Click Save.

Baixando Pacotes Configurados

Para baixar pacotes configurados, siga estas etapas:

1. Open your project and go to the Download tab.
2. Click Target File Bundles to expand the respective section.
3. Click Download toward the needed bundle.

O sistema irá construir e baixar um arquivo ZIP com pastas para cada um dos idiomas alvo do projeto contendo os arquivos de tradução do formato selecionado.

Editando Pacotes

Para editar pacotes configurados, siga estas etapas:

1. Open your project and go to the Download tab.
2. Click Target File Bundles to expand the respective section.
3. Click toward the needed bundle and select Edit. Como alternativa, basta clicar duas vezes no pacote necessário.
4. Make the necessary edits and click Save.

Excluindo Pacotes

Para excluir pacotes, siga estas etapas:

1. Open your project and go to the Download tab.
2. Click Target File Bundles to expand the respective section.
3. Click toward the needed bundle and select Delete.
4. Confirm the deletion by clicking Delete in the appeared dialog.

Pacotes em Integrações VCS

In string-based projects, VCS integrations exclusively operate in the Target file bundles mode.

To configure a VCS integration for Target file bundles mode, follow these steps:

1. Once you click Set Up Integration 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.

Read more about configuring VCS integrations online.

Pacotes na Entrega de Conteúdo OTA

Para adicionar uma distribuição que exporta traduções usando pacotes, siga estas etapas:

1. Open your project and go to the Download tab.
2. Click Over-The-Air Content Delivery to expand the respective section.
3. Add new distribution using the Add distribution button.
4. Na caixa de diálogo exibida, nomeie sua distribuição.
5. Select the needed bundles from the list or click Create new to create one from scratch.
6. Once you’ve selected all the needed bundles in the Add distribution dialog, click Next.
   
7. Copie o hash de distribuição para poder usá-lo para integração.

Read more about OTA Content Delivery.

Pacotes na CLI/API

Você também pode exportar traduções usando pacotes ao trabalhar com Crowdin CLI e API.

Read more about Bundles in CLI.

Read more about Bundles in API.