KivyMD项目Xcode中Launch Screen黑屏及Foundation dlopen报错求助

问题详情 #

• 现有KivyMD应用，因Xcode不再支持旧启动图方案，改用launchscreen.storyboard并放置在根目录
• 启动图闪过后黑屏几秒才进入首页，模拟器和真机均出现此问题，应用本身运行正常
• 启动过程中出现Foundation框架的dlopen错误，日志如下：

Got dlopen error on Foundation: dlopen(/System/Library/Frameworks/Foundation.framework/Versions/Current/Foundation, 0x0001): tried: '/System/Library/Frameworks/Foundation.framework/Versions/Current/Foundation' (errno=2), '/private/preboot/Cryptexes/OS/System/Library/Frameworks/Foundation.framework/Versions/Current/Foundation' (errno=2), '/System/Library/Frameworks/Foundation.framework/Versions/Current/Foundation' (errno=2, not in dyld cache)
Got fallback dlopen error on Foundation: dlopen(/Groups/System/Library/Frameworks/Foundation.framework/Versions/Current/Foundation, 0x0001): tried: '/Groups/System/Library/Frameworks/Foundation.framework/Versions/Current/Foundation' (errno=2), '/private/preboot/Cryptexes/OS/Groups/System/Library/Frameworks/Foundation.framework/Versions/Current/Foundation' (errno=2), '/Groups/System/Library/Frameworks/Foundation.framework/Versions/Current/Foundation' (errno=2), '/System/Library/Frameworks/Foundation.framework/Versions/Current/Foundation' (errno=2, not in dyld cache)

解决步骤 #

1. 校验launchscreen.storyboard配置 #

• 打开Xcode项目，选中根节点切换到General标签，在App Icons and Launch Images区域，确认Launch Screen File已选择你的launchscreen.storyboard
• 检查storyboard内是否引用了缺失的图片或资源，这类问题会导致启动加载阻塞

2. 修复Foundation路径错误 #

这个错误是打包工具生成的路径异常导致的，按以下操作修正：

• 打开Xcode项目的main.m或AppDelegate.m文件，排查是否存在硬编码的Foundation框架路径
• 若用buildozer打包，在buildozer.spec中添加配置：

  ios.launch_screen_storyboard = launchscreen.storyboard
  ios.framework_search_paths = $(SDKROOT)/System/Library/Frameworks
  

• 清理Xcode缓存：关闭Xcode后删除~/Library/Developer/Xcode/DerivedData下的项目缓存，再执行xcodebuild clean命令

3. 优化Kivy启动流程缩短黑屏 #

• 在应用入口文件中，用线程延迟加载非必要资源，优先完成UI初始化：

  from kivy.app import App
  from kivy.uix.boxlayout import BoxLayout
  import threading
  
  class MainUI(BoxLayout):
      def __init__(self, **kwargs):
          super().__init__(**kwargs)
          # 线程加载耗时资源
          threading.Thread(target=self.load_heavy_stuff).start()
  
      def load_heavy_stuff(self):
          # 这里放加载图片、数据等耗时操作
          pass
  
  class MyApp(App):
      def build(self):
          return MainUI()
  
  if __name__ == '__main__':
      MyApp().run()
  

4. 确认系统框架依赖 #

• 在Xcode项目的Build Phases → Link Binary With Libraries中，检查Foundation.framework是否已添加，缺失则点击+添加
• 查看Build Settings → Framework Search Paths，确保包含$(SDKROOT)/System/Library/Frameworks路径

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