CLIクライアントを使用して、CI環境内から翻訳を同期します。
StringsをCI環境にダウンロードするには、次のステップに従います。
-
.phrase.yml設定ファイルを作成します。 -
新しいbashスクリプトまたはステップをCIに追加します。
-
新しいStringsをアップロードするには、このコマンドをスクリプトに追加します。
#!/bin/bash # .phrase.ymlで設定した通りに新しいStringsをPhraseにアップロードする phrase push
新しい値を追加するだけでなく、既存の値を更新する場合も想定している場合は、
update_translationまたはupdate_descriptionパラメータが設定されていることを確認してください。 -
翻訳されたStringsを現在のワークスペースにダウンロードするには、次のコマンドを追加します。
#!/bin/bash # .phrase.ymlで設定した通りにPhraseから新しいStringsを取得する phrase pull
tagsを使用して正しい keys が含まれていることを確認し、検証済みおよび翻訳済みのエントリに必要なオプションも確認してください。
-
webhookを登録して、必要なイベントのサブスクリプション登録する。
ウェブフックは、メジャーなイベント(処理されたアップロードや完了したオーダーなど)で利用できます。一般的なワークフローは、Slackチャンネルで新しく作成されたコメントの注意を設定することや、ジョブ完了のためのインポートスクリプトを設定することです。
APIを使用して、更新サイクルに応じてこれらのアイテムの現在の状態をクエリすることもできます。
-
ブランチ機能
Phrase Stringsには、Gitブランチの一般的なアプリケーションとは異なる、バージョン管理のためのbranchingコンセプトがあります。Phrase ブランチは Git ブランチと併用できます。そのブランチの構成ファイルでブランチ名を確認し、その中で CI ステップを実行します。
機能を追加する際、翻訳は通常、既存のものを削除せずに追加されます。作業ブランチにタグを追加してメインブランチにアップロードすることで、共有キーによる機能の追跡が可能になるだけでなく、翻訳者を混乱させることなく特定のサブセットでのプルやテストも可能になります。