CLI クライアントを使用して、CI環境内から翻訳を同期します。
CI環境にStringsをダウンロードするには、次のステップに従ってください。
-
.phrase.yml設定ファイルを作成します。 -
CIに新しいbashスクリプトまたはステップを追加します。
-
新しい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 ステップを実行します。
機能を追加する際、翻訳は通常、既存のものを削除せずに追加されます。作業ブランチにタグを追加してメインブランチにアップロードすることで、共有キーによる機能の追跡だけでなく、翻訳者を混乱させることなく特定のサブセットでのプルやテストが可能になります。