一、引言
在UniApp开发中，安卓离线打包是一种将H5混合应用转换为原生安卓应用（APK）的关键技术。相较于在线云打包，离线打包提供了更高的自定义能力和灵活性，尤其适用于需要集成特定原生功能或优化性能的场景。本文将系统阐述UniApp安卓离线打包的完整流程，包括环境准备、证书配置、资源准备、打包命令及常见问题解决方案。
二、环境准备
1. 安装JDK与Android Studio
离线打包依赖完整的安卓开发环境。首先需安装JDK（建议版本8或11），配置 JAVA_HOME 环境变量。随后安装Android Studio，通过SDK Manager安装最新版本的Android SDK（如Android 12）及NDK（建议版本21+）。确保 ANDROID_HOME 环境变量指向SDK安装路径。
2. 配置HBuilderX
HBuilderX是UniApp官方IDE，需安装最新版本并配置安卓离线打包插件。在菜单栏选择“工具”→“插件安装”，勾选“安卓离线打包”选项。同时，在“设置”→“运行配置”中指定本地SDK路径，确保HBuilderX能正确调用adb工具。
3. 生成签名证书
签名证书是应用上架的必要条件。可通过Android Studio的“Build”→“Generate Signed Bundle/APK”生成，或使用命令行工具 keytool：
keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias
需填写密钥库密码、别名、有效期等信息，生成的 .jks 文件需妥善保管。
三、资源准备
1. 配置 manifest.json
在UniApp项目的 manifest.json 中，需设置安卓应用的基本信息：
{
"appid": "com.example.myapp",
"appname": "MyApp",
"version": {
"name": "1.0.0",
"code": 1
},
"permission": ["android.permission.INTERNET"],
"splashscreen": {
"android": "static/splash.png"
}
}
其中 appid 需为唯一包名， permission 声明应用所需权限， splashscreen 指定启动图路径。
2. 准备原生插件（可选）
若需集成原生功能（如支付、地图），需准备对应的 .aar 或 .jar 文件。在 nativeplugins 目录下创建插件文件夹，包含 plugin.xml 配置文件及库文件。例如，集成高德地图需下载SDK并配置 AndroidManifest.xml 中的API Key。
3. 自定义图标与启动图
替换 uni-app 目录下的 res 文件夹中的图标（ ic_launcher.png）和启动图（ splash.png），确保分辨率符合安卓规范（如启动图建议1080x1920）。
四、离线打包流程
1. 生成Web资源
在HBuilderX中，选择“发行”→“原生App-本地打包”→“安卓”，生成包含HTML、JS、CSS的 www 文件夹。此文件夹将嵌入到原生应用中。
2. 配置Gradle项目
使用Android Studio打开UniApp生成的安卓工程（位于 uni-app/platforms/android）。在 app/build.gradle 中配置签名信息：
android {
signingConfigs {
release {
storeFile file("my-release-key.jks")
storePassword "yourpassword"
keyAlias "my-alias"
keyPassword "yourpassword"
}
}
buildTypes {
release {
signingConfig signingConfigs.release
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
3. 执行打包命令
在Android Studio的“Build”菜单中选择“Build Bundle(s) / APK(s)”→“Build APK(s)”，或通过命令行执行：
cd platforms/android
./gradlew assembleRelease
生成的APK文件位于 app/build/outputs/apk/release/app-release.apk。
五、常见问题与解决方案
1. 签名错误
问题：打包时提示“Keystore was tampered with, or password was incorrect”。
解决：检查 keystore 密码及别名是否正确，或重新生成证书。
2. 权限缺失
问题：应用无法访问网络或存储。
解决：在 manifest.json 中声明权限，并在 AndroidManifest.xml 中添加：
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
3. 原生插件冲突
问题：集成多个插件时出现类重复错误。
解决：在 plugin.xml 中排除冲突的类，或使用 tools:replace 属性覆盖资源。
六、优化与发布
1. 性能优化
- 启用代码混淆：在
proguard-rules.pro中添加混淆规则。 - 压缩资源：使用
Android Resource Optimization工具减少APK体积。
2. 应用上架
将签名后的APK上传至各大应用商店（如华为、小米、OPPO）。需准备应用介绍、截图、隐私政策链接等材料。
七、总结
UniApp安卓离线打包流程涉及环境配置、资源准备、Gradle构建及问题排查等多个环节。通过本文的详细步骤，开发者可高效完成从H5到原生APK的转换，并解决常见问题。建议在实际操作中结合官方文档（如 UniApp离线打包指南）进行参考，确保流程的准确性。