【uniapp】uniapp 离线打包安卓应用或者云打包发布 app 步骤&问题记录

许三千

已于 2025-05-06 18:14:59 修改

阅读量3.7k

点赞数 19

文章标签： android uni-app 前端

于 2025-02-16 21:49:21 首次发布

本文链接：https://blog.youkuaiyun.com/weixin_42957894/article/details/145670700

版权

uniapp 打包发布 app 步骤&问题记录

看了很多篇文章进行测试后，进行详细的记录

1.安卓打包
1.1.本地打包步骤
运行环境：window
参考文档：https://blog.youkuaiyun.com/weixin_38797742/article/details/140298112 https://nativesupport.dcloud.net.cn/AppDocs/usesdk/android.html
●安装 Android Studio 软件，https://developer.android.google.cn/studio/archive?hl=zh-cn
●配置java环境，并配置变量，直至命令行输入java -version，可正常输出版本
下载连链接：jsdk17。目前我安装的环境为17.0.12
在这里插入图片描述

●下载 uniapp 官方提供的 SDK
注意对于用来打包项目的HbuilderX版本是有要求的，其版本需与Android 离线SDK的版本相对应
https://nativesupport.dcloud.net.cn/AppDocs/download/android.html
例如我安装的HBuilderX版本为4.24，下载的离线SDK为4.24所对应版本
在这里插入图片描述

●打开下载的应用包结构如下，打开Android Studio直接导入HBuilder-Integrate-AS工程，等待其构建完成在这里插入图片描述

●首次导入会提示，选择信任项目在这里插入图片描述

●导入项目后，会自动构建项目，由于Gradle版本和 Gradle插件版本和 Java版本不匹配或者是下载Gradle包默认是国外地址，第一次基本都会报错
在这里插入图片描述

●查看根目录下的build.gradle文件，dependencies的classpath可以确认当前gradle插件的版本，如我的是4.1.1。
在这里插入图片描述

●查看Gradle插件版本和Gradle版本及对应关系
https://blog.youkuaiyun.com/weixin_40420578/article/details/140160186 在这里插入图片描述

			比如我的Gradle插件版本是4.1.1。对应的Gradle版本应该6.5+	![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/2650b752cc4b4bdc99e4cd68e3fe4afb.png)

我们查看根目录下的.gradle，里面会显示我们下载了哪些版本的gradle包，比如我的现在默认下载了6.5 在这里插入图片描述

我们更换一个6.5+的版本，比如7.2，注意默认使用的国外下载地址，
修改gradle/wrapper/gradle/wrapper/gradle-wrapper.properties文件
将https://services.gradle.org/distributions修改成国内下载地址https://mirrors.cloud.tencent.com/gradle，将6.5改成我们需要下载的版本7.2 在这里插入图片描述

●点击右上角的“Try Again”，下载对应的gradle包，等待构建在这里插入图片描述

●打开HBuilderX，查看manifest.json中appid，确认和后台一致

在这里插入图片描述

●生成本地打包App资源
在这里插入图片描述

●将生成的资源放入 simpleDemo
打开对应的HBuilder-Integrate-AS\simpleDemo\src\main\assets\apps
将__UNI__A删除，生成的__UNI__372C0A0移入
在这里插入图片描述

●修改配置appid
修改HBuilder-Integrate-AS\simpleDemo\src\main\assets\data\dcloud_control.xml文件的appid，改成HBuilderX中manifest.json的appid
在这里插入图片描述

●生成证书并查看证书
基于java环境，命令行直接生成（路径随意，后面需要把这个文件移动到特定文件夹），填写证书别名，证书密码，选择证书文件路径，生成签名证书。官方文档：https://ask.dcloud.net.cn/article/35777
●查看自己签名的SHA1、SHA256、MD5信息，命令行直接输入下面命令。其中test.keystore为你刚才生成的文件名
keytool -list -v -keystore test.keystore
在这里插入图片描述

●将签名信息同步到后台应用信息
https://dev.dcloud.net.cn/pages/app/list
在这里插入图片描述

●根据签名信息生成离线打包key
在这里插入图片描述

这里Android：对应的就是离线打包key，复制下来
在这里插入图片描述

●修改配置appid和签名
修改HBuilder-Integrate-AS\simpleDemo\src\main\AndroidManifest.xml文件。
package，改成HBuilderX中manifest.json的appid。
在这里插入图片描述

android:value改成离线打包key。
在这里插入图片描述

●修改打包apk的包名等
将这段代码放入HBuilder-Integrate-AS\simpleDemo\build.gradle
android.applicationVariants.all {
variant ->
variant.outputs.all {
// outputFileName对应的值就是名称
// outputFileName = “Floating- ${variant.name}-v$ {variant.versionName}.apk”
outputFileName = “test.apk”
}
}
在这里插入图片描述

同时需要修改defaultConfig的applicationId为后台填写的包名（这里填写错误的话，打开app会提示“未配置appkey或配置错误”）
在这里插入图片描述

●配置证书信息
还是这个文件，HBuilder-Integrate-AS\simpleDemo\build.gradle
修改signingConfigs信息。在这里插入图片描述

