使用CocoaPods创建私有库
最近在研究使用CocoaPods创建私有库,因为公司要使用组件化,然后打算用cocoapods来管理各个组件,那就废话少说吧,直接把步骤跟大家分享下,有不对的地方希望大家多多指教,感激不尽!
主要的参考链接有以下几个: www.jianshu.com/p/107cc74847ab
blog.csdn.net/yanyanforest/article/details/53406855
www.jianshu.com/p/7a82e977281c
www.jianshu.com/p/ddc2490bff9f
www.jianshu.com/p/c6c227c0c221
www.cocoachina.com/ios/20150930/13471.html
主要是以下四个步骤:
一、创建Spec Repo管理我们创建的所有pod spec (repo1)
二、创建准备制作成podspec的项目 (repo2)
三、创建并提交MyLib pod库的pod spec文件到私有仓库
四、pod做成功了
五、常见错误
过程如下:
一、创建Spec Repo管理我们创建的所有pod spec
注意:查看本地的cocoapods文件目录路径:~/.cocoapods/repos,这是一个隐藏文件,可以通过终端命令来(显示 \隐藏)隐藏文件:
显示隐藏文件:$ defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder
隐藏文件:$ defaults write com.apple.finder AppleShowAllFiles -boolean false ; killall Finder
以上是我本地repos的目录:master是官方的目录,FXSpecs是我们自己的私有库目录。
1、首先在gitlab上建立一个FXSpecs项目(管理所有的pod spec文件)
2.终端执行一下命令clone远程的FXSpecs:
# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add FXSpecs http://zhoubin2017@git.xxx.com:88/xxx/FXSpecs.git
此时查看你的本地~/.cocoapods/repos路径就会发现FXSpecs文件已经存在了
二、创建准备制作成podspec的项目
1.在GitLab上创建FXLoginRegist项目(repo2)
2.cd进入到要创建项目的目录,然后终端执行以下命令创建工程:
#pod lib create [项目名]
$pod lib create FXLoginRegist
接着在控制台就会输出以下几个问题让你来回答:
2.1选择使用语言
What language do you want to use?? [ Swift / ObjC ]
> ObjC
2.2问你是否需要创建一个Demo项目,我选的是Yes
Would you like to include a demo application with your library? [ Yes / No ]
> Yes
2.3让你是否选择一个测试框架,选 None
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> None
2.4是否基于View测试,选Yes
Would you like to do view based testing? [ Yes / No ]
> yes
2.5类的前缀
What is your class prefix?
> FXL
完成以上的问题后控制台会输出以下信息 ,然后自动打开所创建的项目
在以下截图的目录下添加你的实现代码,里面自带一个ReplaceMe.m文件,直接删除它就好了,添加你自己的.h.m实现文件 ,如下图:
3.修改Podfile文件,打开工程目录下Example目录的Podfile文件,修改如下:
修改之后在Example目录下执行pod update安装依赖
4.提交本地的FXLoginRegist到远程仓库(repo2)
在终端执行以下命令:
至此,本地的FXLoginRegist已经提交至远程仓库了,如下图:
三、创建并提交MyLib pod库的pod spec文件到私有仓库
1.配置pod spec文件信息,打开FXLoginRegist目录下的FXLoginRegist.podspec文件,如下图:
2.编辑好了之后,要验证下podspec文件
2.1执行以下命令:pod lib lint
成功后终端会输出以下信息:-> FXLoginRegist (0.1.0)
FXLoginRegist passed validation.
3.测试pod spec文件,cd Example工程目录,执行pod update
4.向Spec Repo提交pod spec,也就是把FXLoginRegist.podspec提交到远程仓库(repo1),终端执行:
成功后会在控制台输出如下信息,我遇见额的几个问题和解决办法会在文章底部给大家写上仅供参考:
至此,~/.cocoapods/repos/FXSpecs目录下就已经存在了我们创建的pod spec文件了,可以在cocoapods上面查询到
四、pod做成功了
这是我们既可以把制作好的podspec集成到项目中啦,在podfile中药配置如下信息,然后pod install就成功啦
五、常见错误
1.pod lib lint时候常见的错误
1)错误: [!] ExtensionSample did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it).
[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run:
`echo "2.3" > .swift-version`.
You can use the `--no-clean` option to inspect any issue.
解决办法:终端输入命令echo "2.3" > .swift-version 解决
2)错误:[!] TestLib did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it) and all results apply only to public specs, but you can use `--private` to ignore them if linting the specification for a private pod.
You can use the `--no-clean` option to inspect any issue.
bogon:TestLib sunjinshuai$
解决办法:pod lib lint --allow-warnings
3)错误:ERROR | [iOS] unknown: Encountered an unknown error (An unexpected version directory `Assets` was encountered for the `/Users/zzz/.cocoapods/repos/aaa/xxx` Pod in the `xxx` repository.
解决办法:找到上边提示的路径,然后删除xxx文件就好了
4)错误:ERROR | [iOS] Encountered an unknown error (The 'Pods' target has transitive dependencies that include static binaries: (/private/var/folders/xx/xxx/T/CocoaPods/Lint/Pods/BPushSDK/LibBPush/libBPush.a)) during validation.
解决办法:这个错误是因为依赖库(s.dependency)包含了.a静态库造成的。虽然这并不影响Pod的使用,但是验证是无法通过的。可以通过 --use-libraries 来让验证通过。
2.pod repo push FXSpecs TestLib.podspec常见错误
1)错误:Validating spec
-> TestLib (0.1.0)
- WARN | source: Git SSH URLs will NOT work for people behind firewalls configured to only allow HTTP, therefore HTTPS is preferred.
[!] The repo `FXSpecs` at `../.cocoapods/repos/FXSpecs` is not clean
解决办法:1.cd到repo目录
2.git status(有时候是因为有内容没有commit,如果提示那就commit一下)
3.git clean -f (清除多余的隐藏文件之类的)
4.push就成功了,希望对你有帮助