如何在不拆分仓库的情况下私有获取嵌套目录中的Pod框架？

问题背景 #

我们有一个与其他框架共享仓库的开发中框架，仓库结构如下：

- Repo root:
  - Framework A
  - Framework B
  - OurFramework:
    - OurFramework:
      - OurFramework.podspec
      - 代码及其他文件

需要将该框架接入带有CI/CD流程的项目，但当前CI/CD配置不允许使用Submodule和Development pod。我们尝试通过指定Git仓库的方式引入，Podfile写法如下：

pod 'FrameworkName', :git => 'git@github.com:company/rootRepoName.git', :branch => 'OurFramework-framework'

执行pod install时提示Unable to find a specification for 'OurFramework'。也试过用:path =>或:podspec =>指向.podspec文件目录，但没有效果。

可行解决方案 #

1. 远程引用时明确指定podspec的相对路径 #

当Podspec不在仓库根目录时，必须通过:podspec参数指定它在远程仓库中的相对路径（而非本地路径）。正确的Podfile写法如下：

pod 'OurFramework', :git => 'git@github.com:company/rootRepoName.git', :branch => 'OurFramework-framework', :podspec => 'OurFramework/OurFramework/OurFramework.podspec'

这样CocoaPods会拉取对应分支的代码，并定位到指定路径下的podspec进行解析。

2. 校验podspec的配置正确性 #

• 确认Podfile中引用的名称（如OurFramework）与podspec文件中s.name字段完全一致，名称不匹配是常见的报错原因。
• 在本地仓库目录执行以下命令，验证podspec是否合法：

pod lib lint OurFramework/OurFramework/OurFramework.podspec

若存在语法错误或配置问题，先修复后再重新尝试。

3. 确保CI/CD环境具备仓库访问权限 #

CI/CD runner需要能够正常拉取私有Git仓库代码：

• 如果使用SSH协议（如示例中的git@github.com），确认CI环境已配置正确的SSH密钥，拥有仓库的读取权限。
• 如果使用HTTP协议，需配置访问令牌（Token）以通过身份验证。

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