组件pod私库管理和踩坑记录

私有库搭建流程:
一 准备工作:
1 查看本地是否有私有库索引文件 pod repo
2 建立存储podsepc的地方(习惯上一般把该podspec和源码库放在一起，即是该文件同级目录是Pod文件夹)，如github或者gitlab
3 添加私有库的本地索引，pod repo add 本地索引库名称 远程索引库地址
4 通过pod repo查看是否添加成功

二 私有库创建(即是存放源码的地方)
1 创建远程仓库
2 把远程库拉到本地 git clone
3 创建测试工程(随便一个本地别的目录，在源码库本目录还未试验)，pod init 生成podfile,pod install生成workspace文件
4 创建podspec文件: pod spec create 库名。在podspec同级目录创建Pod/Classes文件夹，功能模块就放在该classes文件夹下
5 podspec编写：
必写字段：
version 必须有tag对应
License
platform最好指定，否则在某个未测试兼容的平台可能报错
source
source_files:这里要注意补上Pod/前缀
framework:源码有用到的系统framework要导入

6 提交Podspec和源码，并且打tag
git add --all
git commit -m "update podspec"
git push origin master
git tag 0.0.1
git push --tags

7 检测pod库是否可用
Pod lib lint

8 测试本地库是否可用
pod ‘库名’，:path =>’本地库绝对路径’
Pod repo update
pod install
看源码文件是否能拉下来，看编译是否通过

9 提交本地库,向Spec Repo提交podspec
pod repo push BYPrivateComponent BYPrivateComponent.podspec --verbose --use-libraries --allow-warnings
10 测试是否提交成功pod search 库名
11 在测试工程导入，测试是否可用 pod 'BYComponents', :git => 'https://xxx.git'或者直接pod ‘库名’

12 只要更新了pod文件夹下内容或者更改了podspec文件都需要执行pod update

在随便一个测试工程引入该库，例如: pod 'BYComponents', :git => 'https://github.com/zhoubingyu/BYComponents.git'
Pod install 如果报错就pod update
重新打开workspace工程文件

问题和解决办法
1 如遇到The source_files pattern did not match any file
1.1 检查是否打tag，并且源码文件推送到远程仓库
1.2 检查本地目录/Users/Dana/.cocoapods/repos/，是否是最新的podspec文件，此处的Pod目录下的文件是否正确。如不正确，pod repo update /Users/Dana/.cocoapods/repos/BYComponents

更新维护podspec
1 先将源文件添加到Pod/Classes中
2 编辑podspec
3 在测试项目里pod update
4 把代码push到远端并打tag
5 再次使用pod lib lint验证编辑好的podsepc文件
6 提交本地库 pod repo push PodTestLibrary PodTestLibrary.podspec
7 到~/.cocoapods/repos/PrivateRepo目录下查看
8 pod search测试

组件化踩坑记录
1 subspec里面的source文件夹路径如果某级目录没文件，会报错。因为git不存储空文件夹
2 每次有改动，要验证pod lib lint YXComponents.podspec，要提交源码到远程仓库，打tag，对应修改podspec里面的版本号，然后推送私有库索引到远程pod repo push YXComponents
3 subspec里面指定的源文件的位置，不能放在总组件目录下。否则报错，该目录是放自动生成的版本信息的。
4 私库有更新升级流程:
4.1 提交更新的修改
4.2 打tag
4.3 升级Podspec里面的版本号
4.4 pod lint repo xxx
4.5 pod push repo xxx
4.6 pod install
4.7 pod repo push BYPrivateComponent BYPrivateComponent.podspec --verbose --use-libraries --allow-warnings
4.8 遇到target has transitive dependencies that include statically linked binaries
解决办法: 两步:1 在podspec加上 s.static_framework = true 2 push私有库时加上--use-libraries
4.9 划分子目录需要每个子目录能单独编译通过，并且所有的子目录的父亲的source_files不能包含子目录的文件，否则文件夹被创建，但是文件还在父目录下
5.0
允许使用静态库，允许警告，可查看详细信息。推送私库到仓库
pod repo push YXComponents YXComponents.podspec --verbose --use-libraries --allow-warnings

5.1 如果指定了spec文件的public_header_files，则所有要暴露出来的头文件都要包含在里面。不包含的头文件将无法引用
5.2 如果依赖了类似libresolv.tbd这类文件，则要添加下面依赖，注意去掉前缀lib和后缀.tbd
s.libraries = ‘resolv’
5.3 如果引入有.c文件的pod库的.h文件，报错Undefined symbols for architecture i386
方法一:(已验证)在repo push 后面加--skip-import-validation
方法二:s.pod_target_xcconfig = { 'VALID_ARCHS[sdk=iphonesimulator*]' => 'x86_64' }

5.4 指定私库版本号
pod 'YXComponents','0.5.9', :subspecs => ['Base','JSBridgesBaseDefine','YXBaseDefine']
5.5 Unexpected duplicate task 错误
看podspect里面的依赖路径是否有重复包含某个文件，或者匹配集太大，刚好都包含到同一个文件了。关键看source_files和resource的匹配模式