一、創(chuàng)建私有的Spec Repo (備注:Git倉庫1)
二、創(chuàng)建Pod項目工程,并且有可以訪問的項目版本控制地址 (備注:Git倉庫2)
三、創(chuàng)建并提交MyLib
Pod庫的podspec文件到私有Spec Repo
倉庫
四、使用制作好的Pod
說明:在以上步驟一、二中需要創(chuàng)建兩個Git創(chuàng)庫:
1、Git倉庫1
的作用類似于CocoaPods的官方spec repo專門存放podspec具體可以參考:CocoaPods官方源、Specs;
2、Git倉庫2
的是私有庫的源碼Git版本控制地址。
一、創(chuàng)建私有的Spec Repo
Spec Repo
是所有的Pods的一個索引,是所有公開的Pods 的podspec 文件的一個倉庫,其實就是一個部署在服務器的Git倉庫,當你使用CocoaPods 后它會被Clone到本地的 ~/.cocoapods/repos
目錄下,大概的文件目錄如下:
.
├── MySpecs
│ ├── MyLib
│ │ └── 0.1.1
│ │ └── MyLib.podspec
│ └── README.md
└── master
├── CocoaPods-version.yml
├── README.md
└── Specs
├── !ProtoCompiler
│ ├── 3.0.0
│ ├── 3.0.0-beta-3.1
│ └── 3.0.0-beta-4
├── !ProtoCompiler-gRPCPlugin
│ ├── 0.14.0
│ ├── 1.0.0
│ ├── 1.0.0-pre1
│ ├── 1.0.0-pre1.1
│ └── 1.0.0-pre1.2
Tip:~/.cocoapods/repos文件是一個隱藏目錄,在Mac 上默認是看不到隱藏目錄的,但是我們可以通過「終端」應用程序打開。在Terminal中執(zhí)行以下命令顯示隱藏文件:
$ defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder
執(zhí)行以下命令恢復隱藏文件:
$ defaults write com.apple.finder AppleShowAllFiles -boolean false ; killall Finder
上文的目錄樹形圖就是我電腦的本地的 ~/.cocoapods/repos
目錄,其中master就是官方的Sepc Repo,跟master同目錄級別的MySpecs目錄就是我自己的創(chuàng)建的私有Sepc Repo
。
1、首先在coding.net上創(chuàng)建一個MySpecs
項目,當然你也是可以在公司內網(wǎng)創(chuàng)建的。
2、然后在Terminal中執(zhí)行以下命令
# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add MySpecs https://git.coding.net/kensla/MySpecs.git
注意:這個Git 倉庫地址要換成你自己的創(chuàng)建的 Specs git 地址!?。?/strong>成功后會在~/.cocoapods/repos目錄下就能看到MySpecs了,至此,第一步創(chuàng)建私有Spec Repo就完成了。
二、創(chuàng)建Pod項目工程
1.創(chuàng)建Pod項目工程首先,在coding.net上創(chuàng)建一個MyLib
項目,當然你也是可以在公司內網(wǎng)創(chuàng)建的。然后,使用Cocoapods提供的一個Using Pod Lib Create 工具創(chuàng)建一個工程。
在Terminal中執(zhí)行cd進入要創(chuàng)建項目的目錄然后 執(zhí)行以下命令:
#pod lib create [項目名]
$pod lib create MyLib
接著在Terminal控制臺會輸出:
Cloning `https://github.com/CocoaPods/pod-template.git` into `MyLib`.
Configuring MyLib template.
------------------------------
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:
- http://guides.cocoapods.org/making/using-pod-lib-create.html
( hold cmd and double click links to open in a browser. )
What language do you want to use?? [ Swift / ObjC ]
> ObjC
第一個問題是問你選擇Swift還是Objc構建項目。此教程選的是ObjC
Would you like to include a demo application with your library? [ Yes / No ]
> Yes
第二個問題問你是否需要創(chuàng)建一個Demo項目,此教程選的是Yes
Which testing frameworks will you use? [ Specta / Kiwi / None ]
> Specta
第三個問題讓你是否選擇一個測試框架,此教程選 Specta
Would you like to do view based testing? [ Yes / No ]
> Yes
第四個問題是否基于View測試,選Yes
What is your class prefix?
> ZYK
設置完成后控制臺輸出:
Running pod install on your new library.
[!] No `Podfile' found in the project directory.
Ace! you're ready to go!
We will start you off by opening your project in Xcode
open 'MyLib/Example/MyLib.xcworkspace'
The file /Users/ken/Desktop/工作/MyLib/Example/MyLib.xcworkspace does not exist.
To learn more about the template see `https://github.com/CocoaPods/ pod-template.git`.
To learn more about creating a new pod, see
`http://guides.cocoapods.org/making/making-a-cocoapod`.
成功后會在目錄中創(chuàng)建好一個MyLib工程,結構如下:
Mylib
├── Example ** 這個是第二個問題的 Demo項目
│ ├── MyLib
│ │ ├── Images.xcassets
│ │ │ ├── AppIcon.appiconset
│ │ │ │ └── Contents.json
│ │ │ └── LaunchImage.launchimage
│ │ │ └── Contents.json
│ │ ├── Main.storyboard
│ │ ├── MyLib-Info.plist
│ │ ├── MyLib-Prefix.pch
│ │ ├── ZYKAppDelegate.h
│ │ ├── ZYKAppDelegate.m
│ │ ├── ZYKViewController.h
│ │ ├── ZYKViewController.m
│ │ ├── en.lproj
│ │ │ └── InfoPlist.strings
│ │ └── main.m
│ ├── MyLib.xcodeproj
│ │ ├── project.pbxproj
│ │ ├── project.xcworkspace
│ │ │ └── contents.xcworkspacedata
│ │ └── xcshareddata
│ │ └── xcschemes
│ │ └── MyLib-Example.xcscheme
│ ├── Podfile
│ └── Tests
│ ├── Tests-Info.plist
│ ├── Tests-Prefix.pch
│ ├── Tests.m
│ └── en.lproj
│ └── InfoPlist.strings
├── LICENSE
├── MyLib
│ ├── Assets
│ └── Classes
│ └── ReplaceMe.m **注意存放你自己實現(xiàn)的庫相關代碼?。?!**
├── MyLib.podspec ** 庫的podspec文件,這個是下一步需要重點配置的文件 ?。?!**
├── README.md
└── _Pods.xcodeproj -> Example/Pods/Pods.xcodeproj
2、添加實現(xiàn)代碼
├── MyLib
│ ├── Assets
│ └── Classes
│ └── ReplaceMe.m **注意存放你自己實現(xiàn)的庫相關代碼?。?!**
在本教程中我在上面的Classes文件目錄添加了 MyLib.h、UIColor+Fetch.h、UIColor+Fetch.m 等幾個文件?,F(xiàn)在目錄結構如下:
.
├── Example
│ ├── Build
│ │ ├── Intermediates
│ │ │ ├── MyLib.build
│ │ │ ├── Pods.build
│ │ │ └── PrecompiledHeaders
│ │ └── Products
│ │ └── Debug-iphoneos
│ ├── MyLib
│ │ ├── Images.xcassets
│ │ │ ├── AppIcon.appiconset
│ │ │ └── LaunchImage.launchimage
│ │ ├── Main.storyboard
│ │ ├── MyLib-Info.plist
│ │ ├── MyLib-Prefix.pch
│ │ ├── ZYKAppDelegate.h
│ │ ├── ZYKAppDelegate.m
│ │ ├── ZYKViewController.h
│ │ ├── ZYKViewController.m
│ │ ├── en.lproj
│ │ │ └── InfoPlist.strings
│ │ └── main.m
│ ├── MyLib.xcodeproj
│ │ ├── project.pbxproj
│ │ ├── project.xcworkspace
│ │ │ ├── contents.xcworkspacedata
│ │ │ └── xcuserdata
│ │ ├── xcshareddata
│ │ │ └── xcschemes
│ │ └── xcuserdata
│ │ └── zhongyuanke.xcuserdatad
│ ├── MyLib.xcworkspace
│ │ ├── contents.xcworkspacedata
│ │ └── xcuserdata
│ │ └── zhongyuanke.xcuserdatad
│ ├── Podfile
│ ├── Podfile.lock
│ ├── Pods
│ │ ├── Expecta
│ │ │ ├── Expecta
│ │ │ ├── LICENSE
│ │ │ └── README.md
│ │ ├── Expecta+Snapshots
│ │ │ ├── EXPMatchers+FBSnapshotTest.h
│ │ │ ├── EXPMatchers+FBSnapshotTest.m
│ │ │ ├── ExpectaObject+FBSnapshotTest.h
│ │ │ ├── ExpectaObject+FBSnapshotTest.m
│ │ │ ├── LICENSE.md
│ │ │ └── README.md
│ │ ├── FBSnapshotTestCase
│ │ │ ├── FBSnapshotTestCase
│ │ │ ├── LICENSE
│ │ │ └── README.md
│ │ ├── Headers
│ │ ├── Local\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ Podspecs
│ │ │ └── MyLib.podspec.json
│ │ ├── Manifest.lock
│ │ ├── MyLib
│ │ │ ├── LICENSE
│ │ │ ├── MyLib
│ │ │ └── README.md
│ │ ├── Pods.xcodeproj
│ │ │ ├── project.pbxproj
│ │ │ ├── project.xcworkspace
│ │ │ └── xcuserdata
│ │ ├── Specta
│ │ │ ├── LICENSE
│ │ │ ├── README.md
│ │ │ └── Specta
│ │ └── Target\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ Support\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\ Files
│ │ ├── Expecta
│ │ ├── Expecta+Snapshots
│ │ ├── FBSnapshotTestCase
│ │ ├── MyLib
│ │ ├── Pods-MyLib_Example
│ │ ├── Pods-MyLib_Tests
│ │ └── Specta
│ └── Tests
│ ├── Tests-Info.plist
│ ├── Tests-Prefix.pch
│ ├── Tests.m
│ └── en.lproj
│ └── InfoPlist.strings
├── LICENSE
├── MyLib
│ ├── Assets
│ └── Classes ## 把你的庫代碼放在這個Classes文件夾 !??!##
│ ├── MyLib.h
│ └── UIColor+Category
│ ├── UIColor+Fetch.h
│ └── UIColor+Fetch.m
├── MyLib.podspec
├── RE.md
├── README.md
└── _Pods.xcodeproj -> Example/Pods/Pods.xcodeproj
3.開發(fā)模式下測試pod庫的代碼(可以略過這個步驟)
打開Example工程目錄Podfile文件:
pod 'MyLib', :path => '../' # 指定路徑
#pod 'MyLib', :podspec => '../MyLib.podspec' # 指定podspec文件
然后在Example工程目錄下執(zhí)行 pod update
命令安裝依賴,打開項目工程,可以看到庫文件都被加載到Pods子項目中了不過它們并沒有在Pods目錄下,而是跟測試項目一樣存在于Development Pods/MyLib中,這是因為我們是在本地測試,而沒有把podspec文件添加到Spec Repo中的緣故。測試庫文件沒有問題,接著我們需要執(zhí)行第4步
4.提交Pod庫到Git倉庫2在Terminal
中執(zhí)行 cd進入MyLib項目根目錄然后,執(zhí)行以下命令:
$ git add .
$ git commit -s -m "初始化MyLib 庫"
$ git remote add origin git@git.coding.net:kensla/MyLib.git #添加遠端倉庫
$ git push origin master #提交到遠端倉庫
$ git tag -m "first release" "0.1.0" #打上標簽,這個很重要
$ git push --tags #推送tag到遠端倉庫
到這里,成功提交到遠程 Git倉庫2,MyLib Pod 庫就初步完成了代碼實現(xiàn)
三、創(chuàng)建并提交MyLib
Pod庫的podspec文件到私有Spec Repo倉庫
1.配置MyLibPod庫的podspec 文件
#
# Be sure to run `pod lib lint MyLib.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 http://guides.cocoapods.org/syntax/podspec.html
#
Pod::Spec.new do |s|
#名稱
s.name = 'MyLib'
#版本號
s.version = '0.1.0'
#簡介
s.summary = '這個是我的私有庫項目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
這個是教程的 私有庫項目 學習Demo.
DESC
#主頁,這里要填寫可以訪問到的地址,不然驗證不通過
s.homepage = 'https://coding.net/u/kensla'
# s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
#開源協(xié)議
s.license = { :type => 'MIT', :file => 'LICENSE' }
#作者
s.author = { 'kensla' => '604217454@qq.com' }
#項目地址,這里不支持ssh的地址,驗證不通過,只支持HTTP和HTTPS,最好使用HTTPS。
#這里的s.source須指向存放源代碼的鏈接地址,而不是托管spec文件的repo地址
s.source = { :git => 'https://git.coding.net/kensla/MyLib.git', :tag => "0.1.0" }
#s.social_media_url = 'http://weibo.com/kensla'
#支持的平臺及版本
s.ios.deployment_target = '7.0'
#代碼源文件地址,**/*表示Classes目錄及其子目錄下所有文件,如果有多個目錄下則
#用逗號分開,如果需要在項目中分組顯示,這里也要做相應的設置
s.source_files = "MyLib/Classes/**/*"
#資源文件地址
# s.resource_bundles = {
# 'MyLib' => ['MyLib/Assets/*.png']
# }
#公開頭文件地址
#s.public_header_files = 'MyLib/Classes/DDCommonBase.h'
#所需的framework,多個用逗號隔開
s.frameworks = 'UIKit'
#依賴關系,該項目所依賴的其他庫,如果有多個需要填寫多個s.dependency
# s.dependency 'AFNetworking', '~> 2.3'
end
打開MyLib工程目錄下的MyLib.podspec文件并參考上面的說明配置好相關選項。podspec更多配置請參考:官方文檔
2.編輯完MyLib.podspec文件后,需要驗證一下這個MyLib.podspec文件是否可用
在Terminal中執(zhí)行cd進入MyLib項目根目錄然后,執(zhí)行以下命令:
$ pod lib lint
當你看到 Terminal 中輸出:
-> MyLib (0.1.0)
MyLib passed validation.
表示這個MyLib.podspec 驗證通過,是一個符合CocoaPods規(guī)則的配置文件。
3.本地測試MyLib.podspec文件(可以略過這個步驟)
打開Example工程目錄Podfile文件修改下pod 的引用
#pod 'MyLib', :path => '../' # 指定路徑
pod 'MyLib', :podspec => '../MyLib.podspec' # 指定podspec文件
然后在Example工程目錄下執(zhí)行pod update命令安裝依賴,打開項目工程,現(xiàn)在可以看到庫文件都被加載到Pods子項目中了
4.向Spec Repo提交podspec測試庫文件沒有問題我們就把MyLib.podspec提交到遠程Spec Repo倉庫中,就是本文開頭說的Git倉庫1在Terminal中執(zhí)行 cd進入MyLib項目根目錄然后,執(zhí)行以下命令:
# pod repo push [Repo名] [podspec 文件名字]
$ pod repo push MySpecs MyLib.podspec
如果提交成功,在Terminal會輸出:
Validating spec
-> MyLib (0.1.0)
Updating the `MySpecs' repo
Already up-to-date.
Adding the spec to the `MySpecs' repo
- [No change] MyLib (0.1.0)
Pushing the `MySpecs' repo
Username for 'https://git.coding.net': kensla
Password for 'https://kensla@git.coding.net':
To https://git.coding.net/kensla/MySpecs.git
59b080c..b44123d master -> master
表示提交成功了!這個組件庫就添加到我們的私有Spec Repo中了,可以進入到~/.cocoapods/repos/MySpecs目錄下查看
.
├── MyLib
│ └── 0.1.0
│ └── MyLib.podspec
└── README.md
再去看我們的Spec Repo遠端倉庫 也就是Git倉庫1,也有了一次提交,這個podspec也已經(jīng)被Push上去了。
至此,我們的這個組件庫就已經(jīng)制作添加完成了,使用pod search命令就可以查到我們自己的庫了.在Terminal中執(zhí)行 pod search MyLib
-> MyLib (0.1.0)
這個是我的私有庫項目Demo.
pod 'MyLib', '~> 0.1.0'
- Homepage: https://coding.net/u/kensla
- Source: https://git.coding.net/kensla/MyLib.git
- Versions: 0.1.0 [MySpecs repo]
四、使用制作好的Pod
在完成這一系列步驟之后,我們就可以在正式項目中使用這個私有的Pod了只需要在項目的Podfile里增加以下一行代碼即可,
在正式項目的Podfile 里添加私有Spec Repo
#私有Spec Repo
source 'https://git.coding.net/kensla/DDSpecs.git'
pod 'MyLib', '~> 0.1.0'
然后執(zhí)行pod update,更新庫依賴,然后打開項目可以看到,我們自己的庫文件已經(jīng)出現(xiàn)在Pods子項目中的Pods子目錄下了,而不再是Development Pods。
聲明:本文取自 http://www.itdecent.cn/p/107cc74847ab,http://www.cnblogs.com/baitongtong/p/6681554.html
下面是在制作過程中遇到的問題:
以把支付寶SDK做成私有庫為例,.podspec關于第三方.framework(vendored_frameworks) 、系統(tǒng).framework 、.bundle 文件 、系統(tǒng). libraries、第三方.libraries(vendored_libraries)等 的寫法
cocoapods官方文檔:
https://guides.cocoapods.org/syntax/podspec.html
工程目錄:

.podspec寫法:

注意根據(jù)支付寶官方文檔添加系統(tǒng) .framework . libraries,就是這一部分:
