Android 开发集成 uni 小程序，并实现相互通信

原创

已于 2025-11-06 10:28:17 修改 · 1.3k 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#android #小程序

于 2025-09-18 17:35:59 首次发布

前言

本文主要实现在Android环境下以wgt包的形式集成uni小程序，并实现小程序跟安卓宿主之间的相互通信，主要包括安卓宿主集成uni小程序的SDK,安卓项目准备，导入依赖，资源配置，uniapp的打包，导入等注意事项

一、Android 集成 uni 小程序

1 下载uni小程序的SDK

点击红色箭头即跳转到下载链接官方SDK 官方集成文档

2 创建安卓项目

下面我们创建一个项目，项目的名称和包名你自己设置就可以了，项目创建完成，我们先通过手机真机运行一下，检查是否能正常运行。当你看到手机上出现Hello World!就表示你的项目没有问题，

如果运行失败，报 gradle 下载失败，则是 gradle 下载源导致的替换下国内腾讯云的镜像服务器地址

在app 目录下新建libs文件夹

3 添加uniSDK基础依赖及文件

Libs文件夹中的依赖库是不用全部都集成到宿主项目中。除视频、地图、分享、支付、登录、直播pusher等SDK，只集成基础模块如下:

把以上aar包复制到项目里如下注意：minSdkVersion 必须是19以上导入aar需要新增配置

    defaultConfig {
        applicationId "com.summer.my35"
        minSdkVersion 23 // uniapp必须是19及以上
        targetSdkVersion 31
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

注意此处配置必须添加否则UNI无法正确运行

  //此处配置必须添加 否则UNI无法正确运行
    aaptOptions {
        additionalParameters '--auto-add-overlay'
        //noCompress 'foo', 'bar'
        ignoreAssetsPattern "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"
    }

在新版本的 build.gradle 的 dependencies 中依赖声明方式发生了改变新版方式为

libs.xxx , 这是 Android Studio 近年来引入的 Version Catalog（版本目录）管理方式。
所有依赖的坐标（如androidx.appcompat:appcompat）和版本号（如1.6.1）都统一定义在项目的 libs.versions.toml ,在build.gradle中只需通过libs.xxx引用，无需重复写版本号。

而新版中也无需再 build.gradle 中导入aar 配置，而是在 setting.gradle 中配置

新版旧版还有很多不习惯的地方，也只有慢慢在项目中碰，再去熟悉

最终的buid.gradle为

plugins {
    alias(libs.plugins.android.application)
}

android {
    namespace 'com.example.my35'
    compileSdk 35

    defaultConfig {
        applicationId "com.example.my35"
        minSdk 21 // uniapp必须是19及以上
        targetSdk 35