Capacitor.js 5.5.1项目启动屏不显示，加载时黑屏求助

• 检查Capacitor配置文件
  打开capacitor.config.ts（或.js），确认ios配置下的launchStoryboard字段指向正确的Storyboard文件名（默认是LaunchScreen，注意Xcode对文件名大小写敏感）。修改后运行npx cap sync ios同步项目。
  示例配置：

  export default defineConfig({
    ios: {
      launchStoryboard: "LaunchScreen",
      // 其他配置项
    }
  });
  

• 验证Xcode启动配置细节

  1. 选中项目根目录，进入Targets > 你的App Target > General标签页：
     • 确认Launch Screen File已选中正确的Storyboard
     • Main Interface留空或保持Capacitor默认的Main，不要设置为启动屏Storyboard
  2. 选中Storyboard文件，查看右侧File Inspector：
     • 勾选Target Membership对应的App Target
     • 确认Use as Launch Screen和ViewController的Is Initial View Controller已勾选

• 清理Xcode缓存与构建文件

  • 执行Product > Clean Build Folder（快捷键Cmd+Shift+K）清理构建文件
  • 通过Xcode > Settings > Locations > DerivedData打开文件夹，删除对应项目的DerivedData
  • 卸载模拟器/真机上的App后重新构建运行

• 排查WebView加载问题

  • 打开Xcode调试控制台，查看是否有前端资源加载错误（如路径错误、网络问题）
  • 可在AppDelegate.swift中添加日志，确认Capacitor初始化流程：

    import UIKit
    import Capacitor
    
    @UIApplicationMain
    class AppDelegate: UIResponder, UIApplicationDelegate {
    
        var window: UIWindow?
    
        func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
            print("Capacitor app starting...")
            let capacitorConfig = CAPBridgeConfiguration()
            CAPBridge.setup(with: capacitorConfig, window: window)
            print("Capacitor bridge setup completed")
            return true
        }
        // 其他默认方法
    }
    

  • 确认npx cap copy ios已将前端dist文件同步到Xcode项目的App/public目录

• 检查Storyboard内容
  打开LaunchScreen.storyboard，确保内部有可见视图（如图片、文字），空Storyboard可能导致系统 fallback 到黑屏

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