最新iOS组件化之pod私有库
远程索引库:
存在一个公共的远程索引库,包含所有三方框架的.podspec文件,在.podspecs文件中包括了框架名,框架源码地址,用户名,描述等信息。
本地索引库:
在安装pod,执行pod setup的时候,会将公共的远程索引库copy一份到本地,也即是公共的本地索引库。(可以查看此目录:/Users/myName/.cocoapods/repos)
检索文件: 公共的本地索引库会另外生成一个检索文件,以键值对的形式,方便以后查找。( 可以查看此目录:/Users/xx/Library/Caches/CocoaPods)
导入三方库:
执行pod install的时候,先去检索文件中查找,找到之后,在公共的本地索引库拿到框架源码地址进行导入。
(1) 在gitlab上创建一个私有的仓库HLComponentManager,克隆地址是:http://gitlab.xxxxxx/hlbasecoderepo/hlcomponentmanager.git,HLComponentManager就作为上面提到的私有的远程索引库。
(2) 终端执行下面命令,将私有的远程索引库copy到本地。
pod repo add HLSpecRep http://gitlab.xxxxxxx/hlbasecoderepo/hlspecrep.git
执行完毕后,在目录:/Users/xx/.cocoapods/repos 下会多出来一个HLSpecRep文件夹,至此私有的索引库部分就完成了。
2.创建私有Pod组件库
(1) 打开终端,进入到桌面目录下,执行下面命令来创建一个名为ComponentManager的Pod库空模板。
pod lib create ComponentManager
然后依次输入下面信息进行配置:
iOS , ObjC , Yes , None , No , Component(最后一个是文件名)
配置完毕之后,Pod库空模板就创建成功了,系统会自动此模板。
(2) 在gitlab上创建远程仓库HLComponentManager,克隆地址是:http://gitlab.xxxxx/hlbasecoderepo/hlcomponentmanager.git,在终端HLComponentManager目录下执行下面命令,关联本地仓库到远程仓库。
git remote add origin http://gitlab.xxxxx/hlbasecoderepo/hlcomponentmanager.git
(3) 将原Demo项目中需要封装的模块,复制到 ComponentManager/ComponentManager/Classes文件夹中
image.png
点击进入Example文件夹,然后打开程序,在xcode中将需要的代码文件拖到Pods/DevelopmentPods/ComponentManager下,并且删掉刚创建的时候自带的ReplaceMe文件(工程目录见下图)
image.png
上面搞定之后,接着就是修改ComponentManager.podspec文件,如下图
image.png
修改完成之后,将本地代码推送到远程仓库,设置tag并推送到远端(注意:tag要和上图中s.version版本一样,我这个图是0.0.6,刚创建的时候默认是0.0.1),然后终端执行下面命令,来校验我们的 ComponentManager.podspec 文件
pod spec lint
等待片刻,终端出现 ComponentManager.podspec passed validation
,则说明 ComponentManager.podspec 文件通过校验。
如果报警告而不是错误,就输入
pod spec lint --allow-warnings
3.将ComponentManager.podspec文件加入私有的远程索引库
上面已经验证过 ComponentManager.podspec 文件没问题,接着就是要把 ComponentManager.podspec 文件添加到私有的索引库(也就是第一步中得到的索引库 FERSpecs),在终端执行下面命令:
repo push HLSpecRep ComponentManager.podspec --verbose --use-libraries --allow-warnings --sources='http://gitlab.xxxxxxx/hlbasecoderepo/hlspecrep.git'
上面命令对 ComponentManager.podspec 文件做了两个操作:一个是将其推送到私有的远程索引库,可以去 gitlab 的 HLSpecRep仓库中查看;另一个是将其copy到私有的本地索引库,这个可以去目录:/Users/xx/.cocoapods/repos/HLSpecRep 下查看到。
至此,Base模块抽取成私有的Pod库也就完成了,可以在终端执行pod search ComponentManager
来查询它,接下来就是在原项目中使用它了。
4.使用私有Pod库
在原项目的Podfile中,输入
source 'http://xxxxxx/hlbasecoderepo/hlspecrep.git'
接着执行pod install
命令进行安装。
另外,公司内部其他成员在使用之前需要执行下面命令,将私有的远程索引库copy到本地,然后就可以正常使用了。
pod repo add HLSpecRep https://gitlab.xxxxxx/hlbasecoderepo/hlspecrep.git
说在最后
在整个pod私有库的创建,需要到git服务器上创建两个仓库,一个作为索引库,一个作为pod组件库;接着就是创建模板并配置.podspec文件;然后就是让索引库管理.podspec文件。
如果库里面有关联别的私有库
命令后面都要添加库地址。比如
pod lib lint --sources="cocoapods库地址,私有库远程地址" —allow-warnings
pod spec lint --sources="cocoapods库地址,私有库远程地址" —allow-warnings
pod repo push 索引库名称 ComponentManager.podspec --verbose --use-libraries --allow-warnings --sources='http://xxxxxx/hlbasecoderepo/hlspecrep.git'
每次修改私有库需要提升版本号,不然会出问题。