一.前言

• 隨著公司項目的不斷迭代，業務的天馬行空。工程的代碼量和業務邏輯也越來越復雜，原始的開發模式和架構已經無法滿足我們的業務發展速度，想分離出一個模塊更是困難。直到組件化的誕生，這也是我們為什么要擁抱組件化的原因。
  不得不說組件化帶來的優點還有有目共睹的：
  場景 如：
  • 聰明的產品張三有一天說：我們的IM業務日活、留存數據非常好，所以我們想單獨拆出這個業務做個馬甲包。
  • 大廠～項目管理說我們的項目是否做業務之間隔離了沒有。
  • 隨著業務不斷增加，編譯速度和打包速度越來越慢。
  • 大廠～多個業務多人同時開發，等等。
• 哈哈！以上都是題外話，下面開始正文。

組件化分類：
共有庫 - 所有人都能使用。（）。
私有庫 - 公司內部擁有特殊權限才能使用。
framework - 公私都有，動態庫靜態庫。只能看到.h文件。

二.步驟

準備工作：
Github賬號一個（上傳組件工程用的）
安裝CocoaPods（創建并驗證pod用的）
安裝Git 命令行 （首次上傳組件工程用的）
安裝Github Desktop或者SourceTree（后續更新組件用的，Git命令使用熟練者忽略此項）

1.創建共有庫

• 首先在Github創建一個新的Repository。（你的Pods最終是要托管在Github平臺上的，所以先在Github上創建一個空的Repository。）
  
  如：JHIMComponets = IM組件化模塊，這個看個人不強制。
  

  repository.png

• 下圖為創建成功后的樣子

  
  
  JHIMComponets.png

2.注冊Cocoapods賬戶

• 想要創建一個開源pod庫, 首先我們需要注冊CocoaPods，基于Cocoapods已經安裝好的前提下，這里是使用trunk 方式，只需要在終端執行:

pod trunk register 郵箱地址 '用戶名' --verbose

如: pod trunk register xxxxxx@yeah.com 'JadeXH' --verbose

一般會使用GitHub郵箱和用戶名，當然這個可以自由選擇，注冊之后，在郵箱中會收到確認郵件，在瀏覽器中點擊鏈接確認即注冊成功(小編遇到點擊鏈接地址后顯示：Internal server error 提示，不用理他直接驗證)。成功之后可以終端執行:

pod trunk me    //驗證是否注冊成功

查看注冊信息，以后可以使用該開源Pod庫發布工具，也可以通過此方式查看已經發布過的pods:

yourname@Jade-for-MacBook-Pro podTest % pod trunk me
  - Name:     yourname
  - Email:    yourname@yeah.net
  - Since:    March 28th, 02:32
  - Pods:     None
  - Sessions:
    - March 28th, 02:32 - August 4th, 04:13. IP: 124.126.200.29

3.在本地創建pod庫

• 利用pod命令創建了名為JHIMComponets的Pod庫
  

cd yourname@Jade-for-MacBook-Pro downloads % 
# cd到downloads目錄下載，這個不強制請隨意。
yourname@Jade-for-MacBook-Pro downloads % pod lib create JHIMComponets
# 執行 pod lib create JHIMComponets

• 執行完上述命令之后，會問你幾個問題，按需求填寫即可

  
  
  pod create.png

# 你想使用哪個平臺？
1、What platform do you want to use?? [ iOS / macOS ]
iOS
# 庫語言選擇？
2、What language do you want to use?? [ Swift / ObjC ]
ObjC
# 是否需要一個demo工程，用于調試Pod？
3、Would you like include a demo application with your library? [ Yes / No ]
Yes
# 你要使用哪個測試框架？
4、Which testing frameworks will you use? [ Specta / Kiwi / None ]
None
# 是否要UI測試？
5、Would you like to do view based testing? [ Yes / No ]
NO
# 類名前綴？
6、What is your class prefix?
JH

• 到這里pod庫就創建完成了，它會自己打開剛才創建的pod庫。
  目錄結構如下圖：

  
  
  pod.png
• （1）配置podspec
  配置詳解：

Pod::Spec.new do |s| 
  #庫名稱
  s.name             = 'JHIMComponets'
  #版本號
  s.version          = '0.1.0'
  #庫簡短介紹
  s.summary          = 'A short description of JHIMComponets.'
  #開源庫描述 
  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC
  #開源庫地址，或者是博客、社交地址等
  s.homepage         = 'https://github.com/JadeXH/JHIMComponets'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  #開源協議
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  #開源庫作者
  s.author           = { 'yourname' => 'yourname@yeah.net' }
  #源庫資源文件
  s.source           = { :git => 'https://github.com/JadeXH/JHIMComponets.git', :tag => s.version.to_s }
  #社交網址
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
  #開源庫最低支持
  s.ios.deployment_target = '9.0'
  #源庫資源文件
  s.source_files = 'JHIMComponets/Classes/**/*'
  #添加資源文件
  # s.resource_bundles = {
  #   'JHIMComponets' => ['JHIMComponets/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  #依賴的系統庫 多個用逗號隔開
  # s.frameworks = 'UIKit', 'MapKit'
  #引入第三方依賴庫
  # s.dependency 'AFNetworking', '~> 2.3'
