將 Flutter 模組整合進你的 Android 專案

若要手動將 Flutter 模組整合到現有 Android 應用程式中， 且不使用 Flutter 的 Android Studio 外掛， 請依照下列步驟進行：

假設你已有一個現有的 Android 應用程式，位於 some/path/MyApp，而你希望將 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 中集中宣告 repository，而不是在專案或模組層級的 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 才能建置主應用程式（host app）。

請將 Flutter 模組作為子專案（subproject）包含在主應用程式的 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"))
}