基于uniapp和 Android Studio实现安卓离线打包
2026年1月31日 10:22
一、准备工作
- 下载 HBuilder x,本人版本是:4.87;
- 去官网下载 Android Studio 软件,下载链接;
- Android平台签名证书,可参考Android平台签名证书(.keystore)生成指南 - DCloud问答,我的证书是以
.jks结尾; - Android 离线SDK,版本要和 HBuilder x 一致,链接地址;
![]()
二、 创建 uniapp 工程
![]()
创建工程,选择** uni-app** ,选择默认模板或者 hello uni-app 等。
不要勾选 uni-app x,因为 uni-app x 暂时不支持快速安心打包;
三、uni-app 项目快速安心打包
![]()
打包简单、代码不用上传,但是需要等,因为是在云端打包;花钱可以快速打包;
四、修改 Android 离线 SDK 的配置文件
![]()
使用 Android Studio 打开 Android 离线SDK(解压) 的 HBuilder-Integrate-AS 工程;
![]()
![]()
![]()
修改三个文件,build.gradle、dcloud_control.xml、AndroidManifest.xml;
build.gradle 文件修改包名和配置的签名信息,签名信息需要和准备工作的第三步保持一致;
dcloud_control.xml 修改 appid,这是基于 Hbuilder X 应用自动生成的;
修改AndroidManifest.xml 文件的 AppKey,如何生成和获取,请看第五步;
五、生成 AppKey
在我的应用里面,双击项目名称进入,点击各平台信息,点击新增按钮,会看到以下界面;
![]()
其中 应用签名SHA1 和 应用签名SHA256 是在准备工作第三步生成;
![]()
![]()
点击创建离线 Key 后,在点击查看离线 Key,就可以看到 AppKey 了。
六、离线打包
生成 uniapp 编译文件
![]()
将编译好的文件拷贝
![]()
七、Android Studio 创建设备
![]()
![]()
八、设置自适应图标、应用名称和编译后的安装包名称
![]()
使用 Image Asset 工具生成(最推荐)
不要手动去切几十张不同尺寸的图片,Android Studio 自带的工具能一键搞定:
-
打开工具:在 Android Studio 项目的
res文件夹上点击 右键 -> New -> Image Asset。 -
设置前景 (Foreground Layer):
-
Asset Type选Image。 -
Path选择你高清的 Logo 原图。 - 调整 Resize 滑块:观察预览窗口中的圆圈,确保 Logo 完全在圈内。
-
-
设置背景 (Background Layer):
- 你可以选一种颜色(Color),也可以选一张背景图(Image)。
-
设置预览 (Options):
-
Name建议保持默认的ic_launcher。
-
-
生成:点击 Next -> Finish。它会自动在
res/mipmap-xxxx下生成所有分辨率的图片。
检查清单文件 (AndroidManifest.xml)
生成好图片后,确保你的 AndroidManifest.xml 指向了这些文件:
<application
android:icon="@mipmap/ic_launcher"
android:roundIcon="@mipmap/ic_launcher_round"
...>
</application>