Target File Bundles (File-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. Você pode adicionar mais formatos de arquivo de destino instalando os respectivos aplicativos do Crowdin Marketplace.

You can work with bundles in several ways:

• Gerencie os pacotes manualmente por meio da guia Traduções do projeto.
• Connect a VCS integration in Target file bundles mode.
• 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 Translations tab (for File-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.
• Você pode exportar conjuntos específicos de strings para tradução offline no formato XLIFF e, em seguida, fazer o envio das traduções concluídas de volta para o Crowdin.

Managing Bundles in Translations tab

Para trabalhar com pacotes manualmente, você pode configurá-los e baixá-los na guia Traduções do seu projeto.

Configurando Pacotes

Para configurar um pacote, siga estas etapas:

1. Abra seu projeto e vá para a guia Traduções.
2. Clique em Pacotes de Arquivos de Destino para expandir a respectiva seção.
3. Clique em Adicionar pacote.
4. Na caixa de diálogo exibida, nomeie seu pacote.
5. Especifique a origem e os caminhos de arquivo resultantes. Se necessário, você pode adicionar vários padrões de caminho de origem usando . No painel direito, você pode visualizar a estrutura dos arquivos de origem e tradução com base nos caminhos especificados.
6. (Opcional) Para ignorar algumas pastas ou arquivos, clique em Adicionar padrão ignorado, especifique seu respectivo padrão e o Crowdin ignorará esses arquivos ou pastas específicos durante a geração do pacote. Se necessário, você pode adicionar vários padrões ignorados usando .
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. Leia mais sobre Rótulos.
8. Selecione o formato de arquivo no qual você gostaria que suas strings fossem exportadas. Para adicionar outros formatos, instale os respectivos aplicativos do nosso Marketplace.
   Observação: Você pode selecionar apenas um formato por vez em um único pacote.
9. Clique em Salvar.

Baixando Pacotes Configurados

Para baixar pacotes configurados, siga estas etapas:

1. Abra seu projeto e vá para a guia Traduções.
2. Clique em Pacotes de Arquivos de Destino para expandir a respectiva seção.
3. Clique em Baixar para o pacote necessário.

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. Abra seu projeto e vá para a guia Traduções.
2. Clique em Pacotes de Arquivos de Destino para expandir a respectiva seção.
3. Clique em para o pacote necessário e selecione Editar. Como alternativa, basta clicar duas vezes no pacote necessário.
4. Faça as edições necessárias e clique em Salvar.

Excluindo Pacotes

Para excluir pacotes, siga estas etapas:

1. Abra seu projeto e vá para a guia Traduções.
2. Clique em Pacotes de Arquivos de Destino para expandir a respectiva seção.
3. Clique em em direção ao pacote necessário e selecione Excluir.
4. Confirme a exclusão clicando em Excluir na caixa de diálogo exibida.

Pacotes em Integrações VCS

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

Para configurar uma integração VCS que funcione no Modo de pacotes de arquivos de destino, siga estas etapas:

1. Após selecionar o Modo de pacotes de arquivos de destino e autorizar a conexão com o Crowdin no lado do VCS, selecione o repositório e os branches para as quais deseja enviar as traduções.
2. Clique em para iniciar a configuração do branch selecionado.
3. Na caixa de diálogo Configuração do Branch, especifique o nome preferido para seu arquivo de configuração ou deixe-o como está e clique em Continuar.
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. Para concluir a configuração de integração do VCS, clique em Salvar na caixa de diálogo onde você selecionou seu repositório e branches.

Leia mais sobre como configurar integrações VCS online.

Pacotes na Entrega de Conteúdo OTA

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

1. Abra seu projeto e vá para a guia Traduções.
2. Clique em Entrega de Conteúdo Over-The-Air para expandir a respectiva seção.
3. Adicione uma nova distribuição usando o botão Adicionar distribuição.
4. Na caixa de diálogo exibida, nomeie sua distribuição.
5. Select Target file bundles in the Export options section.
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.
   
8. Copie o hash de distribuição para poder usá-lo para integração.

Leia mais sobre Entrega de Conteúdo OTA.

Pacotes na CLI/API

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

Leia mais sobre Pacotes na CLI.

Leia mais sobre Pacotes na API.