使用CocoaPods可以很方便的管理第三方庫,當(dāng)我們需要維護(hù)多個項目,并且項目中用到了很多公用的組件或者api,那么我們可以將這些api抽取出來。
如果使用git,還可以使用git的子模塊管理這些公共的api或者庫,這里我們選用pod,在podfile中加入類似如下的代碼,可以像管理其他第三方庫一樣管理我們自己的私有倉庫
pod 'I18nDemo', :git => 'github地址', :branch => '0.1.0'
建立私有倉庫之前,首先要明確幾個概念
- 1、CocoaPods維護(hù)的是一個spec的描述文件列表,不會真正的維護(hù)或者保存具體的代碼,具體的代碼我們可以放到github或者CSDN等第三方平臺
- 2、spec文件描述了庫的名稱,版本,地址,描述等信息
-
3、因為是私有倉庫,所以我們需要自己建立存放私有倉庫描述信息spec地址的庫,我們稱之為私有spec庫。至于私有倉庫就像平常建立github庫一樣創(chuàng)建就可以了。(如果你覺得麻煩,可以將spec和源代碼使用一個庫處理)
image.png
如上圖所示,SrxSpec庫就是保存我們所有第三方庫sepc文件的庫,這個庫也可以使用git同步
使用pod默認(rèn)會創(chuàng)建在~/.cocoapods/repos目錄下。我們可以看到repos中有master庫,這些就是pod上所有第三方庫的spec文件,如果我們創(chuàng)建公共庫,那么也可以將spec文件傳到pod上。至于我們私有庫的源代碼,可以隨意選擇位置放置。
創(chuàng)建私有倉庫
1、在github(也可以是公司的gitlab,或者CSDN等其他平臺)上創(chuàng)建保存spec的倉庫,或者git地址
2、創(chuàng)建存放spec文件的倉庫(我這里用名字SrxSpec)
在teminal中使用下述命令創(chuàng)建spec倉庫
pod repo add [SrxSpec] [第一步創(chuàng)建的git地址]
添加完成之后再~/.cocoapods/repo中就可以看到和master同級的一個目錄,也就是存放庫索引的地方。
3、在github(也可以是公司的gitlab,或者CSDN等其他平臺)上再創(chuàng)建一個倉庫,用來存放源代碼,然后克隆到本地。
4、在源代碼根目錄創(chuàng)建cocoapods的demo文件。我這里取名為I18NDemo2
使用命令
pod lib create I18NDemo2
創(chuàng)建過程會配置一些選項,可以根據(jù)自己的需求配置
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的同級目錄下,加入自己的源文件

image.png
6、配置example的podfile文件,將pod目錄指向同級目錄下的I18nDemo.podspec
(../代表上一級目錄,因為I18nDemo.podspec在podfile的上一級目錄)
pod 'I18nDemo', :path => '../I18nDemo.podspec'
7、終端下,podfile目錄下使用pod update之后,就可以在Pods工程中看到我們加入的源文件了

image.png
接下來,我們看一下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' #版本號,需要對應(yīng)的在github上建立對應(yīng)的版本,tag與版本號保持一致
s.source = { :git => '源代碼git地址', :tag => s.version.to_s }
s.source_files = 'I18nDemo/Classes/**/*' #存放源代碼的地址,這里可以看到是所有Classes的二級目錄的所有文件
8、修改了podspec文件后,需要使用下面的命令驗證spec文件是否正確,可以根據(jù)提示調(diào)整
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修復(fù)了(網(wǎng)上有各種需要修改fourflisher的,沒有用)
2、source_files無法找到,Classes路徑設(shè)置錯誤,根據(jù)它的作用,可以使用對應(yīng)的路徑處理
CocoaPods私有倉庫的使用
1、創(chuàng)建完成之后,可以使用github的地址來使用我們的私有倉庫,將之前example中的podfile引用改為如下:
pod 'I18nDemo', :git => 'https://github.com/ssrrxx111/I18NDemo.git', :branch => '0.1.0'
參考文章:
1、CocoaPods創(chuàng)建私有庫
