iOS项目如何仅在Debug模式下添加FLEX的.xcframework依赖

方式1：手动导入FLEX.xcframework #

• 把下载好的FLEX.xcframework拖入你的Xcode项目中，弹出导入选项时，确保不要勾选「Copy items if needed」下方的「Add to targets」对应你的App主目标选项
• 打开你的App主目标的「Build Settings」配置页，搜索 FRAMEWORK_SEARCH_PATHS（框架搜索路径），仅在Debug模式下添加FLEX.xcframework所在的本地路径，Release模式留空
• 继续在Build Settings里搜索 OTHER_LDFLAGS（其他链接器标记），仅在Debug模式下添加 -framework FLEX 配置，Release模式不要加
• 再搜索 EXCLUDED_SOURCE_FILE_NAMES（排除的源文件名），仅在Release模式下添加 FLEX.xcframework，确保Release打包时不会把框架打包进去

代码调用注意：所有调用FLEX的代码都要加上Debug模式的条件编译判断，避免Release下编译报错：

// Objective-C 写法
#ifdef DEBUG
#import <FLEX/FLEX.h>
#endif

// 启动示例
#ifdef DEBUG
[FLEXManager.sharedManager showExplorer];
#endif

// Swift 写法
#if DEBUG
import FLEX
#endif

// 启动示例
#if DEBUG
FLEXManager.shared.showExplorer()
#endif

方式2：通过CocoaPods引入（最简便） #

• 打开你的项目Podfile，把FLEX的依赖声明移到Debug专属的配置块里即可，写法如下：

pod 'FLEX', :configurations => ['Debug']

• 执行 pod install 重新安装依赖即可，CocoaPods会自动帮你处理所有编译配置，不需要手动改其他参数，代码调用同上加条件编译即可。

方式3：通过Swift Package Manager引入 #

• 打开Xcode的「Project > Package Dependencies」页，添加FLEX的SPM依赖
• 依赖添加完成后，进入主目标的「Build Phases > Link Binary With Libraries」，找到FLEX库，把右侧的Status从「Required」改为「Optional」
• 然后在「Build Settings > OTHER_LDFLAGS」里，仅Debug模式下添加 -weak_framework FLEX，Release模式不添加，代码调用同上加条件编译即可。

配置完成验证方法 #

• 切换到Release模式，编译项目，确认不会报FLEX相关的编译错误
• 打出Release包，查看包内容，确认里面不存在FLEX.framework相关的文件即可

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