华为 AppGallery Connect

August 15, 2026 · View on GitHub

English | 简体中文

fastforge appgallery 直接调用 AppGallery Connect Publishing API。生成的客户端覆盖应用查询与元数据、软件包查询、上传准备和提交审核。

认证

华为目前推荐 Service Account。将 APP_GALLERY_SERVICE_ACCOUNT_JSON 设置为下载的凭证 JSON 内容或文件路径:

export APP_GALLERY_SERVICE_ACCOUNT_JSON=/secure/appgallery-private.json

也可以使用仅表示文件路径的别名 APP_GALLERY_SERVICE_ACCOUNT_KEY

同时兼容旧版 API Client:

export APP_GALLERY_CLIENT_ID=client-id
export APP_GALLERY_CLIENT_SECRET=client-secret

两者同时存在时优先使用 Service Account。

应用

fastforge appgallery app resolve com.example.myapp
fastforge appgallery app view <app-id>
fastforge appgallery app view <app-id> --lang zh-CN --json appInfo,languages

软件包

fastforge appgallery package list <app-id>
fastforge appgallery package status <app-id> <package-id>

提交审核

fastforge appgallery release <app-id>
fastforge appgallery release <app-id> --release-time "2026-08-20T08:00:00+0800"

原始 API

尚未提供类型化命令的接口可通过已认证的相对路径调用:

fastforge appgallery api get /api/publish/v2/app-info \
  --query appId=<app-id>
fastforge appgallery api put /api/publish/v2/app-language-info \
  --query appId=<app-id> --input language.json

仓库内维护的源规范是 scripts/generate/specs/app_gallery_connect.openapi.yaml。华为当前提供 HTML API 参考而非可下载的统一 OAS 文件,因此本项目依据官方文档维护标准化的 OpenAPI 3 文件,并使用以下命令重新生成:

python3 scripts/generate/app_gallery_connect.py

官方文档:快速入门查询应用信息