gplay-testers-orchestration

Google Play のテスターオーケストレーション

このスキルを使って、トラックにテスターを割り当て、ビルドをテストファネルに沿って昇格させます。テスターの変更はすべて 編集セッション 内で行い、gplay edits commit の実行後にのみ反映されます。

テストトラック

トラック	種類	テスターの上限	審査	アクセス
internal	内部テスト	100	なし	即時
alpha	クローズドテスト	無制限	なし	数分
beta	オープンまたはクローズドテスト	無制限	なし／あり	数分
カスタムトラック	クローズドテスト	無制限	なし	数分
production	公開	無制限	あり	数日

alpha は公開トラックではなく、クローズドトラック（招待制）です。内部トラックおよびクローズドトラックのテスターは、メールアドレスまたは Google グループで管理します。

テスターコマンド

gplay testers のサブコマンドは3つだけです。testers list はありません。トラックのテスターを一覧表示するには、testers get を使います。

• gplay testers get — トラックのテスターを読み取ります。
• gplay testers update — テスター全体を置き換えます（指定に含まれないメールアドレス／グループは削除されます）。
• gplay testers patch — 既存の設定にマージします（省略したフィールドは保持されます）。

トラックのテスターを一覧表示する（get）

gplay testers get \
  --package com.example.app \
  --edit $EDIT_ID \
  --track alpha

テスターを割り当てる（セット全体を置き換える）

gplay testers update \
  --package com.example.app \
  --edit $EDIT_ID \
  --track alpha \
  --emails "[email protected],[email protected]"

個別のメールアドレスではなく Google グループを指定する場合：

gplay testers update \
  --package com.example.app \
  --edit $EDIT_ID \
  --track alpha \
  --google-groups "[email protected],[email protected]"

既存のテスターを削除せずに追加する（patch）

gplay testers patch \
  --package com.example.app \
  --edit $EDIT_ID \
  --track alpha \
  --emails "[email protected]"

テスターを削除する（update = 減らしたセットに置き換える）

update はリソースを置き換えるため、残したいテスターだけを再度送信します。

CURRENT=$(gplay testers get --package com.example.app --edit $EDIT_ID --track alpha \
  | jq -r '.testers[]?')
KEEP=$(echo "$CURRENT" | grep -v "[email protected]" | paste -sd "," -)

gplay testers update \
  --package com.example.app \
  --edit $EDIT_ID \
  --track alpha \
  --emails "$KEEP"

編集セッション内でテスターを割り当てる（標準的なフロー）

テスターの割り当ては、gplay release のフラグではありません。--testers フラグはどこにもありません。実際の手順は編集セッションです。

# 1. Create an edit
EDIT_ID=$(gplay edits create --package com.example.app | jq -r '.id')

# 2. Upload the build
gplay bundles upload \
  --package com.example.app \
  --edit $EDIT_ID \
  --file app-release.aab

# 3. Assign the release to the track
gplay tracks update \
  --package com.example.app \
  --edit $EDIT_ID \
  --track alpha \
  --releases '[{"versionCodes":["123"],"status":"completed"}]'

# 4. Assign testers to the track
gplay testers update \
  --package com.example.app \
  --edit $EDIT_ID \
  --track alpha \
  --emails "[email protected],[email protected]"

# 5. Commit (nothing applies until this succeeds)
gplay edits commit --package com.example.app --edit $EDIT_ID

クローズドテストトラックを作成する

カスタムのクローズドトラックは編集セッション内で作成し、同じ方法でテスターを割り当てます。

EDIT_ID=$(gplay edits create --package com.example.app | jq -r '.id')

gplay tracks create \
  --package com.example.app \
  --edit $EDIT_ID \
  --track qa-ring

gplay testers update \
  --package com.example.app \
  --edit $EDIT_ID \
  --track qa-ring \
  --emails "[email protected],[email protected]"

gplay edits commit --package com.example.app --edit $EDIT_ID

トラック間でビルドを昇格させる

昇格すると、ソーストラックのバージョンコードが宛先トラックにコピーされます。--rollout はパーセンテージではなく割合（0.0～1.0）です。

# Internal -> closed alpha
gplay promote --package com.example.app --from internal --to alpha

# Closed beta -> production at 10% staged rollout
gplay promote --package com.example.app --from beta --to production --rollout 0.1

エージェントの動作

• testers list サブコマンドはありません。gplay testers get --track <track> を使って、トラックのテスターを読み取ってください。
• gplay release に --testers を指定しないでください。編集セッション内で testers update／patch を使ってテスターを割り当て、その後コミットしてください。
• 正確なテスターセットを設定するには update を、既存のテスターを削除せずに追加するには patch を使ってください。
• --rollout の値は割合です（0.1 = 10％）。範囲は0.0～1.0です。
• 必ず gplay edits commit を実行してください。コミットするまでテスターの変更は反映されません。
• 実行前に --help でフラグを確認してください。