内容

在添加到应用中管理插件和依赖项

内容

A. 简单场景
B. 需要项目编辑的插件
C. 合并库

本指南介绍如何设置您的项目以使用插件，以及如何在现有 Android 应用和 Flutter 模块的插件之间管理 Gradle 库依赖项。

在简单的情况下

您的 Flutter 模块使用一个没有其他 Android Gradle 依赖项的插件，因为它仅使用 Android 操作系统 API，例如相机插件。
您的 Flutter 模块使用一个具有 Android Gradle 依赖项的插件，例如来自 video_player 插件的 ExoPlayer，但您的现有 Android 应用不依赖于 ExoPlayer。

无需执行其他步骤。您的添加到应用模块的工作方式与完整的 Flutter 应用相同。无论您是使用 Android Studio、Gradle 子项目还是 AAR 集成，传递的 Android Gradle 库都会根据需要自动捆绑到您现有的外部应用中。

某些插件需要您对项目的 Android 端进行一些编辑。

例如，firebase_crashlytics 插件的集成说明要求您手动编辑 Android 包装项目的 build.gradle 文件。

对于完整的 Flutter 应用，这些编辑是在 Flutter 项目的 /android/ 目录中完成的。

对于 Flutter 模块，模块项目中只有 Dart 文件。请在您的外部现有 Android 应用中而不是在您的 Flutter 模块中执行这些 Android Gradle 文件编辑。

需要稍加注意的情况是，如果您的现有 Android 应用已依赖于 Flutter 模块所依赖的相同 Android 库（通过插件传递）。

例如，现有应用的 Gradle 可能已经包含：

ExistingApp/app/build.gradle
groovy…
dependencies {
    …
    implementation("com.crashlytics.sdk.android:crashlytics:2.10.1")
    …
}
…

而您的 Flutter 模块也通过 pubspec.yaml 依赖于 firebase_crashlytics

flutter_module/pubspec.yaml
yaml…
dependencies:
  …
  firebase_crashlytics: ^0.1.3
  …
…

此插件的使用会再次通过 firebase_crashlytics v0.1.3 自身的 Gradle 文件传递添加 Gradle 依赖项

"firebase_crashlytics_via_pub/android/build.gradle
groovy…
dependencies {
    …
    implementation("com.crashlytics.sdk.android:crashlytics:2.9.9")
    …
}
…

这两个 com.crashlytics.sdk.android:crashlytics 依赖项的版本可能不相同。在本例中，宿主应用请求了 v2.10.1，而 Flutter 模块插件请求了 v2.9.9。

默认情况下，Gradle v5 解决依赖项版本冲突的方法是使用库的最新版本。

这通常是可以的，只要版本之间没有 API 或实现上的重大更改。例如，您可以在现有应用中使用新的 Crashlytics 库，如下所示：

ExistingApp/app/build.gradle
groovy…
dependencies {
    …
    implementation("com.google.firebase:firebase-crashlytics:17.0.0-beta03")
    …
}
…

此方法不可行，因为 Crashlytics 的 Gradle 库版本 v17.0.0-beta03 和 v2.9.9 之间存在重大的 API 差异。

对于遵循语义版本控制的 Gradle 库，通常可以通过在现有应用和 Flutter 模块插件中使用相同的语义主版本来避免编译和运行时错误。

除非另有说明，否则本网站上的文档反映了 Flutter 的最新稳定版本。页面最后更新时间：2024-07-08。查看源代码或报告问题。

A. 简单场景

B. 需要项目编辑的插件

C. 合并库