iOS开发iOS学习专题iOS开发

使用CocoaPods创建私有库

2017-07-12  本文已影响897人  zhou某某

最近在研究使用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就成功了,希望对你有帮助

上一篇 下一篇

猜你喜欢

热点阅读