注意填写完storeFile file证书路径后，要将证书移动到对应位置，比如我填写的是test.keystore，就需要将之前生成的证书放入到同一级的文件夹内。在这里插入图片描述

●配置应用名
HBuilder-Integrate-AS\simpleDemo\src\main\res\values\strings.xml 在这里插入图片描述

●构建/打包apk 在这里插入图片描述

等待构建，直至输出BUILD SUCCESSFUL 在这里插入图片描述

输出路径为HBuilder-Integrate-AS\simpleDemo\build\outputs\apk\debug下的apk 在这里插入图片描述

●如果打包失败，需要更换jdk版本在这里插入图片描述

这里我Gradle jdk选择的是1.8，选择其他版本会构建失败（这里版本选择有疑问）在这里插入图片描述

注意更换jdk版本后要同步（右上角synv now），然后重新打包。在这里插入图片描述

●修改应用图标
○打开hbuilderX，可以看到配置的图标文件夹为unpackage/res/icons 在这里插入图片描述

○在HBuilder-Integrate-AS\simpleDemo\src\main\res\drawable中有默认的图标，只需要替换该文件夹的图片。
●icon.png为应用的图标。
●push.png为推送消息的图标。
●splash.png为应用启动页的图标。
○针对不同的设备，还应该建立drawable-ldpi，drawable-mdpi，drawable-hdpi，drawable-xhdpi，drawable-xxhdpi等文件夹，来控制不同设备加载那个图标，每个文件夹下面都应该包含icon.png、push.png、splash.png
○校验下图标配置
HBuilder-Integrate-AS\simpleDemo\src\main\AndroidManifest.xml中application节点的icon属性为@drawable/icon。在这里插入图片描述

●应用体积问题（手机CPU类型配置）
概念参考：https://cloud.tencent.com/developer/article/2062580
https://uniapp.dcloud.net.cn/tutorial/app-android-abifilters.html#%E9%85%8D%E7%BD%AE%E6%94%AF%E6%8C%81%E7%9A%84cpu%E7%B1%BB%E5%9E%8B
○在HBuilder-Integrate-AS\simpleDemo\build.gradle中的defaultConfig加入
ndk {
abiFilters “armeabi-v7a”,“arm64-v8a”
}
重新打包在这里插入图片描述

打包后的大小对比在这里插入图片描述

1.2.云打包
●HBuilderX -> 菜单 -> 发行 -> 原生App -> 云打包
在这里插入图片描述

●如果没有注册HBuilderX会弹出下图弹窗就需要先注册账号（免费），如果已经有账号了就直接登陆
在这里插入图片描述

●进入打包页面，勾选Android（apk包），填写配置信息
Android包名：自动生成
Android证书：均免费，三种证书后面都有对应的详细说明
○云端证书：直接勾选即可使用
○公共测试：直接勾选即可使用
○自有证书：需要自己制作，基于java环境，命令行直接生成，填写证书别名，证书密码，选择证书文件路径，生成签名证书。官方文档：https://ask.dcloud.net.cn/article/35777
○打包方式：传统打包，快速安心打包（不上传代码和证书），两种方式均可在这里插入图片描述

●填写完配置信息后，点击打包在这里插入图片描述

●等待控制台输入打包完成在这里插入图片描述

●打包后的文件路径如下：根目录/unpackage/release/apk
也可以直接点击控制台的【打开所在目录】在这里插入图片描述

1.3.问题
1.3.1.安卓本地打包后，真机安装apk打开提示“未配置appkey或配置错误”
情况1：applicationId错误，必须是包名在这里插入图片描述

defaultConfig {
applicationId “uni.center_tks”
minSdkVersion 21
targetSdkVersion 28
versionCode 1
versionName “1.0”
multiDexEnabled true
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}

情况2：
原因：离线打包时，填写的证书文件为本地的，填写的离线打包Key所绑定的证书为云端证书
解决：重新在dcloud后台修改应用的证书信息，重新生成离线打包Key，重新填写离线打包离线打包Key

在dcloud后台修改应用的证书信息在这里插入图片描述

这里填写本地证书文件的SHA1和SHA256值（test.keystore为你的本地证书）
keytool -list -v -keystore test.keystore
Enter keystore password: //输入密码，回车
在这里插入图片描述

查看-删除配置查看-重新生成在这里插入图片描述

重新填写离线打包离线打包Key
修改AndroidManifest.xml中的android:value值
在这里插入图片描述

1.3.2.安卓本地打包后，真机安装apk，调用蓝牙时提示“打包时未添加bluetooth模块” 在这里插入图片描述

参考文档：https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/others.html https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android.html
●将下载目录/SDK/libs下的lib.5plus.base-release.aar和uniapp-release.aar放入到libs文件夹下（试了这一步其实不需要执行，默认就有了）
●将下载目录/SDK/assets下的data文件放入项目assets目录下。
●打开我们下载的SDK文件夹，在SDK\libs中找到对应的模块，比如蓝牙是Bluetooth-release，将这个文件复制到我们项目中（HBuilder-Integrate-AS\simpleDemo\libs）在这里插入图片描述