asc-app-wall

asc app-wall — 将你的 App 提交到 App Wall

通过派生 tddworks/asc-cli、将你的条目添加到 homepage/apps.json 并创建拉取请求，一条命令即可将你的 App 添加到社区展示页 asccli.app/#app-wall。

无需进行 ASC 身份验证，只需要 GitHub 令牌。

命令

asc app-wall submit [options]

标志	必填	说明
--developer	—	卡片上显示的名称；未指定时使用 iTunes 艺术家名称
--developer-id	✓*	Apple 开发者/卖家 ID — 自动获取你的所有 App Store 应用
--app-id	✓*	App Store Connect 应用 ID（可重复指定）
--github	—	GitHub 用户名
--x	—	X/Twitter 用户名
--app	✓*	指定的 App Store URL（多个应用可重复指定）
--github-token	—	GitHub 令牌（或设置 GITHUB_TOKEN / gh auth login）

✓* 必须至少指定 --developer-id、--app-id 或 --app 中的一项 — 否则没有应用可展示在墙上。

典型工作流

# 1. Authenticate with GitHub (once)
gh auth login
# or: export GITHUB_TOKEN="ghp_..."

# 2. Submit — the CLI handles fork + commit + PR automatically
asc app-wall submit \
  --developer "yourhandle" \
  --developer-id "1234567890" \
  --github "yourgithub" \
  --x "yourx" \
  --pretty

# 3. Open the PR in your browser (URL is in the output)
open "https://github.com/tddworks/asc-cli/pull/<number>"

两种提交模式

模式 A — 通过开发者 ID 提交所有应用（推荐）：

asc app-wall submit \
  --developer "itshan" \
  --developer-id "1725133580" \
  --github "hanrw"

在 https://apps.apple.com/us/developer/name/id<NUMBER> 中查找你的 Apple 开发者 ID。

模式 B — 指定 App Store URL：

asc app-wall submit \
  --developer "itshan" \
  --app "https://apps.apple.com/us/app/my-app/id123456789" \
  --app "https://apps.apple.com/us/app/other-app/id987654321"

两种模式可以在同一条命令中组合使用。

JSON 输出

{
  "data": [
    {
      "affordances": {
        "openPR": "open https://github.com/tddworks/asc-cli/pull/42"
      },
      "developer": "itshan",
      "id": "42",
      "prNumber": 42,
      "prUrl": "https://github.com/tddworks/asc-cli/pull/42",
      "title": "feat(app-wall): add itshan"
    }
  ]
}

底层执行步骤

1. 使用你的令牌通过 GitHub 身份验证
2. 派生 tddworks/asc-cli（幂等操作，可安全重复运行）
3. 将派生仓库与上游 main 同步
4. 从你的派生仓库获取当前的 homepage/apps.json
5. 检查是否存在重复条目（developer 字段）
6. 创建分支 app-wall/<developer>
7. 将更新后的 apps.json 提交到该分支
8. 向 tddworks/asc-cli:main 创建 PR

错误情况

错误	原因	解决方法
Provide --developer-id or at least one --app URL	未提供这两个标志中的任何一个	添加 --developer-id 或 --app
GitHub token required	未找到令牌	传入 --github-token、设置 GITHUB_TOKEN 或运行 gh auth login
Developer X is already listed	apps.json 中存在重复的 developer	条目已提交；请检查现有 PR
Timed out waiting for fork	派生仓库创建耗时超过 24 秒	稍后重试
GitHub API error (422)	分支已存在	可安全忽略 — 命令会继续执行

apps.json 格式

添加到 homepage/apps.json 的条目：

{
  "developer": "yourhandle",
  "developerId": "1234567890",
  "github": "yourgithub",
  "x": "yourx"
}

空字段会自动省略。PR 合并后，fetch-apps-data.js 会重新生成 apps-data.json，从 iTunes API 获取你的应用。

另请参阅

• 完整功能文档：docs/features/app-wall.md
• App Wall 在线页面：https://asccli.app/#app-wall
• 上游仓库：https://github.com/tddworks/asc-cli