在做一些ios项目开发的时候,我们的很多项目中可能用到了一些公用的模块,我们一直在这些项目中来回copy,paste,非常的不方便,有的时候这些模块有一些修改,我们在使用的时候都不知道要去哪个项目中copy。这个时候我们可以使用自定义的CocoaPods库来封装这些模块,这样我们在使用的时候只需要使用cocoPods去导入这个模块就可以了,这样既减少了我们的工作量,也能很好的去管理修改我们的模块。下面就来讲解怎么去创建一个自定义的CocoaPods库。
第一步:登录github(如果没有账号自己去创建一个)
第二步:我们在github上创建一个仓库(注:公有的私有的都可以,区别在于公有的能被所有人看到,私有的只能被指定的人看到)
如图1-1所示,勾选README,并且选择Objective-C ,license选择MIT License,点击创建即可
第三步:打开终端,cd到桌面(cd到你想要的路径下都可以),执行git clone '仓库地址',就会把我们刚才创建的仓库clone到本地
第四步:在刚才clone下来的主目录下创建一个新的文件夹,命名为Classes(名字可以自己定义),用来存放我们需要封装的一些代码文件或者资源文件,我们这里以一个.h文件为例
第五步:创建.podspec文件。再次打开终端,cd到刚才clone下来的文件夹的根目录下执行 'pod spec create TestRepository',就会在根目录下生成一共TestRepository.podspec文件。这个命名可以自己定义(注意:这个文件名就是我们之后通过cocoaPods导入的库名)
这个时候我们刚才的主文件夹的目录如下:
第六步:编辑.podspec文件,如图所示:
这是.podspec文件最基本的格式。
name:仓库名称,与.podspec文件名保持一致
version:仓库版本号
summary:仓库描述
homepage:仓库的主页地址
license:pod库许可证的类型
author:可以填写仓库创建者的一些相关信息
platform:支持的平台
deployment_target:支持的最低系统版本
source:固定格式,把仓库的地址复制进去就可以了
source_files:资源文件(我们这里只有一个.h文件可以写的比较简单。如果有复杂的目录结构和多个或者多种类型的资源文件可以参考官方文档:CocoaPods Guides - Podspec Syntax Reference)
第七步:将整个文件夹修改的内容提交到github上(git 语句不熟悉的可以自行百度)
第八步:创建tag ,在终端cd到刚才的根目录下,分别执行git语句
git tag 0.0.1(这里的0.0.1版本号需要与.podspec文件中写的版本号保持一致)
git push --tags
第九步:版本号提交成功以后就可以进行验证了cd到根目录
本地验证:pod lib lint --allow-warnings --sources='https://github.com/CocoaPods/Specs.git'
远程验证:pod spec lint --allow-warnings --sources='https://github.com/CocoaPods/Specs.git'
--allow-warnings:允许警告存在,如果在验证的时候因为警告而不成功,可以添加--allow-warnings来验证(注意:有些file not found的警告是因为podspec文件配置错误而造成的,需要修改podspec文件内容,并不能直接忽略)
--sources='https://github.com/CocoaPods/Specs.git' :指定下载源,如果我们自定义库引用了其他第三方的库,则需要再.podspec文件中添加依赖,验证的时候可能会报错,我们在验证的时候指定一下下载源就可以了(如果没有引用其他第三方库或者直接验证的时候不报错,就可以不添加这个)
验证成功如下图:
第十步:上传到CocoaPods中,因为刚才我们创建的是公有库,我们则需要创建或者登陆trunk号
终端执行:pod trunk me 检测是否登录,如果有则会显示trunk号的信息,如果没有则需要创建
终端执行:pod trunk register 邮箱名 用户名 --description='描述' 创建完毕之后可以提交了
终端执行:pod trunk push TestRepository.podspec --allow-warnings 成功如下图:
这个时候我们的自定义库就创建完毕了,本地更新pod repo update,然后就可以在项目中导入了
如果我们刚才创建的是私有库,提交方式与公有库不同
1.cd到根目录,终端执行 "pod repo add TestRepository 仓库地址 "这个TestRepository可以自己命名,这个只需要执行一次,以后升级版本库的时候不需要在执行这一步操作,当然,如果本地的被删除了则需要重新再执行一次(可在 /用户/电脑名/.cocoapods/repos 这个路径下查看刚才添加的文件夹)
2提交,终端执行 "pod repo push TestRepository TestRepository.podspec --allow-warnings"第一个TestRepository是上一步创建的文件夹名,第二个TestRepository是.podspec文件名
成功之后更新本地仓库pod repo update然后就可以在项目中使用了,需要注意的是,私有仓库在导入到项目的时候需要再Podfile文件中添加 "source '仓库地址'"