Android原生项目集成Flutter模块极简指南

Android原生项目集成Flutter模块极简指南

1. 前置准备

• 确保已安装：
  • Android Studio（2020.3.1+）
  • Flutter SDK 3.0+
• 创建Flutter模块：

  flutter create -t module flutter_module
  

---

2. 关键配置步骤

（1）修改 settings.gradle.kts

dependencyResolutionManagement {repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)repositories {google()mavenCentral()maven("https://storage.googleapis.com/download.flutter.io")}
}// 核心配置（自动包含:flutter模块）
apply(from = "../flutter_module/.android/include_flutter.groovy")

（2）添加模块依赖

// app/build.gradle.kts
dependencies {implementation(project(":flutter")) // 引入Flutter模块
}

---

3. 原理解析

• 为什么不需要 include(":flutter")？
  include_flutter.groovy 脚本已自动处理模块引入和路径配置。

• 必须的Flutter仓库
  storage.googleapis.com 提供Flutter引擎和插件的编译产物。

---

4. 常见问题

问题	解决方案
依赖解析失败	检查仓库URL和网络代理
插件未生效	运行 ./gradlew :app:dependencies 验证
版本冲突	使用 resolutionStrategy.force()

---

5. 最佳实践

• 路径管理：使用相对路径 ../flutter_module
• CI/CD适配：预编译Flutter模块（flutter build aar）
• 包体积优化：仅打包所需ABI（armeabi-v7a/arm64-v8a）

---