play-developer-console

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Play Developer Console

Google Play开发者控制台

Use the local Bun TypeScript CLI at:

bash

/Users/jyo/projects/tools/play-cli

The CLI is linked locally with Bun and exposes:

bash

play --help

For Moshi Android, run commands from:

bash

/Users/jyo/projects/ai/moshi/marketing

The Play assets live in:

bash

play/
  .env
  metadata/
  images/
  release-notes/

使用本地的Bun TypeScript CLI，路径为：

bash

/Users/jyo/projects/tools/play-cli

该CLI通过Bun本地链接，可执行以下命令查看帮助：

bash

play --help

针对Moshi Android应用，需在以下目录运行命令：

bash

/Users/jyo/projects/ai/moshi/marketing

Play Store相关资源存放在：

bash

play/
  .env
  metadata/
  images/
  release-notes/

Workflow

工作流程

Inspect
```
play/CLAUDE.md
```
and relevant local files before changing store assets.
Run one Play edit-backed command at a time. Do not parallelize
```
play metadata
```
,
```
play app-info
```
,
```
play images
```
,
```
play bundle
```
, or
```
play tracks
```
commands.
Validate local listing text before upload:

bash

play metadata validate

Use read-only checks before and after changes:

bash

play metadata list
play app-info show
play tracks list --json
play tracks show production --json
play reviews list --limit 5

修改商店资源前，请先查看
```
play/CLAUDE.md
```
及相关本地文件。
每次仅运行一个基于Play编辑会话的命令。请勿并行执行
```
play metadata
```
、
```
play app-info
```
、
```
play images
```
、
```
play bundle
```
或
```
play tracks
```
命令。
上传前验证本地列表文本：

bash

play metadata validate

在修改前后执行只读检查：

bash

play metadata list
play app-info show
play tracks list --json
play tracks show production --json
play reviews list --limit 5

Release Workflow

发布工作流程

Use the built-in track commands for release operations. Do not write ad hoc scripts against

src/api.ts

for normal release tasks.

Attach or update a release already uploaded to Play:

bash

play tracks release internal \
  --version-code 6 \
  --status completed \
  --name "Moshi 2.8.2" \
  --notes en-US=play/release-notes/en-US.txt

Prepare a production draft with release notes:

bash

play tracks release production \
  --version-code 6 \
  --status draft \
  --name "Moshi 2.8.2" \
  --notes en-US=play/release-notes/en-US.txt

If a draft app has stale releases that block validation, clear the track first, then create the intended release:

bash

play tracks clear internal
play tracks release internal --version-code 6 --status draft --name "Moshi 2.8.2"

When no

--notes

flag is provided,

play tracks release

reads all files in

play/release-notes/

as localized release notes. Use

--no-notes

only when intentionally omitting notes.

For bugs or missing Play API behavior, patch
```
/Users/jyo/projects/tools/play-cli
```
, then run:

bash

cd /Users/jyo/projects/tools/play-cli
bun run typecheck
bun test

Retry from

/Users/jyo/projects/ai/moshi/marketing

after the fix.

使用内置的track命令执行发布操作。日常发布任务请勿针对

src/api.ts

编写临时脚本。

附加或更新已上传至Play Store的版本：

bash

play tracks release internal \
  --version-code 6 \
  --status completed \
  --name "Moshi 2.8.2" \
  --notes en-US=play/release-notes/en-US.txt

准备带发布说明的生产环境草稿：

bash

play tracks release production \
  --version-code 6 \
  --status draft \
  --name "Moshi 2.8.2" \
  --notes en-US=play/release-notes/en-US.txt

如果草稿应用存在过期版本导致验证受阻，请先清空发布轨道，再创建目标版本：

bash

play tracks clear internal
play tracks release internal --version-code 6 --status draft --name "Moshi 2.8.2"

若未提供

--notes

参数，

play tracks release

会读取

play/release-notes/

目录下的所有文件作为多语言发布说明。仅当有意省略说明时才使用

--no-notes

参数。

若遇到Play API相关的bug或功能缺失，请修改
```
/Users/jyo/projects/tools/play-cli
```
，然后运行：

bash

cd /Users/jyo/projects/tools/play-cli
bun run typecheck
bun test

修复完成后，回到

/Users/jyo/projects/ai/moshi/marketing

目录重试操作。

Auth

认证

Moshi uses keyless local auth via

gcloud

ADC and a quota project in

play/.env

. Do not create or require service account JSON keys unless the user explicitly asks.

Expected env keys:

bash

PLAY_AUTH_MODE=gcloud
PLAY_QUOTA_PROJECT=play-cli-moshi-260429103059
PLAY_PACKAGE_NAME=app.getmoshi.android

Moshi通过

gcloud

ADC及

play/.env

中的配额项目实现无密钥本地认证。除非用户明确要求，否则请勿创建或要求使用服务账号JSON密钥。

预期的环境变量：

bash

PLAY_AUTH_MODE=gcloud
PLAY_QUOTA_PROJECT=play-cli-moshi-260429103059
PLAY_PACKAGE_NAME=app.getmoshi.android