將 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 run 執行 Flutter 模組的精簡獨立版本，也是一個幫助引導 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 的評估上下文中將自身（作為 :flutter）以及模組使用的任何 Flutter 外掛（例如 :package_info 和 :video_player）包含進去。

在您的應用中引入對 Flutter 模組的 implementation 依賴：

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