前言
项目大了或者多了之后都会遇到维护和编译慢的一个问题。组件化管理一些公用的内容既方便开发也方便管理。
网上私有库创建的教程很多,但是确实会遇到一些奇葩问题,特在此记录一下我完整的创建到最终引用私有库的全过程。
创建(私有库github收费,所以我使用https://gitee.com码云)
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、创建私有代码库
此时利用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的项目
到example 文件目录下 备注:只有此处是在example目录下运行,其余的命令全部在项目根目录Privatekit文件夹下运行
$ pod install
然后按照需求更改podspec 文件的各项答案(模板基本填写,只需要将一些链接更改成我们自己的链接,以及summary和description等)
更改完成后可以使用命令
$ pod lib lint 检查是否有效
备注:可以使用另外后缀语法 过滤无关紧要的信息或者查看错误的详细信息,
--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)的,而且也运行了。
最后查出来,是之前取消过这个模拟器
就算重新勾上也没用还是无效,包括重启删除缓存等等方法。
解决办法:右键delete 这个模拟器重新添加一次。就ok了。