CocoaPods安装FLEX Debugger后无法运行 模拟器不显示怎么办

按以下顺序逐一排查即可解决90%以上的同类问题：

• 确认项目打开方式正确：执行完pod install后必须完全退出Xcode，打开项目目录下的.xcworkspace文件启动项目，打开旧的.xcodeproj文件会导致依赖无法正常链接。
• 检查Podfile配置：确认FLEX依赖的配置块没有写错，标准引入写法参考如下，不要错误将FLEX配置为仅Release环境引入：

target '你的App实际Target名' do
  # 其余已有依赖
  pod 'FLEX', '~> 5.0', :configurations => ['Debug']
end

修改完Podfile记得重新执行pod install再编译。

• 确认已手动调用FLEX启动方法：FLEX不会自动弹出，必须主动调用显示接口，建议放在App启动生命周期中，用Debug宏包裹避免线上包带出：

// Objective-C 版本 放在 AppDelegate 的 application:didFinishLaunchingWithOptions: 中
#if DEBUG
[[FLEXManager sharedManager] showExplorer];
#endif

// Swift 版本 放在 AppDelegate 或 SceneDelegate 的启动回调中
#if DEBUG
FLEXManager.shared.showExplorer()
#endif

补充检查：到项目Build Settings中搜索macros，确认Debug配置下存在DEBUG=1的预处理宏定义，否则上述包裹的代码不会执行。

• 排查链接与缓存问题：如果编译阶段报FLEX相关类找不到、符号未定义的错误，先执行pod deintegrate移除所有CocoaPods依赖，再重新执行pod install清理重装；同时可以清空Xcode编译缓存（快捷键Shift+Command+K）、重置模拟器（模拟器菜单栏「Device - Erase All Content and Settings」）后再重新运行。
• 排查视图遮挡问题：如果代码执行无报错但看不到FLEX悬浮按钮，先临时关闭App内所有自定义全局悬浮窗、置顶视图，避免FLEX的按钮被其他视图层级遮挡。

相关参考截图：

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