Bob自习室

Appearance

Uni-app Android 本地打包步骤 (安装 Android Studio 打包 SDK) ​

1. 下载安装 Android Studio ​

  • 下载地址：Android Studio 下载文件归档（官方地址）
  • 安装时选择 Android SDK 和 Google USB Driver 即可：
    • Google USB Driver 主要用于后期 USB 调试，不需要可忽略

2. 下载 uni-app 提供的 Android 离线 SDK ​

  • 下载地址：Android 离线 SDK - 正式版（uni 小程序 SDK） An image

  • 注意：Android 离线 SDK 的版本必须与 HBuilder X 的版本匹配，版本不匹配会导致报错

  • 解压下载的离线 SDK，解压后可见 HBuilder-Integrate-AS 文件夹，后续操作围绕该文件夹展开

  • 下面是解压后的文件夹目录，圈住的就是我们要用到的文件夹。 An image

3. 配置 AppKey 及申请 Android 平台签名证书 ​

bash
keytool -genkey -alias testalias -keyalg RSA -keysize 2048 -validity 36500 -keystore test.keystore

4. 将 HBuilder-Integrate-AS 导入 Android Studio ​

将解压后的 HBuilder-Integrate-AS 文件夹导入 Android Studio 中

An image

5. 修改 HBuilder-Integrate-AS 配置信息 ​

（1）清理默认资源 ​

删除以下目录中的项目：

Android-SDK@3.8.12.81924_20230817->HBuilder-Integrate-AS->simpleDemo->src->main->assets->apps

An image

（2）生成并替换本地资源包 ​

  1. 在 HBuilder X 中生成本地资源包：
    • 菜单栏选择 发行->原生 App-本地打包->生成本地 App 打包资源
  2. 复制生成的资源包内容
  3. 将其粘贴到以下目录：
    Android-SDK@3.8.12.81924_20230817->HBuilder-Integrate-AS->simpleDemo->src->main->assets->apps
  4. 刷新 Android Studio 目录结构，确认 apps 文件夹内容已更新为自己的资源

An imageAn image

（3）修改 dcloud_control.xml 文件 ​

  • 路径：Android-SDK@3.8.12.81924_20230817->HBuilder-Integrate-AS->simpleDemo->src->main->assets->data->dcloud_control.xml
  • 修改文件中的 appid，确保与以下文件中的 id 一致：
    Android-SDK@3.8.12.81924_20230817->HBuilder-Integrate-AS->simpleDemo->src->main->assets->apps->__UNI__EE9C18E->www->manifest.json
    An imageAn image

（4）修改 AndroidManifest.xml ​

  • 路径：simpleDemo->src 文件夹下的 AndroidManifest.xml
  • 修改内容：
    1. 包名：需与开发者中心获取的包名一致
    2. appkey：从开发者中心查看获取，仅修改 value 值，name 值保持不变

（5）修改 build.gradle 配置 ​

  • 路径：simpleDemo 文件夹下的 build.gradle
  • 修改内容：
    1. defaultConfig 中的 applicationId：设置为开发者中心的包名
    2. signingConfigs 中的 config 信息：
      • 将第三步生成的签名证书文件放入该文件夹
      • 配置证书相关参数（密钥别名、密码等）

An image

（6）注意事项 ​

  • uniapp 生成的本地文件一般不需要修改

6. 打包本地 APK ​

  1. 点击菜单 Build->Build Bundle(s) / APK(s)->Build APK
  2. 等待打包完成，右下角会提示打包成功，点击 Locate 打开 APK 所在文件夹
  3. 在打开的文件夹中，通过 local 路径找到 APK 文件

An imageAn imageAn image

切换打包模式（debug/release） ​

  1. 点击 Build->Select Build Variant
  2. 选择需要的模式（debug/release）
  3. 重新执行打包步骤即可