关于利用cocoapods创建私有库的过程记录

前言

项目大了或者多了之后都会遇到维护和编译慢的一个问题。组件化管理一些公用的内容既方便开发也方便管理。

网上私有库创建的教程很多,但是确实会遇到一些奇葩问题,特在此记录一下我完整的创建到最终引用私有库的全过程。

创建(私有库github收费,所以我使用https://gitee.com码云)

1、创建私有索引库


关于利用cocoapods创建私有库的过程记录_第1张图片
私有索引库

复制创建好的库的链接

# pod repo add [Private Repo Name] [git https url]  

 比如:$ pod repo add hrSpecs  https://gitee.com/HRChen/hrSpecs.git

此时会在~/.cocoapods/repos目录下看到你的【Private Repo Name】的文件夹。

2、创建私有代码库


关于利用cocoapods创建私有库的过程记录_第2张图片
私有代码库

此时利用pod 命令创建库的模板

# pod lib create [projectName]

例如 $ pod lib create PrivateKit 

控制台会先下载模板,然后顺序弹出选项让你配置一些基本信息

GavindeMacBook-Pro:~ gavin$ pod lib create PrivateKit

Cloning `https://github.com/CocoaPods/pod-template.git` into `PrivateKit`.

Configuring PrivateKit template.

security: SecKeychainSearchCopyNext: The specified item could not be found in the keychain.

------------------------------

To get you started we need to ask a few questions, this should only take a minute.

If this is your first time we recommend running through with the guide: 

 -https://guides.cocoapods.org/making/using-pod-lib-create.html

 ( hold cmd and double click links to open in a browser. )

What platform do you want to use?? [ iOS / macOS ]

 > 


What platform do you want to use?? [ iOS / macOS ]

 >ios

What language do you want to use?? [ Swift / ObjC ]

 >swift

Would you like to include a demo application with your library? [ Yes / No ]

 >yes

Which testing frameworks will you use? [ Quick / None ]

 >None

Would you like to do view based testing? [ Yes / No ]

 >no

根据需要填写上面的问题。完成后悔自动xcode打开PrivateKit的项目


关于利用cocoapods创建私有库的过程记录_第3张图片
PrivateKit的项目

到example 文件目录下  备注:只有此处是在example目录下运行,其余的命令全部在项目根目录Privatekit文件夹下运行

$ pod install  

然后按照需求更改podspec 文件的各项答案(模板基本填写,只需要将一些链接更改成我们自己的链接,以及summary和description等)

更改完成后可以使用命令

$ pod lib lint 检查是否有效

备注:可以使用另外后缀语法 过滤无关紧要的信息或者查看错误的详细信息,


关于利用cocoapods创建私有库的过程记录_第4张图片
后缀语法和用途

--private 可以过滤一些私有库可以忽略的警告

--verbose 获得更详细的日志

等等...

(可能会遇到swift版本设置)下面可以解决

echo "[version]> .swift-version

$ echo "3.0> .swift-version

直到控制台显示

 PrivateKit passed validation.

将代码推送到之前建立的PrivateKit的远程服务器上

$ git add .

$ git commit -s -m "XXX"

$ git remote add origin https://gitee.com/HRChen/PrivateKit.git#添加远端仓库

$ git push origin master#提交到远端仓库

$ git tag  0.1.0  #打上标签,这个很重要

$ git push --tags#推送tag到远端仓库

3、将私有库PrivateKit的podspec关联到hrSpecs索引库上

# pod repo push [Repo名] [podspec 文件名字]

$ pod repo push hrSpecs PrivateKit.podspec

此时在~/.cocoapods/repos下的hrSpecs会有关于PrivateKit的索引信息以及hrSpecs远程服务器也会有代码push上去

此时可以检查远程服务器上的podspec 是否有效。

$ pod spec lint 

输出 PrivateKit passed validation 为有效

此时库的创建和关联都完成,使用下面命令可以查询

 $ pod search PrivateKit


4、常见错误

常规错误提示会很明显,我遇到一个比较奇葩的错误,

- ERROR | xcodebuild: Returned an unsuccessful exit code. You can use `--verbose` for more information.

    - NOTE  | [iOS] xcodebuild:  xcodebuild: error: Unable to find a destination matching the provided destination specifier:

加上--verbose后

xcodebuild: error: Unable to find a destination matching the provided destination specifier: { id:CB895974-468D-4487-B7BA-362513792516 }

还有一个有效的模拟器列表,但是我xcode是支持这个模拟器(iphone 4s 8.1)的,而且也运行了。

最后查出来,是之前取消过这个模拟器


关于利用cocoapods创建私有库的过程记录_第5张图片
以前取消过这里

就算重新勾上也没用还是无效,包括重启删除缓存等等方法。

解决办法:右键delete 这个模拟器重新添加一次。就ok了。

你可能感兴趣的:(关于利用cocoapods创建私有库的过程记录)