前些日子把项目上的一些模块拆分成独立的模块,看了下Cocoapods管理私有库的方法,其中踩过一些坑,在这里分享给大家,希望大家能少走弯路
这里对Cocoapods这个工具就不多做介绍了,在使用Cocoapods创建私有库的时候,需要git远程仓库
git远程仓库可以用GitHub/GitLab来创建,当然也可以自己搭建git远程仓库
我这里是用GitLab在本地局域网搭建远程仓库
首先创建一个TestPodRepo仓库,该仓库用来保存各个私有库的版本信息
TestPodRepo仓库将刚才创建的TestPodRepo仓库添加到本地Cocoapods中,首先执行命令查看本地Cocoapods的仓库
本地pod仓库pod repo
执行命令将刚创建pod远程仓库添加到本地
添加远程仓库TestPodRepo到本地pod repo add TestPodRepo git@172.16.21.253:platform_ios/TestPodRepo.git
添加仓库之后,我们使用pod repo 命令查看下当前本地仓库
本地仓库列表可以看到TestPodRepo远程仓库已经添加到本地仓库列表
接下来在本地创建一个仓库,用来管理拆分出来的独立模块,使用Pods命令来创建
利用pods创建仓库pod lib create TestModule
创建好之后Pods会自动打开Demo工程
Pods自动生成的Demo工程本地目录下Pods自动生成的文件如下图
本地Pods项目TestModule目录删除Pods自动生成的ReplaceMe.m文件
删除ReplaceMe.m添加代码到项目中,添加的位置为刚刚删除的ReplaceMe.m文件的位置
在项目目录中找到TestModule.podspec文件并打开,如图TestModule.podspec内容为默认生成
TestModule.podspec内容s.name 项目名称
s.version 项目版本号
s.source 其中git后面的地址为远程仓库的地址
s.source_files 为源码匹配规则 可以写为TestModule/Classes/**/*.{h,m}这样只陪位.h,.m文件,匹配规则根据需要进行改变
s.dependency 为该模块依赖的其他第三方库
如果依赖多个库,要按如下方式添加
s.dependency 'AFNetworking'
s.dependency 'SDWebImage'
多个库必须换行添加,不能以逗号分隔
s.vendored_libraries 依赖第三方静态库
如:s.vendored_libraries='xxxx.a','nnnn.a'
配置完podspec文件之后,找到Demo下Podfile文件并打开,在文件的最上方添加Pods仓库的源地址
编辑完Podfile之后,在终端进入Podfile路径,执行pod install,会自动将Demo工程与Pods工程关联起来,编译Demo工程,编译看看是否报错,可以通过Demo工程调试Pods下的独立模块,顺利编译通过之后,在终端进入TestModule.podspec目录下,执行命令验证当前项目
pod lib lint
如果想要忽略警告错误需要在后面添加 --allow-warnings
pod lib lint --allow-warnings
如果创建的项目依赖了其他第三方库需要添加 --use-libraries
pod lib lint --allow-warnings --use-libraries
如果依赖的第三方库也是私有库 需要指定--source
pod lib lint --allow-warnigns --use-libraries --source=git@172.16.21.253:platform_ios/PodRepo.git,https://github.com/CocoaPods/Specs.git
如图所示,没有加上--allow-warnings时,有很多警告,导致pod lib lint 验证不过
pod lib lint加上--allow-warnings 之后,如图所示,验证通过
pod lib lint --allow-warnings验证本地代码成功之后,需要验证远程仓库上的代码,终端执行命令如下
pod spec lint
如果忽略警告,添加--allow-warnings
pod spec lint --allow-warnings
如果引用其他第三方库 添加 --use-libraries
pod spec lint --allow-warnings --use-libraries
如果引用第三方库是私有的,需要添加 --source
pod spec lint --allow-warnings --use-libraries --source=git@172.16.21.253:platform_ios/PodRepo.git,https://github.com/CocoaPods/Specs.git
终端执行命令验证远程仓库
如上图所示,报错是因为没有将本地仓库提交到远程仓库,下面我们提交本地仓库到远程仓库,并且为远程仓库打上标签,标签必须与TestModule.podspec中的s.version的值一致
提交到远程之后,再在本地验证远程仓库
如图所示,远程仓库验证成功,接下来需要将TestModule.podspec文件提交到Cocoapods的私有库中,也就是我们之前创建TestPodRepo仓库,该仓库专门管理所有私有库的podspec文件(如果不将podspec上传到TestPodRepo,其他人无法通过pod install依赖私有库)
执行命令
pod repo push TestPodRepo TestModule.podspec --allow-warnings
如图所示,TestModule.podspec已经上传到远程仓库TestPodRepo中
到此为止,该独立模块已经被制作为Cococapods 私有库,如果其他项目需要依赖该模块,通过pod install方式就可以引用该模块
强调一遍,引用该模块的说话,需要在podfile上方添加pods仓库的源地址
用了一上午的时间写了这么多分享给大家,之前写文章分享的经验比较少,可能文章格式和内容不够细致,希望能对你有所帮助
网友评论