將 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 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 區塊。

   groovy

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

2. 將此步驟中顯示的 dependencyResolutionManagement 新增至 settings.gradle 檔案。

   groovy

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

此選項可讓你的 Android 專案和 Flutter 專案進行單一步驟建置。當你同時處理這兩個部分並快速反覆運算時，此選項會很方便，但你的團隊必須安裝 Flutter SDK 才能建置主機應用程式。

在主機應用程式的 settings.gradle 中將 Flutter 模組包含為子專案。此範例假設 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"))
}