向现有Android应用添加Flutter Module并触发指定路由的问题

核心痛点 #

• 使用Flutter缓存引擎时，Application启动阶段就初始化Flutter模块，导致initState提前执行，切换到Flutter页面后数据无法正常加载
• 尝试通过setInitialRoute指定目标路由无效，使用pushRoute则返回键会回到Flutter的/root页面而非Android应用
• 需要Android侧能触发多个Flutter页面，且返回逻辑符合预期

实用解决方法 #

1. 按需初始化Flutter引擎（避免提前预加载） #

不在Application.onCreate中提前初始化并缓存Flutter引擎，而是在首次打开Flutter页面时再创建引擎，后续复用缓存的引擎。这样可以避免initState提前执行，同时确保初始路由生效。

2. 通过MethodChannel传递路由指令+替换路由栈 #

在Android侧触发Flutter页面时，通过MethodChannel告诉Flutter要跳转的目标路由，并且使用Navigator.pushReplacement替换当前路由栈，这样返回键会直接回到Android应用，而不是Flutter的初始页面。

3. 动态设置初始路由并结合Flutter路由监听 #

如果必须使用预缓存的引擎，需要在每次打开FlutterActivity时，通过Intent传递目标路由参数，在Flutter侧监听路由参数并动态跳转，同时清空路由栈。

修改后的代码示例 #

Android端代码调整 #

MainApplication.kt（取消提前初始化引擎）

const val FULL_SCREEN_ENGINE_ID = "fullScreenEngineId"

class MainApplication: Application(){
    override fun onCreate() {
        super.onCreate()
        // 不在此处预初始化Flutter引擎，改为按需创建
    }
}

CustomFlutterActivity.kt（按需创建引擎+传递路由参数）

class CustomFlutterActivity: FlutterActivity() {

    companion object{
        const val CHANNEL = "net.ahmettalha.flutteroid_app"
        const val FULL_SCREEN_ENGINE_ID = "fullScreenEngineId"
        const val EXTRA_TARGET_ROUTE = "target_route"
    }

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        val targetRoute = intent.getStringExtra(EXTRA_TARGET_ROUTE) ?: "/root"
        val dataMap = intent.getSerializableExtra("nameAndEmail") as? HashMap<String, String>

        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL)
            .setMethodCallHandler { call, result ->
                when(call.method){
                    "getInitialData" -> {
                        result.success(dataMap)
                    }
                    else -> result.notImplemented()
                }
            }

        // 传递初始路由给Flutter
        flutterEngine.navigationChannel.setInitialRoute(targetRoute)
    }

    override fun provideFlutterEngine(context: Context): FlutterEngine? {
        var flutterEngine = FlutterEngineCache.getInstance().get(FULL_SCREEN_ENGINE_ID)
        if (flutterEngine == null){
            // 首次创建引擎
            flutterEngine = FlutterEngine(context)
            flutterEngine.dartExecutor.executeDartEntrypoint(DartExecutor.DartEntrypoint.createDefault())
            FlutterEngineCache.getInstance().put(FULL_SCREEN_ENGINE_ID, flutterEngine)
        }
        return flutterEngine
    }
}

MainActivity.kt（传递目标路由参数）

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val sendButton = findViewById<Button>(R.id.button)
        val nameInput = findViewById<EditText>(R.id.editTextText)
        val editInput = findViewById<EditText>(R.id.editTextTextEmailAddress)

        sendButton.setOnClickListener {
            val dataMap = hashMapOf(
                "name" to nameInput.text.toString(),
                "email" to editInput.text.toString()
            )

            val intent = Intent(this, CustomFlutterActivity::class.java)
            intent.putExtra("nameAndEmail", dataMap)
            // 指定要打开的Flutter路由
            intent.putExtra(CustomFlutterActivity.EXTRA_TARGET_ROUTE, "/home")
            startActivity(intent)
        }
    }
}

Flutter端代码调整（处理路由+替换栈） #

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 初始化MethodChannel
  const platform = MethodChannel('net.ahmettalha.flutteroid_app');
  
  // 获取Android传递的初始数据
  Map<String, dynamic>? initialData;
  try {
    initialData = await platform.invokeMethod('getInitialData');
  } on PlatformException catch (e) {
    print("Failed to get data: '${e.message}'.");
  }

  runApp(MyApp(initialData: initialData));
}

ColorScheme _colorScheme = ColorScheme.fromSeed(
    seedColor: const Color.fromARGB(255, 209, 121, 5), brightness: Brightness.light);

class MyApp extends StatelessWidget {
  final Map<String, dynamic>? initialData;
  const MyApp({super.key, this.initialData});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      theme: ThemeData().copyWith(useMaterial3: true, colorScheme: _colorScheme),
      initialRoute: "/root",
      routes: {
        "/root": (context) => const RootPage(),
        "/home": (context) => HomeScreen(data: initialData),
      },
      // 监听初始路由，替换栈确保返回直接到Android
      onGenerateRoute: (settings) {
        if (settings.name == "/home") {
          return MaterialPageRoute(
            builder: (context) => HomeScreen(data: initialData),
            settings: settings,
          );
        }
        return null;
      },
    );
  }
}

// HomeScreen示例
class HomeScreen extends StatefulWidget {
  final Map<String, dynamic>? data;
  const HomeScreen({super.key, this.data});

  @override
  State<HomeScreen> createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  @override
  void initState() {
    super.initState();
    // 这里可以正常使用widget.data初始化数据
    print("HomeScreen initState: ${widget.data}");
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("Home")),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text("Name: ${widget.data?['name'] ?? 'N/A'}"),
            Text("Email: ${widget.data?['email'] ?? 'N/A'}"),
          ],
        ),
      ),
    );
  }
}

class RootPage extends StatelessWidget {
  const RootPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("Root")),
      body: const Center(child: Text("Root Page")),
    );
  }
}

额外优化建议 #

• 如果需要频繁切换多个Flutter页面，建议为不同的页面场景创建独立的Flutter引擎缓存ID，避免路由栈混乱
• 在Flutter侧使用Navigator.of(context).popUntil((route) => route.isFirst)确保返回逻辑正确，或者直接使用SystemNavigator.pop()回到Android应用

内容的提问来源于stack exchange，提问作者ATK