OneLIMS 安卓 APK 一键打包说明文档

OneLIMS 安卓 APK 一键打包说明文档

一、打包环境要求

• Node.js（用于前端构建）

• Android Studio（内置 JDK 17）

• Capacitor 项目（已执行 npx cap add android）

二、一键打包脚本（Windows）

在项目根目录（onelims-web）新建文件：build-apk.bat

@echo off

chcp 65001

echo ==============================

echo OneLIMS 一键打包 APK 开始

echo ==============================

echo 1. 打包前端...

call npm run build

echo 2. 同步到 Android...

call npx cap copy android

echo 3. 进入 Android 目录...

cd android

echo 4. 强制使用 JDK17...

set "ORG_GRADLE_JAVA_HOME=C:\Program Files\Android\Android Studio\jbr"

echo 5. 清理缓存...

call gradlew clean

echo 6. 打包 Release APK...

call gradlew assembleRelease

echo ==============================

echo 打包完成

echo ==============================

echo APK 路径：

echo android\app\build\outputs\apk\release\app-release.apk

pause

三、如何使用

双击 build-apk.bat 即可自动完成打包流程。

四、APK 输出位置

android/app/build/outputs/apk/release/app-release.apk

五、常见问题

1. 没生成 APK？
   → 查看是否有 BUILD SUCCESSFUL
2. 还是旧版本？
   → 确保执行了 npm run build 和 npx cap copy android
3. Java 报错？
   → 必须使用 JDK 17（Android Studio 自带）
4. Debug 正常但 Release 不一致？
   → 必须使用 assembleRelease 打包