前言
公司项目开始使用 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]);
网友评论