作为一名懒人，写博客的事情基本不做，但是最近做pod私有库的时候发现之前的东西忘掉差不多了，于是即兴写一篇，记录下来，以便下次再次回忆。
pod创建私有库主要有几个步骤
- 确定pod版本。新版本1.8.4版本(没试过1.9.0beta)，由于CDN的问题，做私有库容易索引失败，setup master的时候容易失败。建议使用1.7.x版本。
- 使用pod creat命令创建项目工程。
- 修改相关库文件。
- 修改.podspec文件包括：三方依赖、分组、版本号等。
- 创建两个远程git仓库，并初始化。一个spec用来存储.podspec文件，一个lib库用来存储代码。
- 关联git库，上传本地文件到私有库。
- git库打tag。
- 使用pod lib lint 和 pod spec lint 验证.podspec合法性。
- 上传.podspec 文件到spec库。
- 下载测试使用。
正式开始
第一步 创建pod私有库工程
- 找到合适的目录使用 pod lib create YDPodDemoLib 其中YDPodDemoLib是我自己创建的私有库名称。
这一步会有一些自动提示，
➜ PodTest pod lib create YDPodDemoLib
Cloning `https://github.com/CocoaPods/pod-template.git` into `YDPodDemoLib`.
Configuring YDPodDemoLib template.
------------------------------
To get you started we need to ask a few questions, this should only take a minute.
If this is your first time we recommend running through with the guide:
- https://guides.cocoapods.org/making/using-pod-lib-create.html
( hold cmd and double click links to open in a browser. )
What platform do you want to use?? [ iOS / macOS ]
//iOS还是mac工程
> iOS
What language do you want to use?? [ Swift / ObjC ]
//使用哪种语言
> ObjC
Would you like to include a demo application with your library? [ Yes / No ]
//是否包含demo工程
> Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
//使用那种frameworks
> None
Would you like to do view based testing? [ Yes / No ]
//是否使用试图测试
> Yes
What is your class prefix?
//项目前缀
> YD
Running pod install on your new library.
Analyzing dependencies
Fetching podspec for `YDPodDemoLib` from `../`
Downloading dependencies
Installing FBSnapshotTestCase (2.1.4)
Installing YDPodDemoLib (0.1.0)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `YDPodDemoLib.xcworkspace` for this project from now on.
Sending stats
Pod installation complete! There are 2 dependencies from the Podfile and 2 total pods installed.
Ace! you're ready to go!
We will start you off by opening your project in Xcode
open 'YDPodDemoLib/Example/YDPodDemoLib.xcworkspace'
To learn more about the template see `https://github.com/CocoaPods/pod-template.git`.
To learn more about creating a new pod, see `https://guides.cocoapods.org/making/making-a-cocoapod`.
-
替换文件
进入到YDPodDemoLib/YDPodDemoLib/Classes文件夹下，删除ReplaceMe.m文件。并且将你自己编写的文件拷贝到这个文件夹下，source文件放到Assets下。
image.png
-
cd到Example下可以使用pod install，可以在pod目录下看到你添加的文件。如下图：
image.png
第二步 修改podspec文件
打开demo工程，在最上面能看到一个.podspec文件
-
修改source文件
这里需要修改的文件如下图
image.png
第三步 关联git仓库
- 创建仓库。
这里需要创建两个仓库：spec、lib。比如我这里创建的是podDemoSpec、YDPodDemoLib。 - 关联lib仓库，使用如下一系列命令
$ git remote add origin https://github.com/yidezhang/podDemo/YDPodDemoLib.git
$ git add .
$ git commit -m "Initial commit"
$ git push -u origin master
//tag 值要和.podspec中的version一致
$ git tag 0.1.0
//推送tag到服务器上
$ git push --tags
第四步 验证.podspec文件合法性
- 验证.podspec
在.podspec文件被设置好后，需要使用pod验证其合法性。使用如下两条命令：
pod lib lint --allow-warnings --verbose
pod spec lint xxxx.podspec --verbose --allow-warnings
如果运行命令的时候报错，自行查阅相关文档。各个报错都不一样，一般都是.podspec写的不合法。
第五步 将创建的spec添加到pod里面
其实通过上面的操作，直接使用source修改，通过pod已经可以pod下载私有库了，但是这只是简单的拷贝。要使得私有库更加隐蔽和便于管理，需要在pod repo里面添加我们自己定义的spec文件(也就是.podspec)管理。所以远程需要创建两个git仓库，一个用来管理spec版本，一个存储真正的lib文件。
-
进入~/.cocoapods/repos里面，可以看到本地的一些spec索引文件，其中master是pod远程库的搜索目录，我们平时使用pod setup命令的时候就是下载这个master库文件。现在我们要做的是将我们的私有库添加到索引里。
-
关联远程spec库。
这一步其实就是将远程的spec库关联到本地，并且给他起个别名。命令如下:
pod repo add YDPodDemoLibSpec https://github.com/yidezhang/podDemo/podDemoSpec.git
这个时候在~/.cocoapods/repos就会看到上面会有刚刚执行的YDPodDemoLibSpec 文件夹，如下图:
image.png
3.修改版本号
我们每次修改私有库文件，当需要发布版本的时候就需要创建新的tag，上传新的spec文件。命令如下:
//这里需要cd到 YDPodDemoLib主目录下，而不是在demo下面。
pod repo push YDPodDemoLibSpec YDPodDemoLib.podspec --allow-warnings
最后验证
要使用私有库，需要在podfile里面添加source
source 'https://github.com/yidezhang/podDemo/podDemoSpec.git'
platform :ios, '9.0'
target 'TestLayer' do
use_frameworks!
pod 'YDPodDemoLib'
end
验证即可。
后记
需要注意的点：
- 制作私有库其实比较简单，只要理清楚spec文件和lib库的归属就好办了。
- 但是由于pod版本问题，私有库依赖三方库的时候容易出错，这里要注意引入三方库版本。
- pod的分组其实就是嵌套编写，分组的时候注意每个小组三方库的引入版本是否冲突。
简单画了两张图，仅供参考
pod私有库上传的流程大概如图:
image.png
pod私有库使用大概如下:
image.png
如果遇到问题include of non-modular header inside framework module 报错就在podspec文件里加入下面这句话
s.user_target_xcconfig = { 'CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES' => 'YES' }
网友评论