You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter macOS桌面端无法创建FlutterView问题求助

Flutter macOS端运行空白窗口并报错问题

我在MacOS 13.1系统上使用Flutter 3.7稳定版,通过flutter create创建的Hello World应用在iPhone和Web(Chrome)端运行正常,但执行flutter run macos时弹出空白窗口且报错(错误截图:Flutter macOS运行错误截图)。以下是flutter doctor -v输出:

~ % flutter doctor -v
[✓] Flutter (Channel stable, 3.7.0, on macOS 13.1 22C65 darwin-x64, locale
    pl-PL)
    • Flutter version 3.7.0 on channel stable at
      /usr/local/Caskroom/flutter/3.7.0/flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision b06b8b2710 (7 days ago), 2023-01-23 16:55:55 -0800
    • Engine revision b24591ed32
    • Dart version 2.19.0
    • DevTools version 2.20.1

[✗] Android toolchain - develop for Android devices
    ✗ Unable to locate Android SDK.
      Install Android Studio from:
      https://developer.android.com/studio/index.html
      On first launch it will assist you in installing the Android SDK
      components.
      (or visit https://flutter.dev/docs/get-started/install/macos#android-setup
      for detailed instructions).
      If the Android SDK has been installed to a custom location, please use
      `flutter config --android-sdk` to update to that location.


[✓] Xcode - develop for iOS and macOS (Xcode 14.2)
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Build 14C18
    • CocoaPods version 1.11.3

[✓] Chrome - develop for the web
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[!] Android Studio (not installed)
    • Android Studio not found; download from
      https://developer.android.com/studio/index.html
      (or visit https://flutter.dev/docs/get-started/install/macos#android-setup
      for detailed instructions).

[✓] Connected device (2 available)
    • macOS (desktop) • macos  • darwin-x64     • macOS 13.1 22C65 darwin-x64
    • Chrome (web)    • chrome • web-javascript • Google Chrome 109.0.5414.119

[✓] HTTP Host Availability
    • All required HTTP hosts are available

! Doctor found issues in 2 categories.

问题排查与解决步骤

核心问题大概率是macOS端应用的签名或配置文件异常,以下是具体解决方法:

  • 重新生成macOS平台配置文件
    执行命令清理缓存并重新初始化macOS平台:

    flutter clean
    flutter create --platforms macos .
    
  • 配置Xcode签名

    1. 打开项目下的macos/Runner.xcworkspace
    2. 选中Runner target,进入Signing & Capabilities标签
    3. 勾选Automatically manage signing,选择你的Apple开发者账号(测试可用Personal Team)
    4. 确保Bundle Identifier为唯一值(可添加自定义后缀)
  • 清理构建缓存并重新运行

    1. 在Xcode中执行Product > Clean Build Folder(快捷键Cmd+Shift+K)
    2. 终端执行flutter run macos重新启动应用
  • 确认macOS桌面平台已启用
    执行命令确保平台支持:

    flutter config --enable-macos-desktop
    

补充说明

当前flutter doctor中的Android相关问题不影响macOS端运行,可忽略。重点关注macOS平台的签名和配置完整性。

内容的提问来源于stack exchange,提问作者user1209216

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.03 03:15:41