基于Carthage搭建自研框架嵌套依赖遇阻求助

我之前维护多仓库iOS组件时也踩过类似的坑，结合你描述的Util（基础工具扩展）、UI（自定义控件+UI类扩展）、App的独立仓库结构，大概率是以下几个常见问题导致的，给你逐一梳理排查方向和解决办法：

1. 先检查Cartfile的正确性 #

首先确认UI仓库根目录下的Cartfile有没有正确配置Util的依赖：

• 公开仓库的写法：github "你的GitHub用户名/Util"，如果需要指定版本范围，比如兼容1.x系列，加上~> 1.0；
• 私有仓库的话，要确保本地已经配置好SSH密钥（避免Carthage拉取时权限失败），写法和公开仓库一致，额外可以加上--use-ssh参数执行拉取命令。

2. 确认Util框架的Build配置符合Carthage要求 #

Carthage对依赖框架有两个硬性要求，很多人容易忽略：

• 必须是动态框架：打开Util的Xcode项目，选中Target → Build Settings → 找到Mach-O Type，确认设置为Dynamic Library；
• Scheme必须共享：在Xcode顶部菜单栏选择Product → Scheme → Manage Schemes，找到Util的Scheme，勾选右侧的Shared选项，然后把修改后的.xcscheme文件提交到GitHub仓库（Carthage需要通过共享Scheme来自动构建框架）。

3. UI框架中正确引用Carthage构建的Util #

当Carthage成功拉取并构建Util后，UI框架的引用方式要注意：

• 不要直接拖Util的源码到UI项目里，而是添加Carthage生成的框架：把Carthage/Build/iOS/Util.framework拖到UI项目的Linked Frameworks and Libraries中；
• 必须添加Run Script阶段：在UI项目的Build Phases里新增一个Run Script，脚本内容为：

  /usr/local/bin/carthage copy-frameworks
  

  然后在Input Files中添加：

  $(SRCROOT)/Carthage/Build/iOS/Util.framework
  

  这一步是为了避免最终打包App时出现重复符号的问题，是Carthage依赖动态框架的标准操作。

4. 清理缓存解决版本冲突或构建残留 #

如果之前尝试过构建但失败，Carthage的缓存可能会导致奇怪的问题，可以执行以下命令清理后重新构建：

# 删除Carthage全局缓存
rm -rf ~/Library/Caches/org.carthage.CarthageKit
# 删除UI仓库本地的Carthage目录
rm -rf Carthage/
# 重新拉取并构建依赖
carthage update --platform iOS

另外还要确认Util的GitHub仓库中存在符合你版本约束的tag（比如你写了~> 1.0，仓库里必须有1.0.0及以上的tag）。

如果还是有问题，可以把具体的错误日志贴出来，这样能更精准定位问题～

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