Flutter 2.10.3中@pragma('vm:entry-point')入口点未生效的原因

核心原因 #

@pragma('vm:entry-point') 注解仅用于阻止Dart编译器的树摇优化删除该函数，它不会自动替代main成为Flutter应用的默认启动入口。默认情况下，Flutter启动时只会执行main函数，所以你的entryPoint不会自动运行。

让自定义入口生效的两种方案 #

场景1：替换应用默认启动入口（启动时直接执行entryPoint） #

如果希望应用启动时优先执行entryPoint而非main，需要在原生端（Android/iOS）配置Flutter引擎的启动入口：

Android端配置

打开android/app/src/main/kotlin/[你的包名]/MainActivity.kt，修改configureFlutterEngine方法：

override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    super.configureFlutterEngine(flutterEngine)
    // 指定自定义入口函数名
    flutterEngine.dartExecutor.executeDartEntrypoint(
        DartExecutor.DartEntrypoint.createDefault().withEntrypoint("entryPoint")
    )
}

iOS端配置

打开ios/Runner/AppDelegate.swift，修改引擎初始化代码：

override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
    let flutterEngine = FlutterEngine(name: "MyEngine")
    // 指定自定义入口函数名
    flutterEngine.run(withEntrypoint: "entryPoint")
    GeneratedPluginRegistrant.register(with: flutterEngine)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}

场景2：原生端主动调用自定义入口函数 #

如果entryPoint是供原生触发调用的Dart函数，只需通过MethodChannel让原生主动调用即可，@pragma('vm:entry-point')已经保证函数不会被优化删除：

1. Dart侧添加MethodChannel监听：

void main() {
  print("main");
  const channel = MethodChannel('com.example.entrypoint/call');
  channel.setMethodCallHandler((call) async {
    if (call.method == 'invokeEntryPoint') {
      entryPoint();
    }
  });
}

@pragma('vm:entry-point')
void entryPoint() {
  print("entry-point");
}

2. Android侧调用示例：

val channel = MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.example.entrypoint/call")
channel.invokeMethod("invokeEntryPoint", null)

注意事项 #

• 自定义入口函数必须是顶级函数（不能定义在类或其他函数内部）
• Flutter 2.10.3版本中，@pragma('vm:entry-point')的写法符合规范，无需调整

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