将 Flutter 模块集成到您的 Android 项目中

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

假设您在 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 模块的精简独立版本，并使用 flutter run，同时它也是一个有助于引导 Flutter 模块并将其嵌入可嵌入 Android 库的包装器。

Flutter 要求您的项目声明与 Java 17 或更高版本的兼容性。

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

android {
    // ...
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17 // The minimum value
        targetCompatibility = JavaVersion.VERSION_17 // The minimum value
    }
    // ...
}

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

在尝试将您的 Flutter 模块项目连接到您的主机 Android 应用程序之前，对您的主机应用程序进行以下更改

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

   groovy

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

   content_copy

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

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    val storageUrl: String = System.getenv("FLUTTER_STORAGE_BASE_URL") ?: "https://storage.googleapis.com"
    repositories {
        google()
        mavenCentral()
        maven("$storageUrl/download.flutter.io")
    }
}

dependencyResolutionManagement {
    repositoriesMode = RepositoriesMode.PREFER_SETTINGS
    String storageUrl = System.env.FLUTTER_STORAGE_BASE_URL ?: "https://storage.googleapis.com"
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("$storageUrl/download.flutter.io")
        }
    }
}

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

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

如果您正在使用 Kotlin，请应用以下更改

// Include the host app project. Assumed existing content.
include(":app")
// Replace "flutter_module" with whatever package_name you supplied when you ran:
// `$ flutter create -t module [package_name]
val filePath = settingsDir.parentFile.toString() + "/flutter_module/.android/include_flutter.groovy"
apply(from = File(filePath))

如果您正在使用 Groovy，请应用以下更改

// Include the host app project.
include(":app")                                   // assumed existing content
setBinding(new Binding([gradle: this]))           // new
def filePath = settingsDir.parentFile.toString() + "/flutter_module/.android/include_flutter.groovy" // new
apply from: filePath                              // new

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

从您的应用程序中引入对 Flutter 模块的 implementation 依赖项

dependencies {
    implementation(project(":flutter"))
}