uniapp离线打包配置详细教程

“按照uniapp离线打包配置教程操作时，最后生成的apk安装包总是报错闪退，具体应该检查哪些配置环节？官方文档提到的res文件夹配置和AndroidManifest.xml修改都确认过了，但问题依旧存在，有没有完整的排错流程建议？”

2 回复

UniApp离线打包教程：

  1. 安装HBuilderX，创建项目
  2. 配置manifest.json，勾选离线打包
  3. 下载对应平台SDK（Android/iOS）
  4. 导入原生工程，配置签名和包名
  5. 生成资源文件，替换到原生项目
  6. 编译打包生成安装包

注意：Android需配置gradle，iOS需配置证书。


Uniapp 离线打包配置详细教程

环境准备

1. 安装 Android Studio

  • 下载并安装 Android Studio
  • 安装 Android SDK（API 级别建议 21+）
  • 配置 JAVA 环境（JDK 8 或 11）

2. 获取 HBuilderX

  • 下载官方 HBuilderX
  • 准备您的 Uniapp 项目

离线打包步骤

1. 生成原生工程

# 在 HBuilderX 中
发行 → 原生 App-本地打包 → 生成本地打包 App 资源

2. 配置 Android 项目

  1. 下载官方 SDK：从 DCloud 官网获取最新版离线 SDK
  2. 解压 SDK，找到 HBuilder-Integrate-AS 示例工程
  3. 用 Android Studio 打开此工程

3. 关键配置修改

AndroidManifest.xml 配置：

<application
    android:name="io.dcloud.application.DCloudApplication"
    android:allowBackup="true"
    android:icon="@drawable/icon"
    android:label="@string/app_name">
    
    <!-- 必须配置 -->
    <meta-data
        android:name="dcloud_appkey"
        android:value="你的 AppKey" />
</application>

build.gradle 配置：

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "你的包名"
        minSdkVersion 21
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
}

4. 集成资源文件

  1. 将生成的 www 文件夹（包含 app.json、js、css 等）复制到 assets/apps/你的appid/www 目录
  2. 确保目录结构正确：
assets/
└── apps/
    └── __UNI__XXXXXX/
        └── www/
            ├── index.html
            ├── manifest.json
            └── static/

5. 配置应用信息

修改 data/dcloud_control.xml：

<app appid="__UNI__XXXXXX" 
     appver="版本号" 
     baseurl="http://www.example.com/">
</app>

6. 构建 APK

  1. 在 Android Studio 中选择 Build → Generate Signed Bundle / APK
  2. 创建或选择签名文件
  3. 选择构建变体（debug/release）
  4. 完成打包

注意事项

  1. AppKey 申请：需要在 DCloud 开发者中心申请
  2. 权限配置：根据应用需求在 AndroidManifest.xml 中添加相应权限
  3. 插件配置：如需使用原生插件，需按插件文档配置
  4. 版本兼容：确保 SDK 版本与 HBuilderX 版本匹配

常见问题

  • 白屏问题：检查资源路径和 appid 是否正确
  • 打包失败：检查 JDK 版本和 Android SDK 配置
  • 功能异常：确认所有必要权限已添加

完成以上步骤后，即可成功生成离线打包的 Android APK 文件。

回到顶部