@huoye/app-ship 0.1.2 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -96,6 +96,11 @@ app-ship upload -c app-ship.yaml -f app-release.apk
96
96
  # 仅上传到指定平台
97
97
  app-ship upload -c app-ship.yaml -f app-release.apk --platform pgyer,huawei
98
98
 
99
+ # Google Play 必须在核对预览后显式确认,首版只进入 internal 草稿
100
+ app-ship upload -c app-ship.yaml -f app-release.aab \
101
+ --platform google_play \
102
+ --confirm-google-play
103
+
99
104
  # 带元数据上传
100
105
  app-ship upload -c app-ship.yaml -f app-release.apk \
101
106
  --version 2.0.0 \
@@ -105,6 +110,10 @@ app-ship upload -c app-ship.yaml -f app-release.apk \
105
110
  # 显示详细日志
106
111
  app-ship upload -c app-ship.yaml -f app-release.apk --verbose
107
112
 
113
+ # 查看当前项目最近的本地发布回执;JSON 可直接交给 AI 或脚本处理
114
+ app-ship history
115
+ app-ship history --project /path/to/project --json
116
+
108
117
  # 查看帮助
109
118
  app-ship --help
110
119
  app-ship --version
@@ -120,8 +129,11 @@ app-ship --version
120
129
  | `--version <ver>` | `-v` | 版本号(默认:"1.0.0") |
121
130
  | `--build-number <n>` | `-b` | 构建号(默认:"1") |
122
131
  | `--changelog <text>` | - | 更新日志 |
132
+ | `--confirm-google-play` | - | 确认上传 Google Play internal 草稿 |
123
133
  | `--verbose` | - | 显示详细输出 |
124
134
 
135
+ 上传完成后会自动在 `~/.flu-cli/release-receipts/` 保存项目隔离的结构化回执。回执只记录产物路径、大小、SHA-256、渠道状态和白名单远端标识;不会保存 Token、密钥、服务账号内容或完整平台响应。每个项目最多保留 100 条。
136
+
125
137
  ---
126
138
 
127
139
  ### 2️⃣ npm 库(编程集成)
@@ -218,7 +230,7 @@ if (result.success) {
218
230
  | 🟣 **鸿蒙** | HAP | OAuth2 | [AppGallery Connect](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agcapi-getstarted-0000001111209402) | ✅ 已实测 |
219
231
  | 🍎 **TestFlight** | IPA | Apple API | [TestFlight API](https://developer.apple.com/testflight/testers/) | ⚠️ 开发中 |
220
232
  | 🍎 **Ad Hoc** | IPA | 证书 | [Apple 文档](https://developer.apple.com/documentation/xcode/distributing-your-app-for-beta-testing) | ⚠️ 开发中 |
221
- | 🎮 **Google Play** | APK, AAB | Service Account | [Google Play API](https://developer.android.com/studio/publish) | 🔄 v0.2.0 |
233
+ | 🎮 **Google Play** | AAB | Service Account | [Android Publisher API](https://developers.google.com/android-publisher/api-ref/rest) | ✅ internal 草稿已实测 |
222
234
 
223
235
  ---
224
236
 
@@ -300,15 +312,21 @@ publish:
300
312
  appleId: "${APPLE_ID}"
301
313
  appPassword: "${APP_PASSWORD}"
302
314
 
303
- # ── Google Play (官方 API: https://developer.android.com/studio/publish) ──
315
+ # ── Google Play(首版仅上传内部测试草稿;API 轨道标识为 internal)──
304
316
  google_play:
305
317
  enable: false
306
318
  auth:
307
319
  serviceAccountJsonPath: "./service-account.json"
308
320
  packageName: "com.example.app"
309
- track: production
321
+ track: internal
310
322
  ```
311
323
 
324
+ Google Play 连接器只从用户本机读取服务账号文件,并直接请求 Android Publisher API。
325
+ 应用需已在 Play Console 创建且包名一致;首版只接受 AAB,并固定写入 `internal` 轨道的
326
+ `draft` 发布记录,不提交审核,也不发布到测试用户或生产用户。
327
+ 如果应用从未上传过 APK/AAB,需先在 Play Console 手工上传并保存首个版本,之后才能使用
328
+ Edits API;CLI 上传还必须显式提供 `--confirm-google-play`。
329
+
312
330
  ### 环境变量支持
313
331
 
314
332
  配置值支持 `${VAR_NAME}` 语法引用环境变量,避免敏感信息硬编码: