The Bitbucket integration with Localizely allows you to easily sync your translation files between your Bitbucket repository and your Localizely project.
After setting up the integration, you can easily pull the files from Bitbucket using the Localizely web console. You can even automate the pull process through webhooks, which will automatically trigger whenever your development team pushes new code changes to Bitbucket.
Once your translations are complete, you can push them to Bitbucket by creating a pull request. This makes it simple and straightforward to keep your translations up-to-date and synced with your code.
To enable the Bitbucket integration with Localizely, you'll need to have a
localizely.yml configuration file in your Bitbucket repository. This file tells Localizely which files to synchronize and defines which files to import (pull) from and export (push) to Bitbucket.
The following is a minimal configuration file for Flutter projects:
config_version: 1.0 # Only 1.0 available project_id: c776c33e-f428-4c91-87e1-a6a18c1554fe # Your project ID from: https://app.localizely.com/projects file_type: flutter_arb upload: files: # List of files for upload to Localizely. Usually it is just one file used for the main locale - file: lib/l10n/intl_en.arb locale_code: en download: files: # List of files for download from Localizely. - file: lib/l10n/intl_en.arb locale_code: en - file: lib/l10n/intl_de.arb locale_code: de - file: lib/l10n/intl_es.arb locale_code: es
For more detailed information on how to set up your Localizely configuration file, please refer to the documentation.
To integrate Bitbucket with Localizely, you'll need to generate a repository access token from Bitbucket. Simply navigate to bitbucket.org and go to your repository's settings, then click on Access tokens. From there, you can create a new token and give it a name. Be sure to set the access token's scopes to include
Once you have generated the access token, make sure to copy it.
Go to the settings for the Localizely project and select Bitbucket Integration under the Integrations section.
Your access token is safe, it is stored in an encrypted form in our system.
You can pull files from Bitbucket either manually or automatically. The following section will guide you through both options.
Go to Project Settings > Integrations > Bitbucket, and click the Pull now button.
After you've set up the pull functionality, it's a good idea to automate the process by setting up a webhook in Bitbucket. This will ensure that any changes you make in Bitbucket are automatically pulled into Localizely.
To create a webhook, simply navigate to your repository's settings in Bitbucket and go to Webhooks. From there, you can create a new webhook by pasting the Webhook payload URL provided in the Localizely integration configuration. With this webhook in place, you can ensure that your translations are always up-to-date and in sync with your code changes.
Once your translations are complete, simply go to Project Settings > Integrations > Bitbucket in Localizely and click the Push now button.
This will initiate the following actions:
At this point, you can review and merge the pull request in Bitbucket. This will ensure that your translations are pushed back to Bitbucket and integrated into your codebase seamlessly.
Tired of manually editing translation files?
Our platform streamlines software localization for you.