1.創(chuàng)建組件
pod lib create '組件名'
# 使用平臺
What platform do you want to use?? [ iOS / macOS ]
> iOS
# 使用語言
What language do you want to use?? [ Swift / ObjC ]
> ObjC
# 在組件中創(chuàng)建一個Example
Would you like to include a demo application with your library? [ Yes / No ]
> Yes
# 是否添加測試框架
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> None
# 是否添加UI測試
Would you like to do view based testing? [ Yes / No ]
> No
# 組件類前綴
What is your class prefix?
> YDD
執(zhí)行完成后打開工程目錄如圖1：
將組件文件創(chuàng)建在圖中ReplaceMe.m文件位置，將組件文件存儲在ReplaceMe.m的文件夾Classes目錄下衔蹲，并刪除ReplaceMe.m文件讹堤。
2.修改podspec描述文件
Cocopods原理：根據(jù)Podfile描述偎窘，找到對應(yīng)代碼庫的podspec文件
然后根據(jù)podspec中的描述芯侥，找到代碼庫缠犀，并且拷貝需要的文件到自己的工程中。
如果組件工程已近存在臭觉，則直接在組件工程目錄創(chuàng)建podspec文件即可
pod spec create '組件名'
Pod::Spec.new do |s|
# 組件名稱
s.name = 'YDDCategroy'
# 組件版本號
s.version = '0.1.0'
# 組件簡介
s.summary = 'A short description of YDDCategroy.'
# 組件詳細(xì)描述昆雀，要比簡介字?jǐn)?shù)多一些
s.description = <<-DESC
TODO: Add long description of the pod here.
DESC
# 組件倉庫
s.homepage = 'https://github.com/***/YDDCategroy'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
# 設(shè)置許可
s.license = { :type => 'MIT', :file => 'LICENSE' }
# 組件作者
s.author = { '***' => '***' }
# 組件倉庫源,表示在哪可以找到組件工程(支持 git、svn蝠筑、http 服務(wù)器)
s.source = { :git => 'https://github.com/***/YDDCategroy.git', :tag => s.version.to_s }
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
# 組件支持的最低系統(tǒng)版本
s.ios.deployment_target = '9.0'
# 組件庫需要暴露的文件
s.source_files = 'YDDCategroy/Classes/**/*'
# 設(shè)置依賴庫(系統(tǒng))狞膘，不需要 lib，例如： libicucore寫成icucore即可
s.libraries = "resolv.9","icucore","sqlite3","z","xml2","bz2.1.0","c++"
#設(shè)置依賴的 framework(系統(tǒng))菱肖，寫的時候不需要后綴名
s.framework = "CoreTelephony","MediaPlayer","CFNetwork","SystemConfiguration","MobileCoreServices","AudioToolbox","AVFoundation","VideoToolbox"
# 設(shè)置使用的靜態(tài)庫(非系統(tǒng))
s.vendored_library = 'sdk/*.a'
# 設(shè)置使用的framework(非系統(tǒng))
s.vendored_frameworks = ""
# 設(shè)置子目錄
s.subspec 'Delegate' do |ss|
ss.source_files = "sdk/Delegate/*.h"
end
s.subspec 'enums' do |ss|
ss.source_files = "sdk/enums/*.h"
end
s.subspec 'Manager' do |ss|
ss.source_files = "sdk/Manager/*.h"
end
s.subspec 'private' do |ss|
ss.source_files = "sdk/private/*.h"
end
s.subspec 'types' do |ss|
ss.source_files = "sdk/types/*.h"
# 三級目錄
ss.subspec 'LiveChatRoomType' do |sss|
sss.source_files = "sdk/types/LiveChatRoomType/*.h"
end
end
s.subspec 'board' do |ss|
ss.source_files = "sdk/board/*.h"
end
# s.resource_bundles = {
# 'YDDCategroy' => ['YDDCategroy/Assets/*.png']
# }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# 設(shè)置依賴的其他 pod 庫
# s.dependency 'AFNetworking', '~> 2.3'
end
3.將本地組件push到遠(yuǎn)端倉庫
在自己的github上新建組件倉庫客冈，將本地代碼推向遠(yuǎn)端，并且打tag稳强，注意tag版本號要和podspec文件中的版本號一直场仲。
# 創(chuàng)建tag版本
git tag -a 0.1.0 -m '描述'
# 將本地所有tag版本push到遠(yuǎn)端
git push origin --tag
4.驗證組件
驗證組件和悦，保證組件代碼編譯是沒有問題的，verbose打印log渠缕，allow-warnings忽略警告保證lint通過鸽素，如果是私有組件要在后面添加--use-libraries
pod lib lint --verbose --allow-warnings
驗證私有組件:
pod spec lint YDDCategroy.podspec --allow-warnings --use-libraries --platforms=ios --skip-import-validation --sources=https://github.com/***/privatespec.git
如果私有組件中依賴私有庫，需要將sources指向私有spec地址
5.將組件的podspec描述文件推送到cocoapods
pod trunk push --verbose --allow-warnings --use-libraries
如果你的github賬號之前沒有注冊cocoapod是不能推送podspec文件的亦鳞，所以需要先注冊馍忽。
pod trunk register 'git郵箱' 'git用戶名'
執(zhí)行完成后會收到驗證郵件，在郵箱驗證即可燕差。
通過以上過程自己的pod庫就已經(jīng)制作完畢遭笋，在第一使用pod install時沒有找到自己的庫，可能是本地trunk沒有更新的原因吧徒探，使用pod update是可以導(dǎo)入瓦呼。如果是Podfile文件指定的iOS版本低于podspec中指定的iOS版本也會報錯找不到對應(yīng)的庫，這種情況可以修改Podfile文件也可以修改podspec文件中系統(tǒng)版本测暗，修改podspec文件后需要重新上傳央串。
6.更新組件：
更新完組件代碼后修改podspec文件中的s.version版本號，然后提交組件代碼到遠(yuǎn)程倉庫并且打tag版本碗啄，tag版本號與podspec中的s.version版本號一致质和，然后安裝步驟4驗證podspec文件，最后將podspec文件推送到私有spec倉庫稚字。
# 更新cocoapod中的podspec
pod trunk push
# 更新私有倉庫podspec
pod repo push PrivatePods YDDCategroy.podspec
如果報錯后面加上 --verbose --allow-warnings --use-libraries --skip-import-validation
pod repo push PrivatePods YDDCategroy.podspec --verbose --allow-warnings --use-libraries --skip-import-validation
7.本地組件
組件在開發(fā)過程中還沒有推送到遠(yuǎn)端饲宿，這時候需要使用本地組件，在主工程中對組件進(jìn)行開發(fā)尉共。
- 1.修改本地組件的podspec文件中的spec.source路徑褒傅，使其指向自己的本地文件路徑。
# path 為podspec文件目錄下的相對路徑
spec.source = { :path => 'YDDCategroy.podspec' }
- 2.修改Podfile文件中的pod, 添加path本地文件路徑
target 'TestDemo' do
pod 'YDDCategroy', :path => '../YDDCategroy'
end
path路徑可以是絕對路徑也可以是相對路徑袄友，這里使用相對路徑殿托，由于TestDemo工程文件夾和YDDCategroy組件工程文件夾是同級文件夾，Podfile在TestDemo文件夾下剧蚣，而YDDCategroy.podspec在YDDCategroy文件夾下支竹，所以../指向TestDemo和 YDDCategroy的上級文件目錄，YDDCategroy.podspec的文件目錄的相對路徑為 '../YDDCategroy' 鸠按。
如果組件代碼已經(jīng)在遠(yuǎn)端倉庫礼搁，可以不用修改podspec文件的spec.source，直接修改Podfile文件中的path路徑即可目尖。
執(zhí)行pod install后就會發(fā)現(xiàn)在工程的pods里面多了Development Pods馒吴，這時候說明可以直接在TestDemo工程中對組件進(jìn)行開發(fā)。
8.構(gòu)建私有podspec倉庫
- 1.在github上新建一個privatespec倉庫用來存儲私有組件的podspec文件。
- 2.cd到 ~/.cocoapods/repos文件目錄添加privatespec
pod repo privatespec https://github.com/***/privatespec.git
- 3.cd到組件文件目錄饮戳，將組件podspec推送到Privatespec倉庫
pod repo push [私有spec倉庫名] [組件.podspec] --sources=私有spec倉庫地址
pod repo push Privatespec YDDCategroy.podspec --sources=https://github.com/***/privatespec.git --verbose --allwo-warnings --use-libraries
- 4.驗證私有spec倉庫
新建一個demo工程豪治，在Podfile文件頂行添加sources指向私有倉庫
source 'https://github.com/***/privatespec.git'
platform :ios, '9.0'
target 'PrivateSpecTest' do
pod 'YDDCategroy'
end
pod update 即可
9.pod組件中添加資源文件
組件工程文件結(jié)構(gòu)如下圖2：
Assets用來存放資源文件，Classes文件用于存放類文件扯罐。使用pod將組件導(dǎo)入主工程后负拟，組件實質(zhì)上是作為framework庫存在于工程中，此時在讀取資源時直接使用[NSBundle mainBundle]是獲取不到資源文件的歹河。
- 1.加入資源文件
首先將圖片等資源文件放入Assets文件夾下掩浙，然后修改podspec文件中的resource_bundles，設(shè)置組件bundle
s.resource_bundles = {
'YDDCategroy' => ['YDDCategroy/Assets/*']
}
修改完成后 pod install
- 2.查看組件資源
編譯工程后在Products目錄找到App包秸歧。顯示報內(nèi)容厨姚，文件結(jié)構(gòu)如下圖3、4：
（1）pod使用framework寥茫，即：Podfile文件頂部有 ： use_frameworks!
（2）pod不使用framework遣蚀，即：Podfile文件頂部沒有 ： use_frameworks!
- 3.讀取組件資源
在讀取資源時需要先找到Y(jié)DDCategroy bundle，在通過bundle路徑讀取資源纱耻。
/// 獲取framework組件bundle
/// @param pod 組件名
/// @param bundleName 組件bundle名（不帶擴(kuò)展名）
+ (NSBundle *)ydd_bundleWithPod:(NSString *)pod bundleName:(NSString *)bundleName {
NSString *path = [[NSBundle mainBundle] pathForResource:@"Frameworks" ofType:nil];
if (!path) {
/// pod沒有使用 framework
path = [[NSBundle mainBundle] resourcePath];
NSString *bundlePath = [NSString stringWithFormat:@"%@/%@.bundle", path, bundleName];
return [NSBundle bundleWithPath:bundlePath];
}
NSString *bundlePath = [NSString stringWithFormat:@"%@/%@.framework/%@.bundle", path, pod, bundleName];
return [NSBundle bundleWithPath:bundlePath];
}
參考:http://www.reibang.com/p/e3ec9a8bec97
參考:https://www.dazhuanlan.com/2019/12/14/5df40a0b09d99/
