将 Flutter 模块集成到 Android 项目中

不使用 Android Studio 集成

要手动将 Flutter 模块与现有 Android 应用集成，而不使用 Flutter 的 Android Studio 插件，请按照以下步骤操作

创建一个 Flutter 模块

我们假设您在 some/path/MyApp 处有一个现有的 Android 应用，并且您希望您的 Flutter 项目作为同级

cd some/path/
flutter create -t module --org com.example flutter_module

这会创建一个 some/path/flutter_module/ Flutter 模块项目，其中包含一些 Dart 代码以帮助你入门，以及一个 .android/ 隐藏子文件夹。 .android 文件夹包含一个 Android 项目，它既可以帮助你通过 flutter run 运行 Flutter 模块的精简独立版本，又是一个包装器，可帮助引导 Flutter 模块成为一个可嵌入的 Android 库。

Java 版本要求

Flutter 要求你的项目声明与 Java 11 或更高版本兼容。

在尝试将 Flutter 模块项目连接到宿主 Android 应用之前，请确保你的宿主 Android 应用在应用的 build.gradle 文件中的 android { } 块下声明了以下源兼容性。

android {
  //...
  compileOptions {
    sourceCompatibility 11 // The minimum value
    targetCompatibility 11 // The minimum value
  }
}

集中存储库设置

从 Gradle 7 开始，Android 建议在 settings.gradle 中使用集中存储库声明，而不是在 build.gradle 文件中的项目或模块级别声明。

在尝试将 Flutter 模块项目连接到宿主 Android 应用之前，请进行以下更改。

1. 删除应用的所有 build.gradle 文件中的 repositories 块。

   // Remove the following block, starting on the next line
       repositories {
           google()
           mavenCentral()
       }
   // ...to the previous line
   

2. 将此步骤中显示的 dependencyResolutionManagement 添加到 settings.gradle 文件。

   dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
     repositories {
       google()
       mavenCentral()
     }
   }
   

依赖模块的源代码

此选项为您的 Android 项目和 Flutter 项目启用一步式构建。当您同时处理这两个部分并快速迭代时，此选项很方便，但您的团队必须安装 Flutter SDK 才能构建宿主应用。

将 Flutter 模块作为子项目包含在宿主应用的 settings.gradle 中。此示例假定 flutter_module 和 MyApp 存在于同一目录中

// Include the host app project.
include ':app'                                    // assumed existing content
setBinding(new Binding([gradle: this]))                                // new
evaluate(new File(                                                     // new
    settingsDir.parentFile,                                            // new
    'flutter_module/.android/include_flutter.groovy'                   // new
))                                                                     // new

绑定和脚本评估允许 Flutter 模块在 settings.gradle 的评估上下文中 include 自身（作为 :flutter）以及模块使用的任何 Flutter 插件（例如 :package_info 和 :video_player）。

从您的应用中引入一个 implementation 依赖项，该依赖项来自 Flutter 模块

dependencies {
    implementation project(':flutter')
}