publish-apk 0.0.1-alpha.13 → 0.0.1-alpha.15

package/README.md

@@ -192,14 +192,16 @@ ANDROID_KEYSTORE_BASE64=... ANDROID_KEYSTORE_PASSWORD=... publish-apk keystore
 
 ### keystore-env（导出 Android keystore 的 CI 变量）
 
-把一份 keystore 文件导出成 CI 可直接配置的四个变量：
+把一份 keystore 文件导出成 CI 可直接配置的变量。默认输出四个：
 
 | 变量 | 内容 |
 | --- | --- |
-| `ANDROID_KEYSTORE_BASE64` | keystore 文件的单行 BASE64 |
+| `ANDROID_KEYSTORE_BASE64` | keystore 文件的单行 BASE64；加 `--no-base64` 可去掉 |
 | `ANDROID_KEYSTORE_PASSWORD` | keystore 明文口令 |
 | `ANDROID_KEY_ALIAS` | 私钥别名（不传 `--key-alias` 时由 keytool 自动识别） |
 | `ANDROID_KEY_PASSWORD` | 私钥明文口令（默认与 keystore 口令相同） |
+| `ANDROID_KEYSTORE_FILE` | 可选；加 `--include-file` 输出 keystore 的绝对路径，给本地 `signing.env` 用 |
+
 
 ```bash
 # 默认 env 格式：KEY=value，一行一个，适合逐项复制到 CI 变量
@@ -210,11 +212,17 @@ ANDROID_KEYSTORE_PASSWORD=<口令> publish-apk keystore-env --file ./release.p12
 
 # JSON 格式
 ANDROID_KEYSTORE_PASSWORD=<口令> publish-apk keystore-env --file ./release.p12 --format json > keystore.json
+
+# 生成可直接 source 的本地签名环境（要文件路径，不要 BASE64）
+ANDROID_KEYSTORE_PASSWORD=<口令> publish-apk keystore-env --file ./release.p12 \
+  --format shell --include-file --no-base64 > .signing/android.env
 ```
 
 - 生成变量前会用 keytool 校验 keystore 口令、别名与私钥口令，校验失败不会输出变量。
 - `--key-alias` / `ANDROID_KEY_ALIAS` 不传时自动识别；`--key-password` / `ANDROID_KEY_PASSWORD`
   不传时使用 keystore 口令。
+- `--include-file` 额外输出 `ANDROID_KEYSTORE_FILE`；`--no-base64` 去掉 `ANDROID_KEYSTORE_BASE64`。
+  两者一起用适合生成 `.signing/android.env`，避免把整份 BASE64 再塞进本地环境。
 - `env` 格式不额外加引号，适合把 `=` 后面的值逐项复制到 CI 变量；`shell` 格式适合本地
   `source`；`json` 格式适合脚本解析。
 - **警告：输出包含明文口令**，不要写入日志、提交仓库或公开分享；`stdout` 只有变量，
@@ -480,7 +488,7 @@ HARMONY_CERTPATH_BASE64=... \
 HARMONY_PROFILE_BASE64=... \
 HARMONY_STORE_PASSWORD=<p12口令> \
 publish-apk huawei signing-material-env \
