如何为Flutter Windows应用配置Firebase集成及解决相关异常

一、Windows平台Firebase配置步骤 #

1. Firebase控制台添加Windows应用 #

• 打开Firebase项目控制台，进入「项目设置」，点击「添加应用」选择Windows图标
• 输入应用标识符（例如com.example.your_app，需与Windows项目配置一致），完成应用注册
• 下载google-services.json文件，放置到Flutter项目的windows/根目录下

2. 配置Windows项目CMake与代码 #

• 编辑windows/CMakeLists.txt：

  • 在# Flutter-related注释后添加Firebase依赖配置：

    # Firebase Core配置
    include(FetchContent)
    FetchContent_Declare(
      firebase_core
      GIT_REPOSITORY https://github.com/firebase/firebase-cpp-sdk.git
      GIT_TAG 11.0.0 # 建议使用与Flutter Firebase插件兼容的最新版本
    )
    FetchContent_MakeAvailable(firebase_core)
    

  • 在target_link_libraries节点中加入firebase_core：

    target_link_libraries(${BINARY_NAME} PRIVATE flutter flutter_wrapper_plugin firebase_core)
    

• 编辑windows/runner/main.cpp：

  • 添加Firebase头文件引用：

    #include "firebase/app.h"
    

  • 在FlutterWindow window初始化前添加Firebase初始化代码：

    // 初始化Firebase应用
    firebase::AppOptions options;
    auto app = firebase::App::Create(options);
    

3. 更新firebase_options.dart #

• 在文件中补充Windows平台的配置项：

  static const FirebaseOptions windows = FirebaseOptions(
    apiKey: "你的API_KEY",
    appId: "你的APP_ID",
    messagingSenderId: "你的SENDER_ID",
    projectId: "你的PROJECT_ID",
    storageBucket: "你的STORAGE_BUCKET",
  );
  

• 在main.dart的初始化代码中指定平台选项：

  await Firebase.initializeApp(
    options: DefaultFirebaseOptions.currentPlatform,
  );
  

二、fluttertoast MissingPluginException 解决办法 #

该异常是因为fluttertoast插件未实现Windows平台的通道方法，推荐以下两种解决方式：

方式1：替换为支持Windows的Toast插件 #

• 移除fluttertoast依赖：在pubspec.yaml中删除相关行，执行flutter pub get
• 添加支持多平台的Toast插件，例如desktop_toasts：

  dependencies:
    desktop_toasts: ^0.2.0
  

• 替换原有Toast调用代码，示例：

  import 'package:desktop_toasts/desktop_toasts.dart';
  
  void showToast(String message) async {
    final toast = DesktopToast();
    await toast.showToast(
      title: "提示",
      body: message,
      duration: const Duration(seconds: 3),
    );
  }
  

方式2：自定义Windows平台的通道实现（适合有C++开发基础的场景） #

• 在windows/runner/目录下创建插件逻辑文件，实现showToast的Windows平台代码（可调用Win32 API或第三方Toast库）
• 在main.cpp中注册方法通道：

  #include <flutter/method_channel.h>
  #include <flutter/plugin_registrar_windows.h>
  #include <flutter/standard_method_codec.h>
  
  void RegisterToastPlugin(flutter::PluginRegistrarWindows* registrar) {
    auto channel = std::make_unique<flutter::MethodChannel<flutter::EncodableValue>>(
      registrar->messenger(),
      "PonnamKarthik/fluttertoast",
      &flutter::StandardMethodCodec::GetInstance());
  
    channel->SetMethodCallHandler(
      [](const flutter::MethodCall<flutter::EncodableValue>& call,
         std::unique_ptr<flutter::MethodResult<flutter::EncodableValue>> result) {
        if (call.method_name() == "showToast") {
          // 此处编写Windows Toast显示逻辑
          result->Success();
        } else {
          result->NotImplemented();
        }
      });
  }
  

• 在WinMain函数中注册该插件：

  auto registrar = flutter::PluginRegistrarManager::GetInstance()->GetRegistrarForPlugin("ToastPlugin");
  RegisterToastPlugin(registrar);
  

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