1.下载安装Android Studio
下载地址官方地址:Android Studio 下载文件归档 | Android 开发者 | Android Developers
安装Android SDK和Google USB Driver即可,后者主要是为了后期使用USB设置的,如果不需要可以不点。
2.下载uni-app提供的Android离线SDK
下载地址:Android 离线SDK - 正式版 | uni小程序SDK
注意:Android离线SDK的版本一定注意和HBuilder X的版本匹配,版本如果不匹配会报错。
将下载下来的离线SDK进行解压,解压后能够看到HBuilder-Integrate-AS这个文件夹。下面就是围绕这个文件夹展开工作。
下面是解压后的文件夹目录,圈住的就是我们要用到的文件夹。
3.配置AppKey及申请Android平台签名证书
3.1.0版本开始需要申请AppKey,申请步骤参考下面链接
申请 | uni小程序SDK
Android平台签名证书生成链接:
https://ask.dcloud.net.cn/article/35777
4.将解压后的HBuilder-Integrate-AS导入Android Studio
5.修改HBuilder-Integrate-AS里面的配置信息
(1)找到下面目录,删除里面的项目
Android-SDK@3.8.12.81924_20230817->HBuilder-Integrate-AS->simpleDemo->src->main->assets->apps
(2)在BHuilder X里面生成自己的本地资源包
选择菜单栏上的发行->原生App-本地打包->生成本地App打包资源。
看到下面圈住的部分导出成功,路径为...,这就是我们需要使用并替换到Android Studio文件夹下面的项目。
(3)打开资源包生成的地方,复制内容
(4)将其粘贴到
Android-SDK@3.8.12.81924_20230817->HBuilder-Integrate-AS->simpleDemo->src->main->assets->apps下面。
下面是已经删除掉原来的文件夹,替换成了自己的资源文件夹。
刷新Studio里面的目录结构,会发现apps下面的发生了变化,成了自己的放进去的资源文件夹名。
(5)找到dcloud_control.xml文件,修改appid
Android-SDK@3.8.12.81924_20230817->HBuilder-Integrate-AS->simpleDemo->src->main->assets->data->dcloud_control.xml,修改里面的appid。
注意:必须保证dcloud_control.xml里面的appid和
Android-SDK@3.8.12.81924_20230817->HBuilder-Integrate-AS->simpleDemo->src->main->assets->apps->__UNI__EE9C18E->www->manifest.json里面的id一致。
(6)找到simpleDemo->src文件夹下面的AndroidManifest.xml,修改里面的包名和appkey。 下图是修改包名:
该包名在开发者中心获取。
下图是修改appkey。
Appkey也是从开发者中心查看。
注意:这里只修改value值,name值不需要修改。
(7)找到simpleDemo文件夹下面的build.gradle,修改里面的defaultConfig和signingConfigs的配置信息。
·修改defaultConfig里面的applicationId,它的值是开发中心里面的包名。
·修改signingConfigs里面的config信息
注意把在第三步生成的平台签名证书文件放到该文件夹下面。
(8)uniapp生成的本地文件一般不需要修改
6.打包本地apk
点击菜单上的Build->Build Bundle(s) / APK(s)->Build APK,等待打包,然后右下角会提示打包成功,点击 Locate 会打开apk所在文件夹,到此apk打包成功。
点击下方的local就能找到apk的位置。
下方就是打包的apk文件。
在这里可以切换debug和relase形式的apk,如果需要切换点击Build->Select Build Variant来进行切换,切换完成后继续正常打包即可。