liufumingren 06d58a5a71 chore(apk): 移植 Android 离线打包流水线(命令行出 APK,无需 HBuilderX)
- android-offline/:DCloud 离线集成工程(simpleDemo/libs 含 5+ Runtime aar)+ pack.ps1 + prepare.cjs
- 包名 com.gztbyc.pda_wms、appId __UNI__0B3DAD3、BootReceiver 迁到新包名目录
- AndroidManifest 补齐权限(与 src/manifest.json 对齐)、新增蓝牙权限与 usesCleartextTraffic(生产接口为 http)
- prepare.cjs 默认资源目录改为 dist/build/app-plus,注入到 assets/apps/__UNI__0B3DAD3/www 并对齐 compilerVersion
- config/:android.example.json 模板 + README(appKey 与 appId/包名/证书指纹绑定说明);android.json 与 keystore 均不提交
- scripts/build-apk.cjs + npm run build:apk / android:pack:raw:生产编译(含地址校验)→ gradle 出包到 release/android
- .gitignore 忽略 keystore、config/android.json、SDK、生成的 www 与 release
2026-10-02 21:12:15 +08:00

333 lines
13 KiB
PowerShell

# Command-line APK packaging for WMS_PDA (no Android Studio needed).
# Flow: detect JDK/SDK -> inject config (prepare.cjs) -> gradlew assembleRelease -> copy APK to release/android/
#
# 发布上传默认关闭:未提供 config/deploy.json 时会跳过(本仓库不提供该文件)。
#
# Usage:
# .\pack.ps1 # package release APK
# .\pack.ps1 -Clean # full rebuild
# .\pack.ps1 -Timestamp # keep timestamped artifact name
# .\pack.ps1 -VersionName "1.0.2" # override version (written back to package.json; versionCode auto-derived)
# .\pack.ps1 -VersionCode 10002 # manually set versionCode (rarely needed)
# .\pack.ps1 -NoInject # skip prepare.cjs injection (already injected)
# .\pack.ps1 -NoUpload # package only, skip publish upload (scp + latest.json)
# .\pack.ps1 -JavaHome '...' -AndroidSdk '...'
param(
[switch]$Clean,
[switch]$Timestamp,
[switch]$NoInject,
[switch]$NoUpload,
[string]$VersionName = "",
[string]$VersionCode = "",
[string]$JavaHome = "",
[string]$AndroidSdk = ""
)
$ErrorActionPreference = 'Stop'
# ============ paths ============
$root = Split-Path -Parent $MyInvocation.MyCommand.Path
$projRoot = Split-Path -Parent $root
Set-Location $root
$asDir = Join-Path $root 'HBuilder-Integrate-AS'
$module = 'simpleDemo'
$appFile = 'wms-pda'
$gradlew = Join-Path $asDir 'gradlew.bat'
$distDir = Join-Path $projRoot 'release\android'
$apkSource = Join-Path $asDir "$module\build\outputs\apk\release\$module-release.apk"
$buildGradle = Join-Path $asDir "$module\build.gradle"
$configPath = Join-Path $projRoot 'config\android.json'
# ============ JDK detect (JDK 17+ required) ============
function Get-JavaMajorVersion([string]$javaExe) {
$prev = $ErrorActionPreference
$ErrorActionPreference = 'Continue'
try {
$out = (cmd /c "`"$javaExe`" -version 2>&1" | Out-String)
} finally {
$ErrorActionPreference = $prev
}
if ($out -match 'version\s+"1\.(\d+)') { return [int]$Matches[1] }
if ($out -match 'version\s+"(\d+)') { return [int]$Matches[1] }
return 0
}
$jdkCandidates = @()
if ($JavaHome) { $jdkCandidates += $JavaHome }
if ($env:JAVA_HOME) { $jdkCandidates += $env:JAVA_HOME }
$jdkCandidates += @(
"$env:LOCALAPPDATA\Programs\EclipseAdoptium",
"$env:LOCALAPPDATA\Programs\Android Studio\jbr",
"C:\Program Files\Android\Android Studio\jbr",
"D:\Program Files\Android\Android Studio\jbr",
"$env:USERPROFILE\.jdks",
"C:\Program Files\Java",
"C:\Program Files\Eclipse Adoptium"
)
$selectedJava = ""
foreach ($c in $jdkCandidates) {
if (-not $c) { continue }
$javaExe = Join-Path $c 'bin\java.exe'
if (-not (Test-Path $javaExe)) {
$found = Get-ChildItem $c -Recurse -Filter java.exe -ErrorAction SilentlyContinue | Select-Object -First 1
if ($found) { $javaExe = $found.FullName }
}
if (Test-Path $javaExe) {
$major = Get-JavaMajorVersion $javaExe
if ($major -ge 17) {
$selectedJava = Split-Path -Parent (Split-Path -Parent $javaExe)
break
}
}
}
if ($selectedJava -and (Test-Path (Join-Path $selectedJava 'bin\java.exe'))) {
$JavaHome = $selectedJava
$env:JAVA_HOME = $JavaHome
$env:Path = "$JavaHome\bin;$env:Path"
} else {
Write-Host ""
Write-Host "[error] JDK 17+ not found. Install JDK 17+ (or Android Studio JBR) or use -JavaHome '...'." -ForegroundColor Red
exit 1
}
# ============ Android SDK detect ============
if (-not $AndroidSdk) { $AndroidSdk = $env:ANDROID_HOME }
if (-not $AndroidSdk) { $AndroidSdk = $env:ANDROID_SDK_ROOT }
$localProps = Join-Path $asDir 'local.properties'
if (-not $AndroidSdk -and (Test-Path $localProps)) {
$line = Select-String -Path $localProps -Pattern '^sdk\.dir=(.+)$'
if ($line) { $AndroidSdk = [regex]::Replace($line.Matches[0].Groups[1].Value, '\\([\\:])', '$1') }
}
if (-not $AndroidSdk -or -not (Test-Path (Join-Path $AndroidSdk 'platform-tools'))) {
$sdkCandidates = @(
"$env:LOCALAPPDATA\Android\Sdk",
"$env:USERPROFILE\AppData\Local\Android\Sdk",
"C:\Android\Sdk",
"D:\Android\Sdk"
)
foreach ($c in $sdkCandidates) {
if (Test-Path (Join-Path $c 'platform-tools')) { $AndroidSdk = $c; break }
}
}
if ($AndroidSdk -and (Test-Path (Join-Path $AndroidSdk 'platform-tools'))) {
$env:ANDROID_HOME = $AndroidSdk
$env:ANDROID_SDK_ROOT = $AndroidSdk
$escaped = $AndroidSdk -replace '\\', '\\'
$sdkLine = "sdk.dir=$escaped"
if (Test-Path $localProps) {
$props = Get-Content $localProps -Raw
if ($props -match '(?m)^sdk\.dir=') {
$props = $props -replace '(?m)^sdk\.dir=.*$', $sdkLine
} else {
$props = $props.TrimEnd() + "`r`n" + $sdkLine + "`r`n"
}
Set-Content -Path $localProps -Value $props -Encoding ASCII
} else {
Set-Content -Path $localProps -Value $sdkLine -Encoding ASCII
}
} else {
Write-Host ""
Write-Host "[error] Android SDK not found. Set ANDROID_HOME or use -AndroidSdk." -ForegroundColor Red
exit 1
}
# ============ pre-check ============
if (-not (Test-Path $gradlew)) { Write-Host "[error] gradlew not found: $gradlew" -ForegroundColor Red; exit 1 }
if (-not (Test-Path $configPath)) { Write-Host "[error] config/android.json not found. Copy config/android.example.json to config/android.json first." -ForegroundColor Red; exit 1 }
if (-not (Test-Path $buildGradle)) { Write-Host "[error] build.gradle not found: $buildGradle" -ForegroundColor Red; exit 1 }
# ============ version: single source of truth = package.json ============
# versionName = package.json "version" (X.Y.Z, three-part)
# versionCode = X*1000000 + Y*1000 + Z (derived; each part must be 0-999)
$pkgPath = Join-Path $projRoot 'package.json'
if (-not (Test-Path $pkgPath)) { Write-Host "[error] package.json not found: $pkgPath" -ForegroundColor Red; exit 1 }
$pkg = Get-Content $pkgPath -Raw -Encoding UTF8 | ConvertFrom-Json
$verName = [string]$pkg.version
# -VersionName overrides and writes back to package.json (keeps exe/apk in sync)
if ($VersionName) {
$verName = $VersionName
$raw = [System.IO.File]::ReadAllText($pkgPath, [System.Text.Encoding]::UTF8)
$raw = $raw -replace '("version"\s*:\s*")[^"]*(")', ('${1}' + $VersionName + '${2}')
[System.IO.File]::WriteAllText($pkgPath, $raw, (New-Object System.Text.UTF8Encoding($false)))
Write-Host ""
Write-Host "[update] version written back to package.json -> $VersionName" -ForegroundColor Cyan
}
# versionCode: explicit -VersionCode wins, otherwise derived from X.Y.Z
if ($VersionCode) {
$verCode = $VersionCode
} else {
$parts = @($verName -split '\.')
if ($parts.Count -lt 3) {
Write-Host "[error] version '$verName' must be three-part (X.Y.Z)" -ForegroundColor Red
exit 1
}
$numX = [int]$parts[0]
$numY = [int]$parts[1]
$numZ = [int]$parts[2]
if ($numX -gt 999 -or $numY -gt 999 -or $numZ -gt 999) {
Write-Host "[error] each part of version '$verName' must be 0-999 (e.g. 1.0.101 is ok, 1.0.1000 is not)" -ForegroundColor Red
exit 1
}
$verCode = [string]($numX * 1000000 + $numY * 1000 + $numZ)
Write-Host ""
Write-Host "[info] versionCode derived: $verName -> $verCode" -ForegroundColor DarkGray
}
$cfg = Get-Content $configPath -Raw -Encoding UTF8 | ConvertFrom-Json
Write-Host ""
Write-Host "================== uni-app Android packaging ==================" -ForegroundColor Cyan
Write-Host " project : $root"
Write-Host " appid : $($cfg.appId)"
Write-Host " version : $verName ($verCode)"
Write-Host " build : release"
Write-Host " JDK : $($env:JAVA_HOME)"
Write-Host " AndroidSDK: $($env:ANDROID_HOME)"
Write-Host "===============================================================" -ForegroundColor Cyan
# ============ step 1: inject (prepare.cjs) ============
if (-not $NoInject) {
Write-Host ""
Write-Host "[step 1/3] inject config + www resources (prepare.cjs) ..." -ForegroundColor Yellow
node (Join-Path $root 'prepare.cjs')
if ($LASTEXITCODE -ne 0) {
Write-Host "[error] prepare.cjs failed" -ForegroundColor Red
exit 1
}
} else {
Write-Host ""
Write-Host "[step 1/3] -NoInject specified, skip prepare.cjs" -ForegroundColor DarkGray
}
# ============ step 2: gradle build ============
$step = 2
if ($Clean) {
Write-Host ""
Write-Host "[step 2/3] gradle clean ..." -ForegroundColor Yellow
Push-Location $asDir
& $gradlew clean --console=plain
$cleanCode = $LASTEXITCODE
Pop-Location
if ($cleanCode -ne 0) { Write-Host "[error] clean failed" -ForegroundColor Red; exit 1 }
$step = 3
}
Write-Host ""
Write-Host "[step $step/3] gradle assembleRelease ..." -ForegroundColor Yellow
Push-Location $asDir
& $gradlew assembleRelease --console=plain
$buildCode = $LASTEXITCODE
Pop-Location
if ($buildCode -ne 0) {
Write-Host "[error] packaging failed (gradle exit code $buildCode)" -ForegroundColor Red
exit 1
}
# ============ step 3: copy artifact ============
if (-not (Test-Path $apkSource)) {
Write-Host "[error] APK not found: $apkSource" -ForegroundColor Red
exit 1
}
if (-not (Test-Path $distDir)) { New-Item -ItemType Directory -Path $distDir -Force | Out-Null }
if ($Timestamp) {
$stamp = Get-Date -Format 'yyyyMMdd_HHmmss'
$apkName = "${appFile}_v${verName}_release_${stamp}.apk"
} else {
$apkName = "${appFile}_v${verName}_release.apk"
}
$apkDest = Join-Path $distDir $apkName
Copy-Item -Path $apkSource -Destination $apkDest -Force
$apkSize = [math]::Round((Get-Item $apkDest).Length / 1MB, 2)
Write-Host ""
Write-Host "================== packaging done ==================" -ForegroundColor Green
Write-Host " artifact : $apkDest"
Write-Host " size : ${apkSize} MB"
Write-Host " version : $verName ($verCode)"
Write-Host "===================================================" -ForegroundColor Green
# ============ publish upload (scp + latest.json, same flow as sandan project) ============
$deployCfgPath = Join-Path $projRoot 'config\deploy.json'
if ($NoUpload) {
Write-Host ""
Write-Host "[hint] -NoUpload specified, skip publish upload" -ForegroundColor DarkGray
} elseif (-not (Test-Path $deployCfgPath)) {
Write-Host ""
Write-Host "[hint] config/deploy.json not found, skip publish upload (copy config/deploy.example.json and fill real values)" -ForegroundColor DarkGray
} else {
$dcfg = Get-Content $deployCfgPath -Raw -Encoding UTF8 | ConvertFrom-Json
$dcfg = $dcfg.android
if (-not $dcfg) {
Write-Host "[error] config/deploy.json missing android section" -ForegroundColor Red
exit 1
}
$dHost = [string]$dcfg.host
$dUser = [string]$dcfg.user
$dKey = [string]$dcfg.keyPath
$dRemDir = ([string]$dcfg.remoteDir).TrimEnd('/')
$dUrlPre = [string]$dcfg.downloadUrlPrefix
$dPort = 22
if ($dcfg.port) { $dPort = [int]$dcfg.port }
$dLatest = 'latest.json'
if ($dcfg.latestJsonName) { $dLatest = [string]$dcfg.latestJsonName }
if ($dUrlPre -and -not $dUrlPre.EndsWith('/')) { $dUrlPre = $dUrlPre + '/' }
$missing = @()
if (-not $dHost) { $missing += 'host' }
if (-not $dUser) { $missing += 'user' }
if (-not $dRemDir) { $missing += 'remoteDir' }
if (-not $dUrlPre) { $missing += 'downloadUrlPrefix' }
if ($missing.Count -gt 0) {
Write-Host "[error] config/deploy.json missing fields: $($missing -join ', ')" -ForegroundColor Red
exit 1
}
if ($dKey -and -not (Test-Path $dKey)) {
Write-Host "[error] SSH key not found: $dKey" -ForegroundColor Red
exit 1
}
# generate latest.json (same directory as the APK)
$sha256 = (Get-FileHash -Path $apkDest -Algorithm SHA256).Hash
$dlUrl = "$dUrlPre$apkName"
$publishedAt = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ')
$latest = [ordered]@{
version = $verName
file = $apkName
url = $dlUrl
sha256 = $sha256
publishedAtUtc = $publishedAt
}
$latestPath = Join-Path $distDir $dLatest
[System.IO.File]::WriteAllText($latestPath, ($latest | ConvertTo-Json), (New-Object System.Text.UTF8Encoding($false)))
Write-Host ""
Write-Host "[publish] upload to ${dUser}@${dHost}:${dRemDir}/ ..." -ForegroundColor Yellow
$scpArgs = @('-i', $dKey, '-P', "$dPort", '-o', 'StrictHostKeyChecking=accept-new')
& scp @scpArgs $apkDest "${dUser}@${dHost}:${dRemDir}/"
if ($LASTEXITCODE -ne 0) {
Write-Host "[error] APK upload failed (scp exit code $LASTEXITCODE)" -ForegroundColor Red
exit 1
}
& scp @scpArgs $latestPath "${dUser}@${dHost}:${dRemDir}/"
if ($LASTEXITCODE -ne 0) {
Write-Host "[error] $dLatest upload failed (scp exit code $LASTEXITCODE)" -ForegroundColor Red
exit 1
}
Write-Host ""
Write-Host "================== publish done ==================" -ForegroundColor Green
Write-Host " download : $dlUrl"
Write-Host " sha256 : $sha256"
Write-Host " updated : ${dRemDir}/${dLatest}"
Write-Host "=================================================" -ForegroundColor Green
}
exit 0