liufumingren 3a99587cc5 refactor: 统一 npm scripts 命名并新增一键打包命令
- 按前缀归类: dev:*(h5/adb/electron)、build:*(h5/app/exe/apk)、android:*(prepare/pack)
- 改名: dev:h5:electron→dev:h5、debug:electron→dev:electron、build:h5:electron→build:h5、build:app-plus→build:app
- 新增快捷入口: dev→dev:h5、build→build:h5、build:apk(编译+打包+发布一键)
- build:apk 不重复调 prepare.cjs(pack.ps1 内部已注入)
- 同步更新所有内部引用(dev-electron/build-exe/dev-adb/pack.ps1 提示)与文档
2026-09-19 19:04:13 +08:00

155 lines
6.1 KiB
JavaScript

/**
* Android 离线打包准备脚本
* 职责:校验 config/android.json、拷贝 App 资源(www)、覆盖图标/启动图。
* 包名/版本/签名/应用名/appid/appKey 等由 simpleDemo/build.gradle 在构建时动态读取
* config/android.json 与 package.json,本脚本不再写入工程文件。
*
* 用法:
* node android-offline/prepare.cjs
* node android-offline/prepare.cjs <wwwSource> # 可选:覆盖 www 资源目录
*/
const fs = require('fs')
const path = require('path')
const ROOT = path.resolve(__dirname, '..')
const OFFLINE_DIR = __dirname
const CONFIG_PATH = path.join(ROOT, 'config', 'android.json')
const log = (...args) => console.log('[prepare]', ...args)
const warn = (...args) => console.warn('[prepare][警告]', ...args)
// ---------- 1. 读取配置 ----------
let config
try {
config = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'))
} catch (error) {
if (error.code === 'ENOENT') {
console.error(`[prepare][错误] 未找到配置文件: ${CONFIG_PATH}`)
console.error('请复制 config/android.example.json 为 config/android.json 并填写(appKey、signing 等),详见 config/README.md')
} else {
console.error(`[prepare][错误] 配置文件解析失败 ${CONFIG_PATH}: ${error.message}`)
}
process.exit(1)
}
const required = ['appId', 'appName', 'packageName']
for (const key of required) {
if (!config[key]) {
console.error(`[prepare][错误] config.json 缺少必填项: ${key}`)
process.exit(1)
}
}
// ---------- 2. 定位 SDK 工程 ----------
const AS_DIR = path.join(OFFLINE_DIR, 'HBuilder-Integrate-AS')
const DEMO_DIR = path.join(AS_DIR, 'simpleDemo')
if (!fs.existsSync(AS_DIR)) {
console.error('[prepare][错误] 未找到离线 SDK 工程: ' + AS_DIR)
console.error('请先下载离线 SDK 并解压到 android-offline/ 目录,详见 README.md')
process.exit(1)
}
if (!fs.existsSync(DEMO_DIR)) {
console.error('[prepare][错误] 未找到 simpleDemo 工程: ' + DEMO_DIR)
process.exit(1)
}
let failed = false
// ---------- 3. 签名配置预检(Gradle 构建时从 config 动态读取) ----------
if (!config.signing || !config.signing.keystore) {
warn('config/android.json 中 signing.keystore 为空,Gradle 构建时将因缺少签名配置而失败')
} else if (!fs.existsSync(path.resolve(ROOT, config.signing.keystore))) {
warn(`签名文件不存在: ${path.resolve(ROOT, config.signing.keystore)}`)
}
if (!config.appKey) {
warn('config/android.json 中 appKey 为空,请到 https://dev.dcloud.net.cn 申请后填写')
}
// ---------- 4. 拷贝 App 资源到 assets/apps/{appId}/www ----------
const wwwTarget = path.join(DEMO_DIR, 'src', 'main', 'assets', 'apps', config.appId, 'www')
// 可选外部 www 源覆盖:node prepare.cjs <wwwSource>;其次用 config.android.json 的 wwwSource
const wwwOverride = process.argv[2] ? path.resolve(ROOT, process.argv[2]) : ''
const candidates = [
...(wwwOverride ? [wwwOverride] : []),
...(config.wwwSource ? [path.resolve(ROOT, config.wwwSource)] : []),
path.join(ROOT, 'unpackage', 'resources', config.appId, 'www'),
path.join(ROOT, 'dist', 'build', 'app'),
]
const wwwSource = candidates.find((dir) => fs.existsSync(dir))
if (!wwwSource) {
failed = true
console.error('[prepare][错误] 未找到 App 资源,请先执行 npm run build:app(或 HBuilderX 生成本地打包资源)')
} else {
fs.rmSync(wwwTarget, { recursive: true, force: true })
fs.cpSync(wwwSource, wwwTarget, { recursive: true })
log(`✓ 拷贝 App 资源: ${path.relative(ROOT, wwwSource)} -> assets/apps/${config.appId}/www`)
}
// ---------- 4.5 对齐编译器版本(隐藏"HTML5+ Runtime 版本不一致"提示) ----------
// CLI 构建资源时写入的 compilerVersion(如 5.07)与离线 SDK Runtime 版本不一致时,
// 启动会弹"本应用使用HBuilderX %s 编译,而手机端SDK版本是 %s"对话框。
// 此处把 www 内 manifest.json / app-config-service.js 的 compilerVersion 对齐到
// config/android.json 的 runtimeVersion(默认 5.24,与离线 SDK 一致),即可消除提示。
const runtimeVersion = config.runtimeVersion || '5.24'
function alignCompilerVersion (filePath) {
try {
if (!fs.existsSync(filePath)) return
let text = fs.readFileSync(filePath, 'utf-8')
const re = /"compilerVersion"\s*:\s*"[^"]*"/g
text = text.replace(re, '"compilerVersion": "' + runtimeVersion + '"')
fs.writeFileSync(filePath, text, 'utf-8')
log(`✓ 对齐 compilerVersion -> ${runtimeVersion}: ${path.relative(ROOT, filePath)}`)
} catch (e) {
warn(`对齐 compilerVersion 失败 ${filePath}: ${e.message}`)
}
}
alignCompilerVersion(path.join(wwwTarget, 'manifest.json'))
alignCompilerVersion(path.join(wwwTarget, 'app-config-service.js'))
// ---------- 9. 覆盖图标与启动图 ----------
function findResFiles(pattern) {
const resDir = path.join(DEMO_DIR, 'src', 'main', 'res')
const hits = []
if (!fs.existsSync(resDir)) return hits
const walk = (dir) => {
for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
const full = path.join(dir, entry.name)
if (entry.isDirectory()) walk(full)
else if (pattern.test(entry.name)) hits.push(full)
}
}
walk(resDir)
return hits
}
function applyImage(cfgPath, patterns, desc) {
if (!cfgPath) return
const image = path.resolve(ROOT, cfgPath)
if (!fs.existsSync(image)) {
warn(`${desc}不存在,跳过: ${image}`)
return
}
const targets = findResFiles(patterns)
if (targets.length === 0) {
warn(`${desc}: 未在 res 下找到目标文件(正则: ${patterns}),请手动替换`)
return
}
for (const target of targets) {
fs.copyFileSync(image, target)
log(`✓ 覆盖${desc}: ${path.relative(ROOT, target)}`)
}
}
applyImage(config.icon, /^(icon\.png|ic_launcher(\.png)?)$/i, '应用图标')
applyImage(config.splash, /^splash(\.png|_screen\.png)?$/i, '启动图')
// ---------- 5. 总结 ----------
console.log('\n[prepare] 完成' + (failed ? '(部分失败,请查看上方错误)' : ''))
console.log('后续:包名/版本/签名/应用名/appid/appKey 由 Gradle 构建时从 config/android.json 与 package.json 动态读取')
if (!failed) process.exit(0)
process.exit(1)