Flutter如何在FCM onBackgroundMessage回调中唤起APP显示VoIP来电界面

核心原因说明 #

你在后台Isolate中直接调用runApp无效的根本原因是：Android侧的FCM后台Isolate是独立于主App进程上下文的隔离线程，没有绑定Android的Activity栈，Flutter的UI渲染必须依附于已存在的Activity窗口上下文，所以无法直接在后台Isolate中启动UI界面。

推荐跨端可行方案 #

这个方案可以同时覆盖Android、iOS两端，不用重写你已经开发好的Flutter来电界面：

Android端实现逻辑 #

• 首先提前在应用首次启动时引导用户授予两项必要权限：
  • 悬浮窗权限SYSTEM_ALERT_WINDOW（Android 6.0及以上需要）
  • 后台弹出界面权限（部分国产ROM如小米、华为需要单独申请）
• 原生层重写FirebaseMessagingService的onMessageReceived方法，判断消息是来电类型后，直接启动承载Flutter的主Activity，同时携带来电参数标记：

class CustomFirebaseMessagingService : FirebaseMessagingService() {
    override fun onMessageReceived(remoteMessage: RemoteMessage) {
        super.onMessageReceived(remoteMessage)
        val msgData = remoteMessage.data
        if (msgData["type"] == "INCOMING_CALL") {
            if (Settings.canDrawOverlays(this)) {
                val intent = Intent(this, MainActivity::class.java).apply {
                    addFlags(Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_SINGLE_TOP)
                    putExtra("call_data", msgData.toString())
                }
                startActivity(intent)
            } else {
                // 无权限时降级弹通知，引导用户点击唤起
                showIncomingCallNotification(msgData)
            }
        }
    }
}

• 在AndroidManifest.xml中配置你自定义的MessagingService，覆盖默认的Firebase消息服务。

iOS端实现逻辑 #

• iOS端不要用普通FCM通知承载VoIP来电消息，必须走苹果官方的PushKit通道推送VoIP消息，这是苹果允许的后台自动唤醒App的唯一合规方式，不会被拒审。
• 在iOS原生层监听PushKit的来电回调，收到回调后直接唤起App到前台，同时通过Method Channel通知Flutter层跳转到来电界面即可，iOS不存在Android的Isolate上下文限制问题。

Flutter层联动逻辑 #

• 在main.dart初始化时，读取原生层传递的启动参数，如果携带来电标记，直接将初始路由设置为来电界面：

Future<void> _firebaseMessagingBackgroundHandler(RemoteMessage message) async {
  await Firebase.initializeApp();
  // 后台Isolate不需要处理UI逻辑，交给原生层唤起App即可
  if(message.data["type"] == "INCOMING_CALL") {
    // 可选：如果应用在前台运行，通过Isolate Port通知主Isolate直接弹界面
  }
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);

  // 读取启动参数判断是否需要跳转来电界面
  String initialRoute = "/home";
  if(Platform.isAndroid) {
    const callChannel = MethodChannel("com.yourApp/call");
    final callData = await callChannel.invokeMethod("getInitCallData");
    if(callData != null) {
      initialRoute = "/incoming_call";
    }
  }
  runApp(MyApp(initialRoute: initialRoute));
}

之前方案的局限解决方式 #

• 你调研的原生层方案仅支持Android的问题：搭配iOS端PushKit的处理逻辑即可实现跨端适配，原生层只负责唤起App窗口，所有来电界面逻辑还是保留在Flutter层，不需要双端重复开发。
• 你调研的flutter_local_notifications需要用户点击的问题：只要提前申请到悬浮窗权限，原生层可以直接启动Activity唤起App，不需要用户主动点击通知，只有当用户拒绝权限时才降级到通知点击跳转的方案。

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