如何解决Xcode运行Flutter App时iPhone模拟器白屏问题

以下是针对你遇到的Flutter App部署后白屏且FBLPromises.framework加载失败问题的可行解决方案：

1. 彻底清理缓存与依赖 #

• 执行Flutter项目清理：

  flutter clean
  

• 进入iOS目录，清理Pods及相关缓存文件：

  cd ios
  pod deintegrate
  pod clean
  rm -rf Podfile.lock .symlinks Flutter/Flutter.framework Flutter/Flutter.podspec
  

• 重新拉取项目依赖并安装Pods：

  flutter pub get
  pod install
  

2. 修复FBLPromises.framework引用 #

• 打开Xcode，进入项目的Build Phases > Link Binary With Libraries，若已存在FBLPromises.framework则先移除，再重新添加（可从ios/Pods/FBLPromises目录下找到该框架）。
• 检查Build Settings中的Framework Search Paths，添加路径$(PROJECT_DIR)/Pods/FBLPromises并设置为recursive。

3. 解决Dart路径警告 #

• 运行flutter doctor查看具体的路径问题提示，将Dart的bin目录添加到系统环境变量中（以zsh为例）：

  echo 'export PATH="$PATH:/[你的Flutter安装路径]/flutter/bin/dart"' >> ~/.zshrc
  source ~/.zshrc
  

• 再次运行flutter doctor确认警告消失后，重新构建项目。

4. 适配Xcode与macOS环境 #

• 确保Xcode的Command Line Tools版本与Xcode版本匹配：打开Xcode → Settings → Locations，选择版本为14.2的Command Line Tools。
• 针对Intel芯片的MacBook Air 2019，在Xcode中设置项目架构为Standard Architectures (x86_64)：进入项目Build Settings → Architectures，修改对应选项后重新构建。

5. 排查项目入口逻辑 #

• 检查lib/main.dart中的main函数是否正确调用runApp，确保没有逻辑阻塞或注释错误：

  void main() {
    runApp(const MyApp());
  }
  

• 尝试创建全新的Flutter测试项目（flutter create test_app）并部署到模拟器，验证是否是当前项目本身的问题。

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