一、引言

在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离线打包指南）进行参考，确保流程的准确性。