Uniapp-离线打包

说明

App 离线 SDK 主要用于 App本地离线打包及扩展原生能力

注意

1. HBuilderX 3.1.10 版本起需要申请 Appkey，具体请点击链接
2. 更新 SDK 时需要同时更新 aar/jar 文件和 build.gradle 配置
3. App 离线 SDK 不支持 Kotlin
4. HBuilderX3.2.5 版本之后适配了 AndroidX
5. App 离线 SDK minSdkVersion 最低支持 21，小于 21 在部分 5.0 以下机型上将无法正常使用
6. 如果需要集成的第三方 sdk 存在 so 库文件，只需添加 armeabi-v7a、arm64-v8a、x86 三个文件夹即可，否则会导致在部分手机上无法运行
7. appid 不能随便填写，必须点击「重新获取」获取
8. 签名证书不要随意更换，否则会导致用户升级失败！「若之前云打包使用的是 DCloud 默认证书，为保证正常升级，依然可以继续下载 DCloud 证书使用」

Android 离线 SDK下载

注意：根据 HBuilderX 版本下载对应的 SDK

https://nativesupport.dcloud.net.cn/AppDocs/download/android

android 原生工程配置

https://nativesupport.dcloud.net.cn/AppDocs/usesdk/android

第三方 SDK 配置

https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/geolocation

导出 App 资源

https://nativesupport.dcloud.net.cn/AppDocs/importfeproject/export

Android 导入 App 资源

https://nativesupport.dcloud.net.cn/AppDocs/importfeproject/android

Android 打包发行

https://nativesupport.dcloud.net.cn/AppDocs/package/android

注意事项

https://nativesupport.dcloud.net.cn/AppDocs/FAQ/android

版本升级

HBuilderX 中配置并生成打包资源

1. Uniapp 项目中修改 manifest.json 文件，升级 versionName 和 versionCode

2. HBuilderX 选中项目，依次点击 发行-原生App 本地打包-生成本地App打包资源，生成 www 资源目录

   注意：运行基座不要选择 自定义基座 ！！！！

Android Studio 中配置并打包

1. 修改 Android 离线打包项目 app/build.gradle 中版本名和版本号

   1. versionCode 为应用的版本号（整数值），用于各应用市场的升级判断，与 uniapp 项目 manifest.json 中 version -> code 值一致
   2. versionName 为应用的版本名称（字符串），在系统应用管理程序中显示的版本号，与 uniapp 项目 manifest.json 中 version -> name 值一致

2. 将 www 目录，复制到 Android 项目 assets->apps 目录中

3. 应用名称和应用图标【离线打包后最终应用的名称和图标】

   • 在 AndroidManifest.xml 中 application android:label 为 应用名称，android:icon 为应用图标
   • 对应 uniapp 中 manifest.json 文件配置项 应用名称、图标

4. dcloud_control.xml

   • Android 离线打包项目 dcloud_control.xml 中的 appid ，与HBuilderX 项目中 manifest.json 中的 appid一致
   • 不要 debug

   <hbuilder>
   <apps>
       <app appid="__UNI__C6606F" appver=""/>
   </apps>
   </hbuilder>