使用CocoaPods可以很方便的管理第三方库,当我们需要维护多个项目,并且项目中用到了很多公用的组件或者api,那么我们可以将这些api抽取出来。
如果使用git,还可以使用git的子模块管理这些公共的api或者库,这里我们选用pod,在podfile中加入类似如下的代码,可以像管理其他第三方库一样管理我们自己的私有仓库
pod 'I18nDemo', :git => 'github地址', :branch => '0.1.0'
建立私有仓库之前,首先要明确几个概念
- 1、CocoaPods维护的是一个spec的描述文件列表,不会真正的维护或者保存具体的代码,具体的代码我们可以放到github或者CSDN等第三方平台
- 2、spec文件描述了库的名称,版本,地址,描述等信息
-
3、因为是私有仓库,所以我们需要自己建立存放私有仓库描述信息spec地址的库,我们称之为私有spec库。至于私有仓库就像平常建立github库一样创建就可以了。(如果你觉得麻烦,可以将spec和源代码使用一个库处理)
如上图所示,SrxSpec库就是保存我们所有第三方库sepc文件的库,这个库也可以使用git同步
使用pod默认会创建在~/.cocoapods/repos目录下。我们可以看到repos中有master库,这些就是pod上所有第三方库的spec文件,如果我们创建公共库,那么也可以将spec文件传到pod上。至于我们私有库的源代码,可以随意选择位置放置。
创建私有仓库
1、在github(也可以是公司的gitlab,或者CSDN等其他平台)上创建保存spec的仓库,或者git地址
2、创建存放spec文件的仓库(我这里用名字SrxSpec)
在teminal中使用下述命令创建spec仓库
pod repo add [SrxSpec] [第一步创建的git地址]
添加完成之后再~/.cocoapods/repo中就可以看到和master同级的一个目录,也就是存放库索引的地方。
3、在github(也可以是公司的gitlab,或者CSDN等其他平台)上再创建一个仓库,用来存放源代码,然后克隆到本地。
4、在源代码根目录创建cocoapods的demo文件。我这里取名为I18NDemo2
使用命令
pod lib create I18NDemo2
创建过程会配置一些选项,可以根据自己的需求配置
What platform do you want to use?? [ iOS / macOS ]
> ios
What language do you want to use?? [ Swift / ObjC ]
> objc
Would you like to include a demo application with your library? [ Yes / No ]
> yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> none
Would you like to do view based testing? [ Yes / No ]
> no
What is your class prefix?
> soc
完成之后会自动在XCode中打开项目中的example。
5、在example的同级目录下,加入自己的源文件
6、配置example的podfile文件,将pod目录指向同级目录下的I18nDemo.podspec
(../代表上一级目录,因为I18nDemo.podspec在podfile的上一级目录)
pod 'I18nDemo', :path => '../I18nDemo.podspec'
7、终端下,podfile目录下使用pod update之后,就可以在Pods工程中看到我们加入的源文件了
接下来,我们看一下Demo同目录下的I18nDemo.podspec文件
#
# Be sure to run `pod lib lint I18nDemo.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see https://guides.cocoapods.org/syntax/podspec.html
#
Pod::Spec.new do |s|
s.name = 'I18nDemo'
s.version = '0.1.0'
s.summary = 'A test Demo'
# This description is used to generate tags and improve search results.
# * Think: What does it do? Why did you write it? What is the focus?
# * Try to keep it short, snappy and to the point.
# * Write the description between the DESC delimiters below.
# * Finally, don't worry about the indent, CocoaPods strips it!
s.description = <<-DESC
TODO: Add long description of the pod here.
DESC
s.homepage = 'https://github.com/ssrrxx111/I18NDemo'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { '作者' => '邮箱' }
s.source = { :git => '源代码git地址', :tag => s.version.to_s }
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
s.ios.deployment_target = '8.0'
s.source_files = 'I18nDemo/Classes/**/*'
# s.resource_bundles = {
# 'I18nDemo' => ['I18nDemo/Assets/*.png']
# }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
其中比较重要的有
s.name = 'I18nDemo' #用来描述第三方库的名称,之后引用的时候需要
s.version = '0.1.0' #版本号,需要对应的在github上建立对应的版本,tag与版本号保持一致
s.source = { :git => '源代码git地址', :tag => s.version.to_s }
s.source_files = 'I18nDemo/Classes/**/*' #存放源代码的地址,这里可以看到是所有Classes的二级目录的所有文件
8、修改了podspec文件后,需要使用下面的命令验证spec文件是否正确,可以根据提示调整
pod lib lint
9、如果spec文件校验通过,接着使用下面的命令将sepc文件上传到我们的私有保存spec的仓库SrxSpec中
pod repo push [私有spec仓库名称] [我的源代码的podspec仓库的本地文件路径]
如下:
pod repo push SrxSpec I18NDemo2/I18nDemo.podspec
碰到的一些问题:
1、碰到无法找到模拟器,使用sudo gem install cocoapods更新pod修复了(网上有各种需要修改fourflisher的,没有用)
2、source_files无法找到,Classes路径设置错误,根据它的作用,可以使用对应的路径处理
CocoaPods私有仓库的使用
1、创建完成之后,可以使用github的地址来使用我们的私有仓库,将之前example中的podfile引用改为如下:
pod 'I18nDemo', :git => 'https://github.com/ssrrxx111/I18NDemo.git', :branch => '0.1.0'
参考文章:
1、CocoaPods创建私有库