Flutter 引入 Android AAR:应用模块与依赖声明

在 android/app/libs 放置本地 AAR,并区分 Groovy 与 Kotlin DSL 的声明。

适用版本

原文为 2024 年极光推送 OPPO 通道集成记录,采用本地 AAR。

本文目录
  1. 放入应用模块
  2. 声明本地依赖
  3. AAR 之外的配置
  4. 参考

在 2024 年的极光推送对接中,部分厂商通道需要引入单独的 Android AAR。AAR 放在 Flutter 工程的 Android 应用模块里,并由该模块的 Gradle 文件声明依赖。

放入应用模块

text
flutter_project/
  android/
    app/
      libs/
        vendor-sdk.aar
      build.gradle

这里的 app 是 Android 应用模块,不能把 libs 随意放在 Flutter 的 lib 目录。原集成截图如下。

原集成记录:android/app/libs 目录

声明本地依赖

Groovy 文件 android/app/build.gradle:

groovy
dependencies {
    implementation files('libs/vendor-sdk.aar')
}

Kotlin DSL 文件 android/app/build.gradle.kts:

kotlin
dependencies {
    implementation(files("libs/vendor-sdk.aar"))
}

明确指定文件名,便于管理版本。若目录中只放本模块需要的 AAR,也可以沿用原文的目录匹配方式:

groovy
implementation fileTree(include: ['*.aar'], dir: 'libs')

两种 DSL 的语法不同,应跟随工程现有文件格式填写,不能同时复制到同一文件。

AAR 之外的配置

本地 AAR 不一定包含完整的传递依赖信息。厂商 SDK 依赖的库、Manifest 声明、混淆规则、最低 Android 版本与证书配置,需要与该版本的集成文档一起处理。

同一个库不要同时从 Maven 和本地 AAR 重复引入;升级时也不要在 libs 中并存多个包含相同类的版本。原文的 OPPO 引入方式属于当时极光 SDK 的要求,不能外推为所有版本都必须手工复制。

参考

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。