Локализация, не задерживающая релиз
Скорее всего, самая большая проблема непрерывной локализации в том, что довольно часто приходится отложить релиз приложения до момента перевода всех новых текстов. Управление версиями в Crowdin значительно сокращает задержки. Эта функция также очень полезна для проектов с несколькими версиями.
Типичный процесс локализации приложения
Наиболее популярный подход локализации приложений выглядит следующим образом:
- Разработчики работают над изменениями в собственной ветке;
- Ветка объединяется с master или другой предрелизной веткой, похожей на master и остается там до момента полного перевода всех новых текстов.
Проблема №1
В большинстве случаев, приложение разрабатывается одновременно несколькими разработчиками. Они работают в разных ветках системы контроля версий (GIT). Классический процесс локализации выглядит следующим образом: новые тексты загружаются из master ветки на сервер перевода.
Все тексты из ветки №1 и ветки №2 отправляются на сервер перевода только после их объединения с master веткой, вместо того чтобы переводиться сразу.
Решение
With the new approach, the translation can start immediately after new texts appear in any of the code branches. When the feature branch is being merged to the pre-release or master branch, the translations for new texts will be ready for deployment.
Implementation in Crowdin
When your translators work on the project with all of the branches uploaded to Crowdin, the platform will highlight only the branches different to them. This means that translators will not translate the duplicates.
Start Using
To enable branches translation feature in your project, please, change the following setting via the Project Settings, General tab.
Any source text is considered as duplicate if there is the same text in the different version of the file (different branch), and it won’t be displayed to a translator. Being translated once, duplicated texts in other branches are populated with that translation automatically.
Version Branch Creation
In general, a branch in Crowdin is a regular directory marked with a special icon and behavior with duplicated strings. Branches can be created via the Project Settings, Files tab or via [API]/[Synchronization tool] (recommended).
If you use GitHub, Bitbucket or other VCS integration, selected for localization branches will be created in Crowdin automatically.
The example of a files structure in version control system and Crowdin:
Important! Project’s root directory also behaves with the duplicates as a separate version branch. You can store, for example, master’s files directly in project’s root, without placing them to a separate directory marked as a version branch.
Creating Branches via API
To create a branch via API, use the Add Directory method with is_branch=1 parameter:
Add File, Update File, Upload Translations and other methods that manipulate files and folders work with branch={branch_name} parameter.
Managing Branches with Synchronization Tool
There is no need to run a specific command to create version branches if the synchronization tool is used. The version branch would be created automatically while files uploading. Example of the source files/translations upload to the specified version branch:
$ crowdin-cli upload sources -b branch_name
$ crowdin-cli upload translations -b branch_nameTranslations Export
Translations from all version branches are placed in one ZIP archive if they are downloaded through the web interface. Use the synchronization tool or API to download the version branches translations individually.
Translations Export via API
Export translations of the specified version branch:
Download translations of the specified version branch:
Translations Export via Synchronization Tool
Download translations of the specified version branch:
$ crowdin-cli download -b branch_nameMerging Branches
Once the feature development is finished, an engineer merges the version branch with a master branch in the VCS. Consequently, the master branch will contain new texts from the feature branch. While synchronizing with Crowdin, all of the texts in the master branch are populated with translations made earlier in the appropriate branch.
After a sync of the updated master with Crowdin, the feature branch can be removed from Crowdin - translations stored in the master branch will remain.
Recommended Workflow
The new workflow Crowdin recommends to implement:
It’s important to re-think and discuss the new workflow with the development team. The important thing to implement within the team is the agreement not to commit texts that probably will not go to the production.
GitHub Workflow & Crowdin
You can deploy your changes in the feature branch to verify them on production.
