android-release-play
Puts a Pocket Arcade game on Google Play internal testing - AAB via bundleRelease, Play App Signing, upload keystore, versionCode, AAB gate and stamp, Android Publisher API, GP1-GP7. Use when an Android build goes to Google Play or the Play Console. Not for emulator builds (android-emulator-build).
- License 许可
- MIT
- 最近更新
- 2026-11-05
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- android-release-play
- description
- Puts a Pocket Arcade game on Google Play internal testing - AAB via bundleRelease, Play App Signing, upload keystore, versionCode, AAB gate and stamp, Android Publisher API, GP1-GP7. Use when an Android build goes to Google Play or the Play Console. Not for emulator builds (android-emulator-build).
02 资源文件 246
- 资产文件assets/permission-allowlist.json1.8 KB
- 资产文件assets/shared.json412 B
- 参考文档references/failure-playbook.md5.7 KB
- 参考文档references/human-steps.md6.6 KB
- 参考文档references/play-api.md4.6 KB
- 参考文档references/release-pipeline.md6.9 KB
- 参考文档references/signing-and-keys.md5.9 KB
- 脚本scripts/check-lib.mjs44.4 KB
- 脚本scripts/check-release-setup-android.mjs9.5 KB
- 脚本scripts/check-store-aab.mjs16.4 KB
- 脚本scripts/lib/aab.mjs3.4 KB
- 脚本scripts/lib/manifest-tree.mjs1.2 KB
- 脚本scripts/lib/ship-placeholders.mjs15.7 KB
- 脚本scripts/lib/zip.mjs2.6 KB
- 脚本scripts/selftest.mjs5.6 KB
- 脚本templates/packages/shell/plugins/with-upload-signing.ts747 B
- 脚本templates/packages/shell/src/config/upload-signing.test.ts3.3 KB
- 脚本templates/packages/shell/src/config/upload-signing.ts2.6 KB
- 脚本templates/packages/tooling/src/release-android/aab-signing.test.ts3.3 KB
- 脚本templates/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本templates/packages/tooling/src/release-android/play-client.test.ts7.7 KB
- 脚本templates/packages/tooling/src/release-android/play-client.ts8.2 KB
- 脚本templates/packages/tooling/src/release-android/play-credentials.test.ts3.7 KB
- 脚本templates/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本templates/packages/tooling/src/release-android/release-android-plan.test.ts6.7 KB
- 脚本templates/packages/tooling/src/release-android/release-android-plan.ts6.5 KB
- 脚本templates/packages/tooling/src/release-android/release-android.ts8.8 KB
- 脚本templates/packages/tooling/src/release-android/version-code.test.ts1.8 KB
- 脚本templates/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-android-sample-ad-ids/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-android-sample-ad-ids/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-android-sample-ad-ids/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-android-sample-ad-ids/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-android-sample-ad-ids/EXPECT.txt152 B
- 参考文档tests/fixtures/release-setup/bad-android-sample-ad-ids/package.json216 B
- 脚本tests/fixtures/release-setup/bad-android-sample-ad-ids/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-android-sample-ad-ids/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-android-sample-ad-ids/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-android-sample-ad-ids/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-android-sample-ad-ids/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-android-sample-ad-ids/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-credentials-read-elsewhere/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-credentials-read-elsewhere/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-credentials-read-elsewhere/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-credentials-read-elsewhere/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-credentials-read-elsewhere/EXPECT.txt66 B
- 参考文档tests/fixtures/release-setup/bad-credentials-read-elsewhere/package.json216 B
- 脚本tests/fixtures/release-setup/bad-credentials-read-elsewhere/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-credentials-read-elsewhere/packages/tooling/src/release-android/peek.ts208 B
- 脚本tests/fixtures/release-setup/bad-credentials-read-elsewhere/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-credentials-read-elsewhere/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-credentials-read-elsewhere/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-credentials-read-elsewhere/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-credentials-read-elsewhere/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-deny-missing/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-deny-missing/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-deny-missing/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-deny-missing/claude-settings.json69 B
- 参考文档tests/fixtures/release-setup/bad-deny-missing/EXPECT.txt55 B
- 参考文档tests/fixtures/release-setup/bad-deny-missing/package.json216 B
- 脚本tests/fixtures/release-setup/bad-deny-missing/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-deny-missing/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-deny-missing/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-deny-missing/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-deny-missing/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-deny-missing/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-gitignore-secrets/.gitignore75 B
- 脚本tests/fixtures/release-setup/bad-gitignore-secrets/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-gitignore-secrets/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-gitignore-secrets/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-gitignore-secrets/EXPECT.txt55 B
- 参考文档tests/fixtures/release-setup/bad-gitignore-secrets/package.json216 B
- 脚本tests/fixtures/release-setup/bad-gitignore-secrets/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-gitignore-secrets/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-gitignore-secrets/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-gitignore-secrets/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-gitignore-secrets/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-gitignore-secrets/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-keystore-in-repo/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-keystore-in-repo/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-keystore-in-repo/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-keystore-in-repo/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-keystore-in-repo/EXPECT.txt46 B
- 参考文档tests/fixtures/release-setup/bad-keystore-in-repo/package.json216 B
- 脚本tests/fixtures/release-setup/bad-keystore-in-repo/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-keystore-in-repo/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-keystore-in-repo/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-keystore-in-repo/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-keystore-in-repo/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-keystore-in-repo/packages/tooling/src/release-android/version-code.ts1.9 KB
- 参考文档tests/fixtures/release-setup/bad-keystore-in-repo/plant.json72 B
- 其他tests/fixtures/release-setup/bad-keystore-path-in-repo/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-keystore-path-in-repo/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-keystore-path-in-repo/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-keystore-path-in-repo/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-keystore-path-in-repo/EXPECT.txt71 B
- 参考文档tests/fixtures/release-setup/bad-keystore-path-in-repo/package.json216 B
- 脚本tests/fixtures/release-setup/bad-keystore-path-in-repo/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-keystore-path-in-repo/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-keystore-path-in-repo/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-keystore-path-in-repo/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-keystore-path-in-repo/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-keystore-path-in-repo/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-npm-script-missing/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-npm-script-missing/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-npm-script-missing/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-npm-script-missing/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-npm-script-missing/EXPECT.txt26 B
- 参考文档tests/fixtures/release-setup/bad-npm-script-missing/package.json129 B
- 脚本tests/fixtures/release-setup/bad-npm-script-missing/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-npm-script-missing/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-npm-script-missing/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-npm-script-missing/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-npm-script-missing/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-npm-script-missing/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-npm-script-target-missing/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-npm-script-target-missing/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-npm-script-target-missing/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-npm-script-target-missing/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-npm-script-target-missing/EXPECT.txt69 B
- 参考文档tests/fixtures/release-setup/bad-npm-script-target-missing/package.json216 B
- 脚本tests/fixtures/release-setup/bad-npm-script-target-missing/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-npm-script-target-missing/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-npm-script-target-missing/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-npm-script-target-missing/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-npm-script-target-missing/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-owner-placeholders/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-owner-placeholders/apps/line-siege/game.config.ts2.5 KB
- 参考文档tests/fixtures/release-setup/bad-owner-placeholders/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-owner-placeholders/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-owner-placeholders/EXPECT.txt149 B
- 参考文档tests/fixtures/release-setup/bad-owner-placeholders/package.json216 B
- 脚本tests/fixtures/release-setup/bad-owner-placeholders/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-owner-placeholders/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-owner-placeholders/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-owner-placeholders/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-owner-placeholders/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-owner-placeholders/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-release-file-missing/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-release-file-missing/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-release-file-missing/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-release-file-missing/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-release-file-missing/EXPECT.txt68 B
- 参考文档tests/fixtures/release-setup/bad-release-file-missing/package.json216 B
- 脚本tests/fixtures/release-setup/bad-release-file-missing/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-release-file-missing/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-release-file-missing/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-release-file-missing/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-release-file-missing/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/release-setup/bad-shell-slice/.gitignore101 B
- 脚本tests/fixtures/release-setup/bad-shell-slice/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/bad-shell-slice/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/bad-shell-slice/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/bad-shell-slice/EXPECT.txt31 B
- 参考文档tests/fixtures/release-setup/bad-shell-slice/package.json216 B
- 脚本tests/fixtures/release-setup/bad-shell-slice/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/bad-shell-slice/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/bad-shell-slice/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/bad-shell-slice/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/bad-shell-slice/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/bad-shell-slice/packages/tooling/src/release-android/version-code.ts1.9 KB
- 参考文档tests/fixtures/release-setup/bad-shell-slice/shell-slice.json40 B
- 参考文档tests/fixtures/release-setup/error-nothing-to-check/EXPECT.txt35 B
- 参考文档tests/fixtures/release-setup/error-nothing-to-check/notes.txt11 B
- 其他tests/fixtures/release-setup/good/.gitignore101 B
- 脚本tests/fixtures/release-setup/good/apps/line-siege/game.config.ts2.8 KB
- 参考文档tests/fixtures/release-setup/good/apps/line-siege/package.json46 B
- 参考文档tests/fixtures/release-setup/good/claude-settings.json237 B
- 参考文档tests/fixtures/release-setup/good/package.json216 B
- 脚本tests/fixtures/release-setup/good/packages/tooling/src/release-android/aab-signing.ts3.2 KB
- 脚本tests/fixtures/release-setup/good/packages/tooling/src/release-android/play-client.ts6.7 KB
- 脚本tests/fixtures/release-setup/good/packages/tooling/src/release-android/play-credentials.ts3.0 KB
- 脚本tests/fixtures/release-setup/good/packages/tooling/src/release-android/release-android-plan.ts6.8 KB
- 脚本tests/fixtures/release-setup/good/packages/tooling/src/release-android/release-android.ts9.2 KB
- 脚本tests/fixtures/release-setup/good/packages/tooling/src/release-android/version-code.ts1.9 KB
- 其他tests/fixtures/store-aab/bad-admob-placeholder-unit-per-platform/app-release.aab1.9 KB
- 参考文档tests/fixtures/store-aab/bad-admob-placeholder-unit-per-platform/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-admob-placeholder-unit-per-platform/EXPECT.txt179 B
- 参考文档tests/fixtures/store-aab/bad-admob-placeholder-unit-per-platform/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-debug-signed/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/bad-debug-signed/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-debug-signed/EXPECT.txt16 B
- 参考文档tests/fixtures/store-aab/bad-debug-signed/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-debuggable/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/bad-debuggable/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-debuggable/EXPECT.txt13 B
- 参考文档tests/fixtures/store-aab/bad-debuggable/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-no-android-ad-ids/app-release.aab1.7 KB
- 参考文档tests/fixtures/store-aab/bad-no-android-ad-ids/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-no-android-ad-ids/EXPECT.txt45 B
- 参考文档tests/fixtures/store-aab/bad-no-android-ad-ids/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-permission/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/bad-permission/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-permission/EXPECT.txt49 B
- 参考文档tests/fixtures/store-aab/bad-permission/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-sample-ad-id/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/bad-sample-ad-id/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-sample-ad-id/EXPECT.txt12 B
- 参考文档tests/fixtures/store-aab/bad-sample-ad-id/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-sample-ad-unit-live/app-release.aab1.9 KB
- 参考文档tests/fixtures/store-aab/bad-sample-ad-unit-live/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-sample-ad-unit-live/EXPECT.txt197 B
- 参考文档tests/fixtures/store-aab/bad-sample-ad-unit-live/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-shell-slice/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/bad-shell-slice/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-shell-slice/EXPECT.txt14 B
- 参考文档tests/fixtures/store-aab/bad-shell-slice/shell-slice.json40 B
- 参考文档tests/fixtures/store-aab/bad-shell-slice/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-target-sdk/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/bad-target-sdk/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-target-sdk/EXPECT.txt13 B
- 参考文档tests/fixtures/store-aab/bad-target-sdk/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-test-code-shipped/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/bad-test-code-shipped/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-test-code-shipped/EXPECT.txt45 B
- 参考文档tests/fixtures/store-aab/bad-test-code-shipped/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-unsigned-rehearsal-owner-placeholders/app-release.aab1.3 KB
- 参考文档tests/fixtures/store-aab/bad-unsigned-rehearsal-owner-placeholders/args.json106 B
- 参考文档tests/fixtures/store-aab/bad-unsigned-rehearsal-owner-placeholders/EXPECT.txt110 B
- 参考文档tests/fixtures/store-aab/bad-unsigned-rehearsal-owner-placeholders/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-unsigned/app-release.aab1.4 KB
- 参考文档tests/fixtures/store-aab/bad-unsigned/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-unsigned/EXPECT.txt10 B
- 参考文档tests/fixtures/store-aab/bad-unsigned/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-version-code-not-build/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/bad-version-code-not-build/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-version-code-not-build/EXPECT.txt15 B
- 参考文档tests/fixtures/store-aab/bad-version-code-not-build/tags.txt40 B
- 其他tests/fixtures/store-aab/bad-version-code-reused/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/bad-version-code-reused/args.json94 B
- 参考文档tests/fixtures/store-aab/bad-version-code-reused/EXPECT.txt36 B
- 参考文档tests/fixtures/store-aab/bad-version-code-reused/tags.txt21 B
- 参考文档tests/fixtures/store-aab/error-no-aab/ARGS.txt113 B
- 参考文档tests/fixtures/store-aab/error-no-aab/EXPECT.txt35 B
- 参考文档tests/fixtures/store-aab/error-no-aab/tags.txt20 B
- 其他tests/fixtures/store-aab/good/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/good/args.json94 B
- 参考文档tests/fixtures/store-aab/good/tags.txt40 B
- 其他tests/fixtures/store-aab/pass-owner-values-per-platform/app-release.aab1.8 KB
- 参考文档tests/fixtures/store-aab/pass-owner-values-per-platform/args.json94 B
- 参考文档tests/fixtures/store-aab/pass-owner-values-per-platform/EXPECT.txt13 B
- 参考文档tests/fixtures/store-aab/pass-owner-values-per-platform/tags.txt40 B
- 其他tests/fixtures/store-aab/pass-unsigned-rehearsal/app-release.aab1.3 KB
- 参考文档tests/fixtures/store-aab/pass-unsigned-rehearsal/args.json106 B
- 参考文档tests/fixtures/store-aab/pass-unsigned-rehearsal/EXPECT.txt45 B
- 参考文档tests/fixtures/store-aab/pass-unsigned-rehearsal/tags.txt40 B
03 SKILL.md 正文
Android release to Google Play
Takes one commit of apps/<game> to a signed Android App Bundle on the Google Play internal testing track, with npm run release:android and nothing but node, Gradle and the owner's service account. Before anything reaches Google, the store-AAB gate proves what players would receive: the upload key's signature, a fresh versionCode, no test code, the game's own AdMob id, the allowed permissions. Everything that needs a person is asked for, never worked around.
Rules that must hold
- Nothing leaves this Mac without the owner's word in this session. An upload, a tag push or a track change cannot be undone; ask first, and only ever write the internal track.
- The upload key lives outside the repo (
~/.android-keys/<game>-upload.jks, mode 600) with its passwords in~/.gradle/gradle.properties, and is never opened, printed, copied, committed or logged; Google holds the app-signing key (Play App Signing). Whoever holds the upload key can upload builds as us; only Gradle reads it, through the game's ownE07_<GAME>_UPLOAD_*properties. - The service-account JSON is treated exactly like the
.p8: onlyplay-credentials.tsreads it, once, into memory. A leaked service-account key can release apps; the parsed account exposes an e-mail and a sign function, never the key, and no error quotes it. - Build only with
bundleRelease, throughnpm run release:android -- --app <game> --track internal, from a cleanmainafternpm run verify, with green Android E2E and screenshots of the same commit. The pipeline commits the build number before it builds, so only a reviewed, proven commit may start it. - The build number is shared with iOS and equals
versionCode; it is never reused or rolled back. Google refuses a used versionCode for good, and one sequence keeps every<game>/vX.Y.Z+<n>tag unique across both platforms. check-store-aab.mjspasses on the exact bytes before any upload; uploads go only to the internal track, and promotion is the owner's. The gate writes a stamp with the AAB's sha256 only on a PASS, and--resume uploadrefuses anything else, so an unchecked or changed bundle never leaves.- The first upload of a new app is the owner's, in the Play Console. The API cannot create an app, and while the app is a draft Google refuses a completed release:
release:androidstops withdraft-app(never retried, never resent as a draft) and the owner uploads the gated AAB in the Console (GP7). - Stop and ask, never retry, on 401 or 403, an app that is not found, a draft app (
draft-app), the API not enabled, missing policy declarations, or a used version code. Each needs a person or a new number; a retry can lock the service account or burn numbers. - Owner steps never block (O6), and a keyless rehearsal is never release evidence. Until O10 and GP1-GP7 are done, the release ends with the rehearsal (
--unsignedprintsREHEARSAL: not a release gate) and a slice report; the gates end withowner-placeholderlines andOWNER STEPS PENDING: G3, GP5by design.
Workflow
-
Before the first release in a repo: read references/human-steps.md (O10 and GP1-GP7 with click paths) and references/signing-and-keys.md (the two keys, generating the upload key with keytool, the Gradle properties, the service-account key, the leak response). Ask the owner for every missing step in one message with its default (git-commits-and-reporting's request form).
-
Install the templates (each to the same path in the repo; the first line names it). This is Android step 8 of pocket-arcade-index's Android order:
Template Goes to templates/packages/tooling/src/release-android/same path: release-android.ts(the CLI),release-android-plan.ts,version-code.ts,aab-signing.ts,play-credentials.ts,play-client.ts, each with its testtemplates/packages/shell/src/config/upload-signing.ts+upload-signing.test.tssame paths ( addUploadSigning, the release signing config); already copied at Android step 2 withwithShelltemplates/packages/shell/plugins/with-upload-signing.tssame path, already copied at Android step 2: withShell's Android plugins list it as['@e07/shell/plugins/with-upload-signing.ts', { game: game.id }](architecture-and-boundaries ownswithShell)Copy each test before its module against a typed stub and see it fail on an assertion (tdd-workflow). They reuse
build/game-id.ts,release/build-number.ts,ios/tool-step.ts,clock/system-clock.tsandroid-emulator-build'sandroid/toolchain.tsandbuild/emu-build-plan.ts, and admob-ads'packages/shell/src/config/ads-config.ts(isGoogleSampleAdId: Google's sample ids are no owner value, so they leave GP5 pending). Root script, byte for byte:"release:android": "node packages/tooling/src/release-android/release-android.ts". Thennpm run -s check:fast. -
Check the setup:
node ${CLAUDE_SKILL_DIR}/scripts/check-release-setup-android.mjs .from the repo root. Fix everyFAILline and rerun. Until the owner supplies G3 and GP5 it ends with theowner-placeholderlines,OWNER STEPS PENDING: G3, GP5andRESULT: FAIL, by design; any other FAIL line is real. -
Without the owner's key or ids yet, rehearse: references/release-pipeline.md, "Rehearsal without the owner's key", builds a store/off bundle and runs
check-store-aab.mjs --unsigned; it uploads nothing, proves everything but the signature, and hands over with a slice report. -
Build: with the owner's go,
npm run release:android -- --app <game> --notes "<what testers should check>". It runs the preflight, commits the next build number, prebuilds the store/live variant, runsbundleReleaseand prints the gate command. Read the release-pipeline reference for each step and how to run one by hand. -
Gate:
node ${CLAUDE_SKILL_DIR}/scripts/check-store-aab.mjs --aab apps/<game>/android/app/build/outputs/bundle/release/app-release.aab --variant store --ads live --version <x.y.z> --build <n> --game <game> --stamp apps/<game>/build/release/aab-gate.json .must printRESULT: PASS(it writes the stamp only then). -
Upload: with the owner's word in this session,
npm run release:android -- --app <game> --resume upload. The calls are in references/play-api.md. The first upload of a new app is the owner's (GP7). -
On any failure, match the message in references/failure-playbook.md. A stop goes to the owner as one message (step, the exact error line, the one action); never retry it.
-
Report: the release report (git-commits-and-reporting): game, version, versionCode, the gate's RESULT line, the track and the local tag, one question, and "Owner steps (not blocking)": the Android play-test with the purchase test, TalkBack, the fa and ckb review, the sound previews.
Definition of done
- [ ] The owner agreed to the upload in this session; nothing was pushed, promoted or submitted without their word.
- [ ]
release:androidran from a cleanmainafter a greenverify: build number committed, bundle built withbundleRelease, gate passed with a stamp, uploaded to the internal track, tag created locally. - [ ] No key, password, JSON or token appears in the repo, a log or the report; the keystore and the JSON were never opened.
- [ ] Before the owner's steps: the rehearsal printed
REHEARSAL: not a release gate, and the report is a slice report listing O10 and GP1-GP7 under "Owner steps (not blocking)". - [ ]
node ${CLAUDE_SKILL_DIR}/scripts/check-store-aab.mjs --aab <aab> --variant store --ads live --version <x.y.z> --build <n> --game <game> .printsRESULT: PASSwithout--unsigned. - [ ]
node ${CLAUDE_SKILL_DIR}/scripts/check-release-setup-android.mjs .printsRESULT: PASS, or onlyowner-placeholderlines, thenOWNER STEPS PENDING: ..., while the owner's steps are pending
Anti-patterns
keytool -list -keystore ~/.android-keys/..."to check the key". That opens it; check its place and mode withstat, and who signed a bundle withkeytool -printcert -jarfile <aab>.- Passing the store password with
-Pandroid.injected.signing.store.password=.... It lands in the process list and logs; Gradle reads the game's properties from~/.gradle/gradle.propertiesby itself. - Retrying the upload after a 403. It needs the owner (GP3); send the stop message and wait.
- Lowering
buildNumberafter "version code already used". A number is spent; a new run takes the next one. - Uploading a bundle the gate never saw, or one rebuilt after the gate. The stamp's sha256 refuses it; run the gate on these bytes.
- Writing the production, beta or alpha track. Promotion is the owner's in the Play Console.
- Citing a
--unsignedrun as the store gate. It is a rehearsal; the report puts it under "Not tested or not verified". - Typing stand-in AdMob ids to get past
owner-placeholder. The ids come from the owner (GP5); until then the FAIL is the expected result.
Files in this skill
| File | What it is | Read/run when |
|---|---|---|
| references/human-steps.md | O10 and GP1-GP7 with click paths, the order, what the owner sends back, the owner's own checks | Workflow step 1, and before asking the owner |
| references/signing-and-keys.md | Play App Signing's two keys, generating the upload key, the Gradle properties, the release signing config, the service-account key, what may be done, the leak response | Workflow step 1, and on any signing error |
| references/release-pipeline.md | Run 1 (build), the gate, run 2 (upload), steps by hand, the keyless rehearsal, numbers, tags, resuming | Workflow steps 4-7 |
| references/play-api.md | The JWT and token, the four edit calls, the answers and stops, what the API cannot do | Workflow step 7, and when an upload stops |
| references/failure-playbook.md | Symptom, cause and action for setup, build, gate, upload and after-upload failures | Workflow step 8 |
templates/packages/tooling/src/release-android/ |
The CLI and its five tested modules: plan (args, preflight, stamp, owner steps), version code, signing paths, credentials, Play client | Workflow step 2 |
templates/packages/shell/src/config/ |
upload-signing.ts (the release signing config for app/build.gradle) and its test |
Workflow step 2 |
templates/packages/shell/plugins/with-upload-signing.ts |
The config plugin that applies it at prebuild | Workflow step 2 |
scripts/check-release-setup-android.mjs |
Checks the repo: script and tooling, the upload key outside the repo, secrets ignored and denied, the service-account file read in one place, owner values (G3, GP5), a complete Shell | Workflow step 3 and the definition of done |
scripts/check-store-aab.mjs |
The store-AAB gate: signature, versionCode against the tags, package, test code, variant, AdMob id, owner placeholders, permissions, debuggable, target SDK, Shell; --unsigned for the rehearsal, --stamp after a PASS |
Workflow step 6 and the definition of done |
scripts/lib/aab.mjs |
The protobuf manifest decoder and the signature check | Never by hand |
scripts/lib/zip.mjs |
Zip reader (node:zlib) for AABs and APKs (synced from the library, the same reader android-emulator-build uses; do not edit here) | Never by hand |
scripts/lib/manifest-tree.mjs |
findElements and metaDataValue over a parsed manifest tree (synced from the library; do not edit here) |
Never by hand |
scripts/lib/ship-placeholders.mjs |
The placeholders a ship gate refuses, with their owner steps (G3, G5, GP5) and the OWNER STEPS PENDING line (synced from the library; do not edit here) |
Never by hand |
assets/permission-allowlist.json |
The permissions a Pocket Arcade bundle may hold, each with who declares it (synced from the library, the same list android-emulator-build and privacy-and-network-audit check; do not edit here) | When check-store-aab reports permission |
scripts/selftest.mjs |
Proves the stamp and both checkers on good fixtures and every planted bug (settings and key files planted in a temporary copy) | After changing a checker, the allowlist or a template |
scripts/check-lib.mjs |
Shared script helper, synced from the library (do not edit here) | Never by hand |
assets/shared.json |
Declares the shared files this skill copies in | When adding a shared file |
tests/fixtures/ |
release-setup/ repo trees and store-aab/ bundles with their tags and flags |
When adding a rule to a checker |
Related skills
android-emulator-build- the toolchain, the variants and the emulator builds a release is proven on first.ios-release-testflight- the iOS twin; the build number and the placeholders are shared.premium-purchase- the Premium product on Google Play (GP6) and billing on Android.privacy-and-network-audit- the Data safety answers (GP4) and the key-safety audit.admob-ads- the AdMob Android app and its units (GP5).git-commits-and-reporting- the build commits, tags, the release report and stop messages.
04 同仓库更多 Skills
unit-and-component-tests
Sets up Jest and writes Pocket Arcade test code - three projects, RNTL 14 async via renderWithShell, root SDK mocks, fakes, fast-check, coverage, Stryker. Use when a test needs the Shell wrapper, a mock or a fake, or Jest fails. Not for the red-green loop (tdd-workflow) or goldens (golden-tests).
typescript-and-lint-rules
Enforces Pocket Arcade's strict TypeScript 6 tsconfigs, ESLint 9 flat config, Prettier and size limits. Use when writing or splitting .ts/.tsx or fixing a tsc or lint error. Not for gate wiring (quality-gates), names (naming-conventions) or import zones (architecture-and-boundaries).
demo-skill
Builds a demo. Use when testing the pitfall checker.
demo-skill
Builds a demo. Use when testing the pitfall checker.
troubleshooting-playbook
Diagnoses and fixes Pocket Arcade failures with a catalogue of 300+ known ones (symptom, cause, fix). Use when something errors, crashes, hangs or renders wrong, or an error or log needs explaining. Not for gate setup (quality-gates) or running builds (ios-simulator-build, ios-release-testflight).
toybox-visual-parity
Proves a built Pocket Arcade screen matches its Toybox design screenshot (light/dark, en/fa) and drives the fixes: capture, element gates, sheets, sign-off. Use when any screen is built or changed, or for visual parity, design match, screenshot compare. Not for building screens (toybox-screens).