如何製做一個CocoaPods私有庫

最近在學習組件化相關的知識，也準備寫個項目練練手。iOS組件化的實現是利用CocoaPods製做Pod庫，主工程分別引用這些Pod庫。最終想要達到的目標是主工程只是一個殼工程，其它代碼都在組件Pod裏，主工程只負責加載這些組件，沒有其它任何代碼。

這篇文章做爲組件化開發的前置文章總結一下如何製做一個CocoaPods私有庫。

下面經過一個例子來說解整個步驟流程。

一、打開終端，進入到要創建私有庫工程的目錄，執行pod lib create MMUtils，MMUtils爲項目名

這裏會詢問幾個問題，答案根據實際狀況具體設置

命令執行完成後會建立一個私有庫工程。

二、建立私有庫Git地址，這裏以GitHub爲例

MyGitHubModule是我本身建立的一個Organization，爲了方便組件的統一管理。

三、修改配置文件MMUtils.podspec

#
# Be sure to run `pod lib lint MMUtils.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             = 'MMUtils'
  s.version          = '0.0.1'
  s.summary          = 'MMUtils is some utils for My Project.'

# 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/MyGitHubModule/MMUtils'
  # s.screenshots = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'anotherchase@gmail.com' => 'AnotherChase@gmail.com' }
  s.source           = { :git => 'https://github.com/MyGitHubModule/MMUtils.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'

  s.source_files = 'MMUtils/Classes/**/*'
  
  # s.resource_bundles = {
  # 'MMUtils' => ['MMUtils/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  # s.frameworks = 'UIKit', 'MapKit'
  s.dependency 'Reachability', '~> 3.2'
  s.dependency 'ReactiveCocoa', '~> 2.5'
end
複製代碼

podspec文件的詳細說明能夠看Podspec Syntax Reference。

四、打開終端，進入Example文件夾，執行pod install，安裝依賴項

五、添加庫的源碼文件

將源碼文件放入MMUtils/Classes文件下，與podspec文件中的配置要保持一致。這裏我是放入了一個監聽網絡狀態變化的工具類。

運行pod install，讓工程加載新添加的類。這裏須要注意的是，只要新增長類、資源文件或依賴的第三方庫都須要從新運行pod install來進行更新。

六、添加測試代碼，運行工程測試

在MMViewController中添加測試代碼

#import "MMViewController.h"
#import <MMUtils/MMReachabilityHelper.h>
#import <ReactiveCocoa/ReactiveCocoa.h>

@interface MMViewController ()

@property (nonatomic, strong) UILabel *statusLabel;

@end

@implementation MMViewController

- (void)viewDidLoad
{
    [super viewDidLoad];
	// Do any additional setup after loading the view, typically from a nib.
    self.statusLabel = [[UILabel alloc] initWithFrame:CGRectMake(([UIScreen mainScreen].bounds.size.width - 100) / 2.0, 100, 100, 100)];
    self.statusLabel.textAlignment = NSTextAlignmentCenter;
    [self.view addSubview:self.statusLabel];
    
    RAC(self.statusLabel, text) = [RACObserve(ReachabilityHelper, networkStatus) map:^(NSNumber *networkStatus) {
        return networkStatus.integerValue == NotReachable ? @"無網絡" : @"有網絡";
    }];
}

- (void)didReceiveMemoryWarning
{
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}
複製代碼

運行工程測試，切換網絡狀態，能夠看到label文字的變化。

七、運行pod lib lint MMUtils.podspec驗證私有庫正確性

若是出現

[!] MMUtils did not pass validation, due to 15 warnings (but you can use `--allow-warnings` to ignore them).
You can use the `--no-clean` option to inspect any issue.
複製代碼

能夠運行pod lib lint MMUtils.podspec --allow-warnings來忽略警告。

八、提交源碼到GitHub，並打tag

在項目工程文件下運行如下命令：

# chenjb @ chenjbdeMBP in ~/Desktop/MyGitHubModule/MMUtils on git:master x [20:41:30] 
$ git remote add origin https://github.com/MyGitHubModule/MMUtils.git

# chenjb @ chenjbdeMBP in ~/Desktop/MyGitHubModule/MMUtils on git:master x [21:01:06] 
$ git add .

# chenjb @ chenjbdeMBP in ~/Desktop/MyGitHubModule/MMUtils on git:master x [21:01:17] 
$ git commit -a -m "0.0.1"

# chenjb @ chenjbdeMBP in ~/Desktop/MyGitHubModule/MMUtils on git:master o [21:01:24] 
$ git pull origin master

# chenjb @ chenjbdeMBP in ~/Desktop/MyGitHubModule/MMUtils on git:master o [21:01:38] C:1
$ git push origin master

# chenjb @ chenjbdeMBP in ~/Desktop/MyGitHubModule/MMUtils on git:master o [21:01:59] 
$ git tag 0.0.1

# chenjb @ chenjbdeMBP in ~/Desktop/MyGitHubModule/MMUtils on git:master o [21:02:08] 
$ git push origin 0.0.1
複製代碼

運行完成後，能夠去GitHub上對咱們的提交進行查看。

九、發佈私有庫

對於開源庫，podspec文件是放在CocoaPods的Specs項目下的。

由於咱們建立的是私有庫，因此咱們須要建立本身的Specs管理庫。

建立一個Git庫命名爲MMSpecs，建立過程和第二步同樣。

打開終端，運行

$ pod repo add MMSpecs https://github.com/MyGitHubModule/MMSpecs.git
複製代碼

執行成功後，能夠看到在本地生成了MMSpecs目錄。

運行

# chenjb @ chenjbdeMBP in ~/Desktop/MyGitHubModule/MMUtils on git:master o [21:58:28] 
$ pod repo push MMSpecs MMUtils.podspec 
複製代碼

進行發佈。

若是沒經過，能夠試試pod repo push MMSpecs MMUtils.podspec --allow-warnings忽略警告。

成功以後能夠在GitHub上對MMSpecs進行查看。

十、在本身項目中引用私有庫

Podfile以下：

source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/MyGitHubModule/MMSpecs.git'
platform :ios, ‘8.0’

target 「TestTest」 do
pod 'MMUtils', '~> 0.0.1’ end 複製代碼

這裏很尷尬，發現開源庫中也有個同名的庫。

修改Podfile爲：

source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/MyGitHubModule/MMSpecs.git'
platform :ios, ‘8.0’

target 「TestTest」 do
pod 'MMUtils', :git => 'https://github.com/MyGitHubModule/MMUtils.git', :tag => '0.0.1'
end
複製代碼

讀者朋友這個操做就不要學了。

具體步驟流程就是這樣了，這是我2018年的第一篇博客，但願本身在2018年接下來的日子裏也能繼續努力。你們共勉。

本文示例代碼下載：MMUtils

參考連接

• www.cnblogs.com/wsyuzx/p/70…
• www.cnblogs.com/brycezhang/…
• www.jianshu.com/p/760d6cd46…