uniApp安卓离线SDK运行

2023-06-13,,

一、下载uniapp提供的离线SDK包

下载地址:https://nativesupport.dcloud.net.cn/AppDocs/download/android

版本:2022年09月26日发布——HBuilderX(3.6.4.20220922)

二、下载Android Studio

下载地址:https://developer.android.google.cn/studio/index.html

根据默认选项安装即可(该过程可能会提示 Android SDK 问题,忽略即可)

运行IDE,直接打开下载的离线SDK里面的 Hbuilder-Integrate-AS

三、打包uniapp项目

HBuilderX版本:3.6.5

(1)若没有AppID,需要生成AppID

(2)打包

发行 -> 原生App-本地打包 -> 生成本地打包App资源

(3)登录dcloud配置appKey

网址:https://dev.dcloud.net.cn/pages/app/list

注:账号密码与登录HBuilderX的账号密码一致

1. 在应用管理 -> 我的应用 根据Appid找到你的应用
2. 点击应用名称跳转到应用信息
3. 点击“Android云端证书”,点击“创建证书”,等待几分钟,创建成功后点击“证书详情”,将内容复制到其他地方备用
4. 证书创建成功后点击“各平台信息”

a. 所属平台和版本根据实际情况选择,这里只以Android App为例
b. 包名可以根据下载的离线包里面的applicationId填写

Hbuilder-Integrate-AS -> simpleDemo -> build.gradle -> defaultConfig.applicationId

defaultConfig {
applicationId "com.android.simple"
minSdkVersion 21
targetSdkVersion 28
versionCode 1
versionName "1.0"
multiDexEnabled true
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
c. SHA1、MD5、SHA256的值就是之前申请的证书里面的对应SHA1、MD5、SHA256的值
d. 点击提交,创建成功后,会生成一条信息,点击离线打包key的创建按钮,再点击创建,创建后就可以查看AppKey了

四、配置Android Studio

1. 将打包好的的资源(__UNI__xxx的文件夹)放到Hbuilder-Integrate-AS/simpleDemo/src/main/assets/apps下面,删掉原来的__UNI__xxxx文件夹

2. 修改Hbuilder-Integrate-AS/simpleDemo/build.gradle里面的signingConfigs配置

signingConfigs {
config {
keyAlias '__uni__xxxx' // 证书别名,在证书详情里面可以看到
keyPassword 'xxxxxx' // 密码,点击证书详情,可以看到一个“查看证书密码的按钮”
storeFile file('xxx.keystore') // 将之前的证书下载到simpleDemo目录下,此处文件名为下载的证书文件名
storePassword 'xxxxx' // 密码,与上面一样
v1SigningEnabled true
v2SigningEnabled true
}
}

3. 修改Hbuilder-Integrate-AS/simpleDemo/src/main/assets/data/dcloud_control.xml

这里的appid就是HBuilderX生成的那个appID

<app appid="__UNI__xxxx" appver=""/>

4. 修改Hbuilder-Integrate-AS/simpleDemo/src/main/AndroidManifest.xml

将里面的meta-data标签的android:value的值改为之前通过证书申请的appKey

<meta-data
android:name="dcloud_appkey"
android:value="acbfbb4fabsjdjac39108cq7d" />

注:整个流程需要保证:dcloud_control.xml的appid、apps下面的文件夹名称、uniApp项目的appID一致

五、运行

uniApp安卓离线SDK运行的相关教程结束。

《uniApp安卓离线SDK运行.doc》

下载本文的Word格式文档,以方便收藏与打印。