'use strict'; /** * Android 设备端正式包:构建签名 APK + version.json,并单独发布到 nginx 静态目录 * * 特点和桌面端一致(见 publish-desktop.cjs): * - 只动 Android 产物,不重新发布后端、不重启 Egg、不跑数据库迁移; * - 构建复用 backend/android_client/build.ps1(Production 环境); * - APK 上传到 androidDownloadDir(默认 deployRoot/download/android_client); * - version.json 上传到 androidVersionDir(默认同一个目录,nginx 对该文件单独关缓存); * - 同时刷新 front.conf 里的 /download/ 静态托管配置并 reload nginx。 * * 用法: * npm run android:publish # 自动递增补丁版本并发布 * npm run android:publish -- --version=1.0.1 * npm run android:publish -- --notes="扫码上报更稳" --keep=5 * npm run android:build # 只构建,不上传(--dry-run) * npm run android:publish -- --skip-nginx # 不改 nginx */ const fs = require('node:fs'); const path = require('node:path'); const { ROOT, ensureCommandAvailable, getNowStamp, loadDeployConfig, quoteForBash, refreshNginx, runCommand, runScp, runSsh, } = require('./deploy-lib.cjs'); function parseArgs(argv) { const options = { envName: 'production', version: '', notes: '', keep: 0, dryRun: false, skipNginx: false, }; for (const item of argv) { if (!item) continue; if (!item.startsWith('--') && !options.envNameExplicit) { options.envName = item; options.envNameExplicit = true; continue; } if (item === '--dry-run') { options.dryRun = true; } else if (item === '--skip-nginx') { options.skipNginx = true; } else if (item.startsWith('--version=')) { options.version = item.slice('--version='.length).trim().replace(/^v/i, ''); } else if (item.startsWith('--notes=')) { options.notes = item.slice('--notes='.length); } else if (item.startsWith('--keep=')) { options.keep = Number(item.slice('--keep='.length)) || 0; } } if (options.version && !/^\d+\.\d+\.\d+$/.test(options.version)) { throw new Error(`版本号格式应为 x.y.z:${options.version}`); } return options; } function compareVersion(a, b) { const pa = a.split('.').map(Number); const pb = b.split('.').map(Number); for (let i = 0; i < 3; i++) { if (pa[i] !== pb[i]) return pa[i] - pb[i]; } return 0; } /** 取本地已有 APK / version.json 中最高的版本,并默认 +1 补丁号 */ function nextVersion(outDir) { const versions = []; if (fs.existsSync(outDir)) { for (const name of fs.readdirSync(outDir)) { const match = name.match(/^YuncangScan-(\d+\.\d+\.\d+)\.apk$/); if (match) versions.push(match[1]); } } const versionFile = path.join(outDir, 'version.json'); if (fs.existsSync(versionFile)) { try { const data = JSON.parse(fs.readFileSync(versionFile, 'utf8')); if (data && /^\d+\.\d+\.\d+$/.test(String(data.version || ''))) { versions.push(String(data.version)); } } catch (error) { // 忽略损坏的本地 version.json } } if (!versions.length) return '1.0.0'; versions.sort(compareVersion); const [ major, minor, patch ] = versions[versions.length - 1].split('.').map(Number); return `${major}.${minor}.${patch + 1}`; } /** 用 android_client/build.ps1 构建 Production 包 */ function buildAndroid(config, { version, notes, baseUrl }) { const buildScript = path.resolve(ROOT, config.androidBuildScript); if (!fs.existsSync(buildScript)) { throw new Error(`找不到 Android 构建脚本: ${buildScript}`); } const shell = process.platform === 'win32' ? 'powershell.exe' : 'pwsh'; const args = [ '-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', buildScript, '-Environment', 'Production', '-Version', version, '-ServerBaseUrl', baseUrl, ]; if (notes) { args.push('-ReleaseNotes', notes); } console.log(`构建 Android 正式包: ${version}(${baseUrl})`); runCommand(shell, args, { cwd: path.dirname(buildScript), stdio: 'inherit' }); } function main() { const options = parseArgs(process.argv.slice(2)); const config = loadDeployConfig(options.envName); const outDir = path.resolve(ROOT, config.androidOutDir); const remoteDir = config.androidDownloadDir; const remoteVersionDir = config.androidVersionDir || remoteDir; const baseUrl = String(config.androidBaseUrl || `http://${config.serverName}`).replace(/\/+$/, ''); const keep = options.keep > 0 ? options.keep : Number(config.androidKeepVersions || 5); const version = options.version || nextVersion(outDir); if (!remoteDir) { throw new Error('未配置 androidDownloadDir(Android 安装包发布目录)。'); } if (!remoteVersionDir) { throw new Error('未配置 androidVersionDir(Android version.json 发布目录)。'); } buildAndroid(config, { version, notes: options.notes, baseUrl }); const apkName = `YuncangScan-${version}.apk`; const apkPath = path.join(outDir, apkName); const versionPath = path.join(outDir, 'version.json'); if (!fs.existsSync(apkPath)) { throw new Error(`构建完成但 APK 不存在: ${apkPath}`); } if (!fs.existsSync(versionPath)) { throw new Error(`构建完成但 version.json 不存在: ${versionPath}`); } const versionJson = JSON.parse(fs.readFileSync(versionPath, 'utf8')); console.log(`安装包: ${apkPath}(${(fs.statSync(apkPath).size / 1024 / 1024).toFixed(1)} MB)`); console.log(`版本文件: ${versionPath}`); console.log(`下载地址: ${versionJson.downloadUrl}`); console.log(`发布目录: ${config.username}@${config.host}:${remoteDir}`); console.log(`版本目录: ${config.username}@${config.host}:${remoteVersionDir}`); if (options.dryRun) { console.log('DRY-RUN:只构建,不上传。'); return; } ensureCommandAvailable('ssh', '请先安装 OpenSSH Client 并确保 ssh 在 PATH 中。'); ensureCommandAvailable('scp', '请先安装 OpenSSH Client 并确保 scp 在 PATH 中。'); const stamp = getNowStamp(); const remoteApkTmp = `${remoteDir}/.${apkName}.upload-${stamp}`; const remoteVersionTmp = `${remoteVersionDir}/.version.json.upload-${stamp}`; runSsh(config, [ 'set -euo pipefail', `DIR=${quoteForBash(remoteDir)}`, `VDIR=${quoteForBash(remoteVersionDir)}`, 'mkdir -p "$DIR" "$VDIR"', // 清理上次中断留下的隐藏临时文件 'find "$DIR" "$VDIR" -maxdepth 1 -type f -name ".*.upload-*" -delete', ].join('\n'), { stdio: 'pipe' }); console.log(`上传安装包(${(fs.statSync(apkPath).size / 1024 / 1024).toFixed(1)} MB)…`); runScp(config, apkPath, remoteApkTmp); runSsh(config, [ 'set -euo pipefail', `DIR=${quoteForBash(remoteDir)}`, `TMP=${quoteForBash(remoteApkTmp)}`, `FINAL=${quoteForBash(`${remoteDir}/${apkName}`)}`, 'mv "$TMP" "$FINAL"', 'chmod 644 "$FINAL"', `chown ${quoteForBash(config.androidOwner || 'www:www')} "$FINAL" || true`, 'echo "APK_UPLOADED"', ].join('\n'), { stdio: 'pipe' }); console.log(`安装包已发布: ${remoteDir}/${apkName}`); // APK 就位后再更新 version.json,避免客户端拿到指向不存在文件的版本信息 runScp(config, versionPath, remoteVersionTmp); runSsh(config, [ 'set -euo pipefail', `DIR=${quoteForBash(remoteDir)}`, `VDIR=${quoteForBash(remoteVersionDir)}`, `TMP=${quoteForBash(remoteVersionTmp)}`, 'mv "$TMP" "$VDIR/version.json"', 'chmod 644 "$VDIR/version.json"', `chown ${quoteForBash(config.androidOwner || 'www:www')} "$VDIR/version.json" || true`, 'echo "VERSION_JSON_UPLOADED"', // 只保留最近 N 个安装包 'COUNT=0', `for FILE in $(ls -1t "$DIR"/YuncangScan-*.apk 2>/dev/null || true); do`, ' COUNT=$((COUNT + 1))', ` if [ "$COUNT" -gt ${Number(keep)} ]; then rm -f "$FILE"; fi`, 'done', 'ls -1t "$DIR" | head -20', ].join('\n'), { stdio: 'pipe' }); if (!options.skipNginx) { refreshNginx(config); } console.log(''); console.log('Android 设备端发布完成:'); console.log(` 版本: ${version}`); console.log(` 安装包: ${baseUrl}/download/android_client/${apkName}`); console.log(` 更新信息: ${baseUrl}/download/android_client/version.json`); } try { main(); } catch (err) { console.error(`[ANDROID] ${err && err.message ? err.message : err}`); process.exit(1); }