在已有Android工程中添加Flutter模块

一、环境配置：

Android studio：Android Studio Otter 2 Feature Drop | 2025.2.2

Flutter 3.38.3 • channel stable • https://mirrors.sjtug.sjtu.edu.cn/git/flutter-sdk.git

Framework • revision 19074d12f7 (3 weeks ago) • 2025-11-20 17:53:13 -0500

Engine • hash 8bf2090718fea3655f466049a757f823898f0ad1 (revision 13e658725d) (20 days ago) • 2025-11-20 20:19:23.000Z

Tools • Dart 3.10.1 • DevTools 2.51.1

二、添加步骤：

1.进入已有android工程的同级目录

2.创建flutter module

bash 复制代码

# 终端执行已下命令，flutter_module：flutter 模块名，可以自己命名
flutter create -t module flutter_module

3.在已有android工程的根目录中的Settings.gradle中添加如下代码

Kotlin 复制代码

...
rootProject.name = "FlutterHybirdDemo"
include(":app")

// FlutterHybirdDemo 为已有的android工程根目录
val filePath =
    settingsDir.parentFile.toString() + "/flutter_module/.android/include_flutter.groovy"
apply(from = File(filePath))

4.在app模块依赖新建的flutter模块，固定写法

Kotlin 复制代码

//注：不要写成flutter模块名，这里是固定写法
implementation(project(":flutter"))

5.在android/app/src/main/AndroidManifest.xml中添加如下代码

XML 复制代码

<activity
    android:name="io.flutter.embedding.android.FlutterActivity" android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density"
    android:hardwareAccelerated="true"
    android:windowSoftInputMode="adjustResize" />

6.从原生页面打开Flutter页面

Kotlin 复制代码

vb.btnFlutter.setOnClickListener {
    startActivity(FlutterActivity.createDefaultIntent(this))
}

7.处理构建时错误

错误1：

修改已有android工程根目录中settings.gradle.kts中的代码

Kotlin 复制代码

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    //改为
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    ...
}

错误2：

找不到一些代码包，在已有android工程根目录中settings.gradle.kts中的添加：

Kotlin 复制代码

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
        //添加这个仓库
        maven { url = uri("https://storage.googleapis.com/download.flutter.io") }
    }
}

官方文档

FlutterAddNativeAppDemo