制作 cocoapods 私有库

前言

公司项目开始使用 cocoapods 管理项目代码，各位同事对原本庞大的项目进行了拆分，封装成一个个小的库，自己也要开始学习一下如何制作私有库，以免跟不上步伐。

创建库工程

按往常一样，创建 Single View App 工程，然后在根目录创建一个文件单独用于存放我们的库文件。
xcode为我们创建的 Appdelegate 所在的文件夹,我们只在里面写demo代码，而不是在里面写库的代码。
这样方便我们后续在podspec 文件中指定源代码目录

书写 podspec 文件

1、创建

pod spec create YUNLibrary

生成YUNLibrary.podspec文件，默认会有一个模版，我们可以在模版的基础上改。

2、书写

需要填写这个库的重要信息，我的库非常简单，也不依赖什么东西，所以文件内容很少，是一个基础版
官方的语法参考书如下：https://guides.cocoapods.org/syntax/podspec.html

Pod::Spec.new do |spec|
  spec.name         = "YUNLibrary"
  spec.version      = "1.0.0"
  spec.summary      = " YUNLibrary 用于学习如何创建pod库"
  spec.homepage     = "https://xxxxxx.code.oa.com/xxxxxx/YUNT"
  spec.license         = "MIT"
  spec.platform        = :ios, "8.0"
  spec.ios.deployment_target = "8.0"
  spec.author             = { "zhiyunyu" => "zhiyunyu@tencent.com" }
  spec.source       = { :git => "http://xxxxxx.code.oa.com/xxxxxx/YUNT.git", :tag => "#{spec.version}" }
  spec.source_files  = "YUNLibrarySources/**/*.{h,m}"
  spec.public_header_files = "YUNLibrarySources/**/*.h"
  spec.requires_arc = true
end

3、注意事项

tag

podspec文件中的tag指的就是版本控制的tag.
创建tag命令如下

git tag 1.0.0
git push origin 1.0.0 // 必须这样才能把 tag 推送到远程，否则git默认不会推送的

校验podspec 正确性

执行以下命令，可以反馈出这个文件的问题，根据指引进行修改即可。

pod spec lint YUNLibrary.podspec

要指定 spec.platform = :ios, "8.0"，否则可能会报 tvOS相关的bug
要修改成 spec.license = "MIT"，去掉默认的example 单词即可，然后自己创建一个LICENSE文件，去网上拷贝一下改成自己的名字即可

指定库的源文件和要暴露的头文件

spec.source_files  = "YUNLibrarySources/**/*.{h,m}"
spec.public_header_files = "YUNLibrarySources/**/*.h"

*.{h,m} 代表.h或者 .m 文件
** 代表匹配文件夹下所有目录

在另一个项目中引用自己的库

在另一个项目的podfile中增加一行：

pod 'YUNLibrary',           :git => 'http://git.code.xxx.com/xxxxxxx/YUNLibrary.git', :tag => '1.0.0'

然后执行

pod install

之后我们就可以在项目中使用YUNLibrary库提供的类了。
这是安装成功后看到暴露出来的头文件

屏幕快照 2019-07-11 下午8.48.13.png

然后我们在项目中导入头文件就可以使用这个库了

#import <YUNLibrary/YUNCustomDateFormatter.h>

YUNCustomDateFormatter *t = [[YUNCustomDateFormatter alloc] init];
NSLog(@"zhiyun name = %@", [t getMyName]);

最后编辑于：2019.07.11 21:04:09