如何在Xcode中通过xconfig指定预编译xcframework版本并配置路径

1. 创建版本控制配置文件 #

在项目根目录新建FrameworkVersion.xcconfig文件，写入以下内容定义版本变量与框架路径：

// 定义FolderA的目标版本
FOLDERA_VERSION = 3.0
// 拼接完整框架路径
FOLDERA_FRAMEWORK_PATH = $(HOME)/preCompiled/FolderA/$(FOLDERA_VERSION)/FolderA.xcframework

2. 关联配置文件到Xcode项目 #

• 打开项目，切换到Project层级（非Target）
• 进入Info标签页，在Configurations区域，为Debug、Release等所有Build Configuration选择刚才创建的FrameworkVersion.xcconfig

3. 配置框架搜索路径 #

• 进入Target的Build Settings标签页
• 找到Framework Search Paths选项，添加路径：$(HOME)/preCompiled/FolderA/$(FOLDERA_VERSION)
• 勾选Recursive，确保Xcode能递归搜索到xcframework文件

4. 添加框架到项目 #

• 右键项目导航栏，选择Add Files to "你的项目名称"
• 导航到$(HOME)/preCompiled/FolderA/$(FOLDERA_VERSION)/，选中FolderA.xcframework后点击添加
• 在弹窗中勾选对应的Target，按需选择Copy items if needed（若无需将框架复制到项目目录可取消勾选，保持外部引用）

5. 切换框架版本 #

直接修改FrameworkVersion.xcconfig中的FOLDERA_VERSION值（比如改为2.0），重新构建项目即可切换到对应版本的xcframework

注意事项 #

• 若$(HOME)解析异常，可替换为绝对路径（如/Users/你的用户名/preCompiled）
• 多框架场景可在xcconfig中添加更多变量（如FOLDERB_VERSION），重复上述流程即可
• 构建报错时，优先检查Framework Search Paths路径是否正确，以及版本号对应的文件夹是否存在

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