如何通过自定义入口点用FlutterFragment将Flutter布局嵌入Android应用？

你遇到的问题并不是FlutterFragment本身不能用，而是自定义入口点的FlutterFragment创建方式不对——官方示例里的FlutterFragment.createDefault()是封装好的默认入口（对应Dart里的main()函数）快捷方式，但自定义入口点需要通过专门的构建器来配置，这样生成的Fragment才能被FragmentTransaction.add()正常接受。

针对你的环境（AndroidX、Flutter v1.12.13+hotfix.5），可以按照以下步骤正确创建带自定义入口点的FlutterFragment：

1. 使用FlutterFragment.withNewEngine()构建实例 #

这个方法是创建新FlutterEngine并绑定自定义入口点的标准方式，你可以通过链式调用配置入口点、初始路由等参数：

if (flutterFragment == null) {
    // 构建带自定义入口点的FlutterFragment
    val newFlutterFragment = FlutterFragment.withNewEngine()
        .dartEntrypoint("custom_main") // 替换成你Dart端的自定义入口函数名
        .initialRoute("/custom-screen") // 可选：指定Flutter初始路由
        .build<FlutterFragment>()

    flutterFragment = newFlutterFragment
    // 正常添加到Fragment容器
    supportFragmentManager.beginTransaction()
        .add(R.id.fragment_container, newFlutterFragment, TAG_FLUTTER_FRAGMENT)
        .commit()
}

2. Dart端配置自定义入口点 #

在你的Flutter模块代码里，需要定义对应的入口函数，比如在main.dart中：

// 默认入口
void main() => runApp(const DefaultApp());

// 自定义入口点，和Android端指定的名称一致
void customMain() => runApp(const CustomFlutterApp());

关键说明 #

• 为什么之前的方式不行？FlutterFragment.createDefault()本质是封装了默认参数的Builder，它直接绑定了Dart的main()入口。而自定义入口需要显式通过dartEntrypoint()方法指定，必须用withNewEngine()（或withCachedEngine()如果复用引擎）的构建流程，这样生成的Fragment实例类型才符合Android Fragment的要求。
• 如果你需要复用已有的FlutterEngine（比如优化启动速度），可以改用FlutterFragment.withCachedEngine("engine_id")，同样支持链式配置入口点。

这样配置后，你就可以正常将FlutterFragment作为容器添加到Android项目中，完全适配自定义入口点的场景。

内容的提问来源于stack exchange，提问作者Joshua de Guzman