UniApp调用aar、jar包原生SDK
- hliang
- 0
- Posted on
1. 资源下载
假设开发机上已经有Java开发环境、HBuilderX开发环境。
- 下载AndroidStudio,下载地址:AndroidStudio官网
- 下载Android离线SDK,下载地址:Android离线SDK
本文发表时,SDK最新版本为4.65 。
2. 创建项目
2.1 新建UniAPP项目(HBuilderX)
打开HBuilderX,使用默认模板,新建一个uni-app项目。项目名称取 testAndroidApp 。

创建项目后,打开manifest.json配置文件,记录下图片中红框标识的应用标识、应用版本名称、应用版本号。

在DCloud开发者中心中,找到AppID对应的自动创建的项目,获取项目对应的配置信息。
创建并下载证书

在“证书详情”中找到“别名”、“MD5”、“SHA1”、“SHA256”等信息,保存到本地文档。

点击“查看证书密码”,将证书密码保存到本地文档。

在”各平台信息“中创建“离线发布AppKey”

2.2 导入原生Android项目(AndroidStudio)
打开AndroidStudio,导入下载SDK中的项目UniPlugin-Hello-AS(这里我把项目目录重命名为AS-AppContainer)

编辑 gradle/wrapper/gradle-wrapper.properties 文件,设置gradle源到国内源:
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.11.1-bin.zip
编辑 build.gradle 文件:
修改 android.namespace 和 android.defaultConfig.applicationId 的值为创建”离线发布AppKey“时的”包名“;
修改 android.defaultConfig.versionCode 和 android.defaultConfig.versionName 的值为 HBuilder 中 manifest.json 中的“应用版本号”和“应用版本名称”;
修改 android.signingConfigs.config.keyAlias 的值为“证书详情”中的“别名”;
修改 android.signingConfigs.config.keyPassword 和 android.signingConfigs.config.storePassword 的值为“证书详情”中的“证书密码”;
修改 android.signingConfigs.config.storeFile 的值为下载回来的证书名(下载的证书提前放置到 simpleDemo 目录下)。

点击”Sync Now“同步配置。
编辑 AndroidManifest.xml 文件:
修改 dcloud_appkey 的值为云平台上申请到的离线打包AppKey。

点击”Sync Now“同步配置。
编辑 assets/data/dcloud_control.xml 文件:
在 hbuilder 中添加 debug=”true” 及 syncDebug=”true”,并修改 appid 的值为 manifest.json 中的 AppID 值。

点击”Sync Now“同步配置。
编辑 res/values/strings.xml 文件:
修改 app_name 的值,设置App的名称。

点击”Sync Now“同步配置。
替换资源文件:
替换 res/drawable/icon.png 文件,这是App的图标文件。
替换 res/drawable/splash.png 文件,这是App的开屏显示图片。
替换 res/drawable/push.png 文件,这是App的消息推送图标文件。
替换新版本SDK文件:
用下载回SDK包中 SDK/libs 目录中的文件覆盖项目中 libs 目录中的aar文件,共7个文件,文件列表如下:
- android-gif-drawable-1.2.28.aar
- breakpad-build-release.aar
- debug-server-release.aar
- lib.5plus.base-release.aar
- oaid_sdk_1.0.25.aar
- uniapp-v8-release.aar
- utsplugin-release.aar
2.3 拷贝HBuilder打包资源到AndroidStudio
在 HBuilder 中选择“发行-(App-Android/iOS-本地打包)-生成本地打包App资源“,会在 unpackage/resources 目录下生成 AppID 对应的目录,将其拷贝到 AndroidStudio 工程的 assets/apps 目录中。


点击”Sync Now“同步配置。
3. 预览、调试、离线打包
3.1 开发预览、调试
在AndroidStudio里打包测试基座,首先修改编译参数为debug模式。

然后在菜单中选择“Build – Generate App Bundles or APKs – Generate APKs“,生成自定义基座(位置在 build/outputs/apk/debug 目录下)。
将自定义基座apk文件拷贝到 HBuilder 的 unpackage/debug 目录中,并重命名为 android_debug.apk

在 HBuilder 中选择“运行 – 运行到手机或模拟器 – 运行到Android App基座”,选择“使用自定义基座运行”,即可使用刚刚AndroidStudio中打包的自定义基座调试程序