end

• 需要注意如圖：

  
  
  podspec.png

• Readme主要是介紹這個組件的用途和使用的，可以隨時編輯。目前就確認一下自己的名字和郵箱就可以了。

  
  
  readme.png

• 協議文件，也是確認一下自己的名字和郵箱就可以了。

  
  
  licence.png
• （2）添加自己的類
  打開pod庫目錄：

new.png

刪除ReplaceMe -> 創建JHIMComponet簡單類，聲明一個打印函數，方便后續測試。

#import "JHIMComponet.h"

@implementation JHIMComponet

- (void)printJHIMComponet {
    NSLog(@"printJHIMComponet*****");
}

@end

• 這時cd進入Example路徑下執行pod install命令，看看是否能將剛剛添加的庫文件引入到工程中

yourname@Jade-for-MacBook-Pro downloads % cd /Users/yourname/Downloads/JHIMComponets/Example
yourname@Jade-for-MacBook-Pro Example % pod install

pods.png

如果成功會在項目組Pods中看到。

4.項目上傳與發布

cd到你的項目路徑下，將項目上傳到Github中（即剛剛創建的JHIMComponets共有庫中）依次使用下列命令行，不要遺漏。

//
yourname@Jade-for-MacBook-Pro Example % cd /Users/yourname/Downloads/JHIMComponets

# 添加github項目路徑
yourname@Jade-for-MacBook-Pro JHIMComponets % git remote add origin https://github.com/JadeXH/JHIMComponets.git
# 添加文件
yourname@Jade-for-MacBook-Pro JHIMComponets % git add .
# 將暫存區里的改動給提交到本地的版本庫
yourname@Jade-for-MacBook-Pro JHIMComponets % git commit -m "first commit"
# 創建分支main
yourname@Jade-for-MacBook-Pro JHIMComponets % git branch -M main
# 提交版本號并push到main分支
yourname@Jade-for-MacBook-Pro JHIMComponets % git push -u origin main

#注意這里的版本號要與.podspec中的版本號保持一致
yourname@Jade-for-MacBook-Pro JHIMComponets % git tag 0.1.0
yourname@Jade-for-MacBook-Pro JHIMComponets % git push origin 0.1.0

在執行git push -u origin main的時候如果遇到需要輸入用戶名和密碼：

Username for 'https://github.com': JadeXH
Password for 'https://JadeXH@github.com': 

這個密碼不是你Github的登錄密碼，而是需要生成一個access tokens。

生成token步驟：需要在Github個人設置頁 -> Settings -> Developer settings -> Personal access tokens 中創建一個token。

settings.png

1.設置token的有效期，訪問權限等
2.選擇要授予此令牌token的范圍或權限。
3.要使用token從命令行訪問倉庫，請選擇repo。
4.要使用token從命令行刪除倉庫，請選擇delete_repo
5.其他根據需要進行勾選

token.png

delete.png

點擊Generate token生成的token（ghp_zR7Zm44QK*************Ui7zikChgv2bxMNZ）。

注意：
記得把你的token保存下來，因為你再次刷新網頁的時候，你已經沒有辦法看到它了。然后把這個token直接粘貼到命令行提示輸入密碼處就ok了。

執行完所有git命令行后打開瀏覽器輸入https://github.com/JadeXH/JHIMComponets就看到你的pod庫已經push上去了。

update.png

5.使用與驗證

• 新建個帶pod的項目，把我們做好的JHIMComponets加入podfile文件。

# Uncomment the next line to define a global platform for your project
 platform :ios, '9.0'

target 'podTest' do
  # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
  # use_frameworks!

  # Pods for podTest
  pod 'JHIMComponets',:git =>"https://github.com/JadeXH/JHIMComponets.git"
  
  
  target 'podTestTests' do
    inherit! :search_paths
    # Pods for testing
  end

  target 'podTestUITests' do
    inherit! :search_paths
    # Pods for testing
  end
end

• 執行pod install

yourname@Jade-for-MacBook-Pro podTest % pod install
Analyzing dependencies
Pre-downloading: `JHIMComponets` from `https://github.com/JadeXH/JHIMComponets.git`
Downloading dependencies
Installing JHIMComponets (0.1.0)
Removing JHComponents
Generating Pods project
Integrating client project
Pod installation complete! There are 9 dependencies from the Podfile and 9 total pods installed.

• 引入頭文件并打印結果

  
  
  import.png

print.png

6.版本更新與維護

• 現在的JHIMComponets庫已經在Github上托管了，以后維護這個項目就可以了（開始本地創建的JHIMComponets項目就可以刪除了），管理Github倉庫，：

• 可以使用命令行 git clone https://github.com/JadeXH/JHIMComponets

• 也可以使用Github Desktop
  下載Github Desktop登錄你的用戶名密碼，File ->Clone Repository

  
  
  Github Desktop.png
  
  

  其實Github Desktop更加可視化一些，上面History就是剛才git命令行的記錄。

  
  
  desk.png

6.總結

• 終于寫完了，哇哦！凌晨了。寫這篇文章初心也是為了加深印象，如果碰巧也能幫到您還請點個贊，制作不易。