CocoaPods安装时如何筛选源文件？以AdColony为例解析

这是个很典型的CocoaPods依赖处理问题，刚好涉及它的核心文件筛选逻辑，我来一步步给你拆解：

这个筛选是在克隆完仓库之后，CocoaPods将文件复制到Pods目录的阶段发生的：

1. 首先pod install会执行你看到的git克隆命令，把仓库完整拉取到临时目录；
2. 接着CocoaPods会读取该pod的podspec文件，解析其中的文件配置规则；
3. 然后根据规则从临时目录中复制指定的文件到项目的Pods目录；
4. 最后临时目录会被自动清理，所以你看不到那些被过滤掉的文件。

完全由该pod的podspec文件中的配置字段决定，核心字段包括：

• vendored_frameworks：指定要保留的预编译框架（比如AdColony的podspec里就只写了这个，所以只有AdColony.framework被保留）；
• source_files：如果是源码类pod，指定需要编译的源代码文件路径；
• resources：指定需要拷贝到项目包中的资源文件（如图片、xib、plist等）；
• exclude_files：明确指定要排除的文件/目录；
• preserve_paths：如果你需要保留某些文件但不参与编译/资源拷贝（比如README、CHANGELOG），可以用这个字段指定。

AdColony的podspec里没有配置preserve_paths或其他包含SampleApps、CHANGELOG的字段，所以这些文件会被CocoaPods视为“非必要”，不会复制到Pods目录中。

分两种场景来处理：

如果你是该pod的维护者 #

直接修改podspec文件来调整规则：
比如要保留CHANGELOG.md和SampleApps目录，可以在podspec里添加：

preserve_paths = ['CHANGELOG.md', 'SampleApps']

如果需要执行自定义的文件处理逻辑（比如压缩、拷贝特定文件），还可以用prepare_command字段写shell脚本：

prepare_command = 'cp SampleApps/Example.swift ./CustomDir'

如果你只是集成该pod的开发者 #

有几种方式可以调整：

1. 使用Podfile的post_install钩子：在安装完成后手动拷贝需要的文件，比如：

post_install do |installer|
  # 从临时克隆目录（需自行确认路径，或提前手动克隆仓库）拷贝文件到指定位置
  system("cp /path/to/cloned-repo/SampleApps ./Pods/AdColony/")
end

2. fork原仓库并修改podspec：把原仓库fork到自己的账号，修改podspec的文件配置，然后在Podfile里指向你的fork版本：

pod 'AdColony', :git => 'https://github.com/your-username/AdColony-iOS-SDK-3.git', :tag => 'v3.2.1-custom'

3. 手动下载文件：直接从GitHub仓库下载需要的文件，手动添加到项目中，绕开CocoaPods的筛选。

CocoaPods官方有详细的文档覆盖这些内容：

• Podspec的所有字段说明（包括文件相关的vendored_frameworks、preserve_paths等）在Podspec Reference部分；
• Podfile的钩子（比如post_install）在Podfile Guide部分；
• 整个依赖安装流程的细节也在官方文档的Getting Started和Advanced Guides中有说明。

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