-  --config ./build-profile.json5 --name default
+  --config ./build-profile.json5 --name default --require-all
 ```
 
 - 支持的 `HARMONY_*` 变量：
@@ -493,6 +501,8 @@ publish-apk huawei signing-material-env \
   - `HARMONY_*_OUT` 控制 BASE64 / 内容落盘位置
 - 先校验证书 / Profile / p12 内容；有口令时还会用 `keytool` 自检；全部通过后才写回。
 - 没有提供的变量保持原值；只替换提供的字段。
+- `--require-all` 要求 store / cert / profile / 口令齐全，缺一项直接失败；CI 用这个开关保证
+  不会拿半套材料继续打包。
 - 口令通过 `.p12` 同级 `material/` 加密；material 不存在时自动生成，`--new-material` 可重造。
 - 写回前备份到 `.signing/backup/`，写后回读校验。
 - 只给 `HARMONY_KEY_PASSWORD` 时还需要 `HARMONY_STORE_PASSWORD` 才能校验 / 加密。

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "publish-apk",
-  "version": "0.0.1-alpha.13",
+  "version": "0.0.1-alpha.15",
   "description": "发布 华为 Android .apk、Harmony .app、Google Play Android .aab",
+  "homepage": "https://xuxiaowei.io",
   "keywords": [
     "huawei",
     "agc",

package/src/huawei-signing.js

@@ -63,6 +63,8 @@ const OPTION_PRODUCT = '--product'
 const OPTION_WRITE = '--write'
 const OPTION_NEW_MATERIAL = '--new-material'
 const OPTION_NO_KEYTOOL = '--no-keytool'
+/** signing-material-env：要求 store / cert / profile / 口令齐全 */
+const OPTION_REQUIRE_ALL = '--require-all'
 const OPTION_VERBOSE = '--verbose'
 
 const SIGNING_OPTIONS = new Set([
@@ -119,8 +121,9 @@ const MATERIAL_ENV_OPTIONS = new Set([
   OPTION_PRODUCT,
   OPTION_NO_KEYTOOL,
   OPTION_NEW_MATERIAL,
+  OPTION_REQUIRE_ALL,
 ])
-const MATERIAL_ENV_FLAGS = new Set([OPTION_NO_KEYTOOL, OPTION_NEW_MATERIAL])
+const MATERIAL_ENV_FLAGS = new Set([OPTION_NO_KEYTOOL, OPTION_NEW_MATERIAL, OPTION_REQUIRE_ALL])
 
 const ENV_STORE_FILE = 'HARMONY_STORE_FILE'
 const ENV_STORE_FILE_BASE64 = 'HARMONY_STORE_FILE_BASE64'
@@ -646,6 +649,7 @@ function renderSigningMaterialEnvHelp() {
           [`${OPTION_PRODUCT} <产品>`, `按 products[].name 找到它挂的 signingConfig（可用 ${ENV_PRODUCT} 补齐）`],
           [OPTION_NO_KEYTOOL, '跳过 keytool 口令自检（仍会校验证书 / Profile / p12 内容）'],
           [OPTION_NEW_MATERIAL, 'material 已存在也重造一套（旧的挪成 material.bak-<时间戳>）'],
+          [OPTION_REQUIRE_ALL, '要求 store / cert / profile / 口令齐全；缺一项直接失败（CI 用）'],
           ['-h, --help', '显示帮助信息'],
         ],
       },
@@ -1766,6 +1770,20 @@ export async function runHuaweiSigningMaterialEnv(argv, env) {
   const storePasswordEnv = readEnv(env, ENV_STORE_PASSWORD)
   const keyPasswordEnv = readEnv(env, ENV_KEY_PASSWORD)
 
+  if (options.get(OPTION_REQUIRE_ALL) === true) {
+    const missing = []
+    if (storeValues.length === 0) missing.push(`${ENV_STORE_FILE} / ${ENV_STORE_FILE_BASE64}`)
+    if (certValues.length === 0) missing.push(`${ENV_CERTPATH} / ${ENV_CERTPATH_BASE64}`)
+    if (profileValues.length === 0) missing.push(`${ENV_PROFILE} / ${ENV_PROFILE_BASE64}`)
+    if (storePasswordEnv === undefined) missing.push(ENV_STORE_PASSWORD)
+    if (missing.length > 0) {
+      throw new UsageError(
+        `${OPTION_REQUIRE_ALL} 缺少：${missing.join('、')}`,
+        renderSigningMaterialEnvHelp(),
+      )
+    }
+  }
+
   const configStoreFileValue = stringField(entry.text, 'storeFile')
   let storeFile =
     configStoreFileValue === undefined || configStoreFileValue.trim() === ''

package/src/keystore.js

@@ -71,6 +71,10 @@ const OPTION_VALIDITY = '--validity'
 const OPTION_DNAME = '--dname'
 const OPTION_FORCE = '--force'
 const OPTION_FORMAT = '--format'
+/** keystore-env：额外输出 ANDROID_KEYSTORE_FILE（绝对路径） */
+const OPTION_INCLUDE_FILE = '--include-file'
+/** keystore-env：不输出 ANDROID_KEYSTORE_BASE64 */
+const OPTION_NO_BASE64 = '--no-base64'
 
 const KEYSTORE_OPTIONS = new Set([
   OPTION_FILE,
@@ -100,8 +104,10 @@ const ENV_OPTIONS = new Set([
   OPTION_KEY_ALIAS,
   OPTION_KEY_PASSWORD,
   OPTION_FORMAT,
+  OPTION_INCLUDE_FILE,
+  OPTION_NO_BASE64,
 ])
-const ENV_FLAGS = new Set()
+const ENV_FLAGS = new Set([OPTION_INCLUDE_FILE, OPTION_NO_BASE64])
 
 /** 密钥库路径，等价于 --file（也可用 ANDROID_KEYSTORE 补） */
 const ENV_FILE = 'ANDROID_KEYSTORE_FILE'
@@ -884,6 +890,8 @@ function renderKeystoreEnvHelp() {
             `${OPTION_FORMAT} <env|shell|json>`,
             '输出格式，默认 env（KEY=value，一行一个）；shell 输出 export KEY=...；json 输出对象',
           ],
+          [OPTION_INCLUDE_FILE, '额外输出 ANDROID_KEYSTORE_FILE（绝对路径）'],
+          [OPTION_NO_BASE64, '不输出 ANDROID_KEYSTORE_BASE64（本地 signing.env 用）'],
           ['-h, --help', '显示帮助信息'],
         ],
       },
@@ -902,7 +910,7 @@ function renderKeystoreEnvHelp() {
         entries: [
           [
             'stdout',
-            'ANDROID_KEYSTORE_BASE64 / ANDROID_KEYSTORE_PASSWORD / ANDROID_KEY_ALIAS / ANDROID_KEY_PASSWORD',
+            '默认 ANDROID_KEYSTORE_BASE64 / PASSWORD / ALIAS / KEY_PASSWORD；加 --include-file 输出 ANDROID_KEYSTORE_FILE，加 --no-base64 去掉 BASE64',
           ],
           ['stderr', '明文口令警告与错误信息'],
         ],
@@ -920,6 +928,7 @@ function renderKeystoreEnvHelp() {
       `  ${PROGRAM} ${ENV_COMMAND_NAME} --file ./release.p12`,
       `  ANDROID_KEYSTORE_PASSWORD=<口令> ${PROGRAM} ${ENV_COMMAND_NAME} --file ./release.p12 --format shell`,
       `  ${PROGRAM} ${ENV_COMMAND_NAME} --file ./release.p12 --format json > keystore.json`,
+      `  ${PROGRAM} ${ENV_COMMAND_NAME} --file ./release.p12 --format shell --include-file --no-base64 > signing.env`,
       '',
       '警告: 输出包含明文口令，请勿写入日志、提交仓库或公开分享',
       '说明: 生成前会用 keytool 校验 keystore 口令、别名与私钥口令',
@@ -929,13 +938,19 @@ function renderKeystoreEnvHelp() {
   })
 }
 
-function renderKeystoreEnvVariables(buffer, alias, storePassword, keyPassword, format, help) {
-  const values = [
-    ['ANDROID_KEYSTORE_BASE64', buffer.toString('base64')],
+function renderKeystoreEnvVariables(absolute, buffer, alias, storePassword, keyPassword, format, options, help) {
+  const values = []
+  if (!options.get(OPTION_NO_BASE64)) {
+    values.push(['ANDROID_KEYSTORE_BASE64', buffer.toString('base64')])
+  }
+  if (options.get(OPTION_INCLUDE_FILE)) {
+    values.push(['ANDROID_KEYSTORE_FILE', absolute])
+  }
+  values.push(
     ['ANDROID_KEYSTORE_PASSWORD', storePassword],
     ['ANDROID_KEY_ALIAS', alias],
     ['ANDROID_KEY_PASSWORD', keyPassword],
-  ]
+  )
   if (format === 'env') {
     return values.map(([name, value]) => `${name}=${value}`).join('\n')
   }
@@ -994,7 +1009,9 @@ async function runKeystoreEnv(argv, env) {
   })
   stderr('警告: 输出包含明文口令，请勿写入日志、提交仓库或公开分享')
   stdout(
-    renderKeystoreEnvVariables(buffer, info.alias, storePassword, keyPassword, format, renderKeystoreEnvHelp()),
+    renderKeystoreEnvVariables(
+      absolute, buffer, info.alias, storePassword, keyPassword, format, options, renderKeystoreEnvHelp(),
+    ),
   )
   return EXIT_OK
 }