CocoaPods 創(chuàng)建私有庫

一、創(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

工程目錄:

![Uploading 9B4E15E7-4CB5-4CD9-8478-054693AD88A7_557465.png . . .]

.podspec寫法:

9B4E15E7-4CB5-4CD9-8478-054693AD88A7.png

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


B2373366-54CE-4C00-8D8B-FEB7AA42646F.png
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容