小工具知识网

当前位置: 首页 > 行业知识 > 未配置appkey或配置错误,uniapp原生安卓(DCloud之Android原生工程配置)

行业知识

未配置appkey或配置错误,uniapp原生安卓(DCloud之Android原生工程配置)

2026-11-07 12:54:09 来源:互联网转载

报错内容

一、准备开发环境

1.安装Idea,配置java环境

这里就不再赘述,百度上有很多很好的教材。

查看java环境是否安装好

在命令行中输入java来检查是否安装好,出现以下内容则证明安装成功

2.下载app离线sdk

Android 离线SDK - 正式版 | uni小程序SDK

使用SDK目录中的UniPlugin-Hello-AS文件(我这里是将文件保存在了uniapp项目中,方便本地打包时将资源放进去)。

将UniPlugin-Hello-AS文件导入Idea中。

二、生成appkey

1.生成Android 证书签名

生成证书签名有两种方式,一种可以在Idea里面生成,一种则是在本地生成。

Idea中生成一个证书签名

点击Idea左上角的Build,并依次按一下步骤走。

这是我已经创建过的缓存(可以跳完)

//命令行keytool -list -v -keystore demo.keystore
本地上生成一个证书签名

输入cmd,在命令行中输入命令

keytool -genkey -alias key0 -keyalg RSA -keysize 2048 -validity 36500 -keystore demo.keystore

key0是证书别名,可修改为自己想设置的字符,建议使用英文字母和数字

demo.keystore 是证书文件名称,可修改为自己想设置的文件名称,也可以指定完整文件路径

36500 是证书的有效期,表示 100 年有效期,单位天,建议时间设置长一点,避免证书过期

找到刚刚生成的证书并将其移动到项目中的app目录下

本地生成的证书到这里就完成,下面的步骤则是一样的。

//命令行keytool -list -v -keystore demo.keystore
2.申请appkey

拿到这两个密钥之后,我们打开dcloud开发者中心,注意开发者中心中登录的账号是和hbuilder登录的账号是一致的

查看项目的appid是否正确,要和hbuilder的appid是一致的

点击申请一个离线打包key,点击前往

点击新增来添加一个

填写完下面的信息之后点击提交

提交完之后来到这个界面,点击创建离线打包key

会有一个弹窗,核对appid无误后点击创建

创建完之后点击查看,就可以看到一个appkey

至此,一个appkey就申请好了,这个appkey后续会用到。

三、Android应用配置

配置Appkey 

获取到android平台的AppKey后!打开Android项目配置主APP的Androidmanifest.xml文件,导航到 Application 节点,创建一个meta-data 节点,name 为dcloud_appkey(注意:这个名称是不能改动的!!!),value为刚刚申请的AppKey 如下:

 
build.gradle配置
android {...    compileSdk 33    defaultConfig {        applicationId "com.test.demo.myapp"        minSdkVersion 23        targetSdk 33 //建议此属性值设为21 io.dcloud.PandoraEntry 作为apk入口时   必须设置          targetSDKVersion>=21 沉浸式才生效        versionCode 1        versionName "1.0.0"        multiDexEnabled true        ndk {            abiFilters 'x86', 'armeabi-v7a'        }    }    signingConfigs {        config {            keyAlias 'key0'            keyPassword '123456'            storeFile file('demo.keystore')            storePassword '123456'            v1SigningEnabled true            v2SigningEnabled true        }    }...}

versionCode 为应用的版本号(整数值),用于各应用市场的升级判断,建议与 manifest.json 中version -> code 值一致

versionName 为应用的版本名称(字符串),在系统应用管理程序中显示的版本号,建议与 manifest.json 中 version -> name 值一致。

applicationId 为应用的包名,一般设置为反向域名,不建议修改。

注意这里的applicationId包名为我们刚刚申请的appkey时设置的包名。即如下图。

建议将 targetSdkVersion 设置为 25 或以上。

App 离线 SDK minSdkVersion 最低支持 21,小于 21 在部分 5.0 以下机型上将无法正常使用。

signingConfigs -> config 配置

keyAlias 为签名证书别名 

keyPassword 为签名证书密码

storeFile file 为签名证书路径

storePassword 密码

v1SigningEnabled v2SigningEnabled 兼容v1 v2

配置应用名称

打开 app-> src -> main -> res -> values -> strings.xml 文件,修改 “app_name” 字段值,该值为安装到手机上桌面显示的应用名称,建议与 manifest.json 中 name(基础配置中的应用名称)对应。

配置应用启动页及 provider 节点

将下述 activity 信息添加到 Androidmanifest.xml 的application节点中

注意:新建的项目默认会有一个 MainActivity 的节点,必须删掉!

注意:为适配折叠屏,需要在 PandoraEntryActivity 的 android:configChanges 属性中追加 “smallestScreenSize|screenLayout|screenSize”,参考如下配置。

                                                                                                                                                                                                                                                                                                                                                                                                      

添加 provider 信息到 Androidmanifest.xml 的 application 节点中

注意:3.3.7 及以上版本,可以不添加(本示例不添加)

     

注意:Androidmanifest.xml 中 manifest 的 package 包名要和刚刚配置的appkey包名一致

 

将对应的 application 配置到 Androidmanifest.xml 中

 

android:icon 表示app的图标

android:label 表示app的名称

配置应用图标和启动界面

图标名称:

icon.png 为应用的图标。

push.png 为推送消息的图标。

splash.png 为应用启动页的图标。

将 icon.png、push.png、splash.png 放置到 drawable,drawable-ldpi,drawable-mdpi,drawable-hdpi,drawable-xhdpi,drawable-xxhdpi文件夹下,不同文件夹下对应不同图片尺寸

注意:splash.png 在不同设备上显示效果不一样,为防止出现拉伸的状况,建议使用 Android studio 生成 .9.png 类型图片

资源配置

默认项目没有 assets 文件夹,需手动创建,创建位置与 java 目录同级。

创建 data 文件夹并拷贝资源

将 SDK->assets->data 文件夹拷贝到刚刚创建的 assets 文件夹下:

注意:SDK升级时,data下资源需要同时更新。

修改dcloud_control.xml 文件

修改 dcloud_control.xml 中的 appid 为 uni-app 的 appid,确保 dcloud_control.xml 中的 appid 与 manifest.json 中的 appid 与文件夹名一致

至此,项目配置就完成了,我们可以运行跑一下项目。

能进去到这个页面且不报错就表示成功了。

上一篇:服务器怎么安mod?

下一篇:undoctor怎么读?