CocoaPods發佈SDK

引言

年前升級基礎組件的時候發現百度地圖、友盟等均可以使用CocoaPods自動配置.framework形式開發包了。 那叫一個爽啊！ 最近接到將公司App產品的基礎組件以SDK的方式開放出去供合做方調用的需求。我在第一時間想到了使用CocoaPods發佈SDK，在實施過程當中仍是遇到了一些小坑好在最終都解決了。 但願這篇文章能幫助到有一樣需求的你。

準備須要共享的.framework靜態庫文件

靜態庫項目編譯後分別輸出了真機和模擬器的庫文件，我寫了個簡單的腳本在編譯後自動合併真機和模擬器庫文件。 在build phase中添加runscript。腳本以下: # define output folder environment variable UNIVERSAL_OUTPUTFOLDER={CONFIGURATION}-universal

# make sure the output directory exists
mkdir -p "${UNIVERSAL_OUTPUTFOLDER}"

# touch. copy the RKBluetoothLE_iOS.framework. Just for convenience
cp -R "${BUILD_DIR}/${CONFIGURATION}-iphoneos/RKBluetoothLE_iOS.framework" "${UNIVERSAL_OUTPUTFOLDER}/"

# Create universal binary file using lipo
lipo -create -output "${UNIVERSAL_OUTPUTFOLDER}/RKBluetoothLE_iOS.framework/RKBluetoothLE_iOS" "${BUILD_DIR}/${CONFIGURATION}-iphoneos/RKBluetoothLE_iOS.framework/RKBluetoothLE_iOS" "${BUILD_DIR}/${CONFIGURATION}-iphonesimulator/RKBluetoothLE_iOS.framework/RKBluetoothLE_iOS"
複製代碼

cmd+B，搞定。 在products/Debug-universal文件夾中找到生成的通用庫。

用lipo查看. framework庫所支持的架構。

lipo -info RKBluetoothLE_iOS
Architectures in the fat file: RKBluetoothLE_iOS are: x86_64 armv7 arm64 
複製代碼

使用CocoaPods 管理.framework靜態庫文件

建立SDK項目

CocoaPods提供了pod lib create命令建立庫項目

zhijianuandeMBP:~ YuanZhiJian$ pod lib create 'RKBluetoothLEKit'
Cloning `https://github.com/CocoaPods/pod-template.git` into `RKBluetoothLEKit`.
Configuring RKBluetoothLEKit 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

Would you like to include a demo application with your library? [ Yes / No ]
 > Yes

Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > None

Would you like to do view based testing? [ Yes / No ]
 > No

What is your class prefix?
 > RK
複製代碼

將上面生成的RKBluetoothLE_iOS. framework拷貝到生成的RKBluetoothLEKit 庫項目的RKBluetoothLEKit目錄下

編輯庫的Spec描述文件RKBluetoothLEKit.podspec

Pod::Spec.new do |s|
  s.name             = "RKBluetoothLEKit"
  s.version          = "0.1.0"
  s.summary          = "車精靈中控藍牙SDK"
  s.description      = <<-DESC
車精靈中控藍牙SDK,提供車輛操控、個性化、自檢等功能。API調用模式使用了RAC
                       DESC

  s.homepage         = "https://github.com/yuanzj/RKBluetoothLEKit"
  # s.screenshots     = "www.example.com/screenshots_1", "www.example.com/screenshots_2"
  s.license          = 'MIT'
  s.author           = { "yuanzj" => "jswxyzj@qq.com" }
  s.source           = { :git => "https://github.com/yuanzj/RKBluetoothLEKit.git", :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'
  s.platform     = :ios, '8.0'
  s.requires_arc = true

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

  # s.public_header_files = 'Pod/Classes/**/*.h'
  s.frameworks = 'Foundation', 'CoreBluetooth'
  s.dependency 'ReactiveCocoa', '~> 4.1.0'
  s.dependency 'CocoaSecurity', '~> 1.2.4'
  s.vendored_frameworks = 'RKBluetoothLEKit/*.{framework}'
  
end
複製代碼

上面最重要的是

s.vendored_frameworks = 'RKBluetoothLEKit/*.{framework}'
複製代碼

表示pod庫項目依賴本身的framework

推送SDK項目到GitHub倉庫

pod lib create命令建立的項目已經自動使用git版本管理使用下面的命令將項目推送到GitHub倉庫

git remote add origin https://github.com/yuanzj/RKBluetoothLEKit.git //鏈接遠程倉庫並建了一個名叫：origin的別名
git push -u origin master //將本地倉庫的東西提交到地址是origin的地址，master分支下###發佈SDK到CocoaPods
複製代碼

建立Spec描述文件RKBluetoothLEKit.podspec中指定的版本tag並推送到GitHub倉庫

git tag -a 0.1.0 -m "first release"
git push origin --tags
複製代碼

發佈SDK項目到CocoaPods

註冊帳號

在開始提交項目到CocoaPods以前，須要咱們先搞一個帳號：

pod trunk register jswxyzj@qq.com 'yuanzj' --description='My own computer'
複製代碼

執行上面命令後須要去上面填寫的註冊郵箱中進行驗證，驗證後能夠使用pod trunk me來查看是否"註冊"成功。

zhijianuandeMBP:RKBluetoothLEKit YuanZhiJian$ pod trunk me
  - Name:     jswxyzj
  - Email:    jswxyzj@qq.com
  - Since:    March 7th, 19:30
  - Pods:
    - RKBluetoothLEKit
  - Sessions:
    - March 7th, 19:30 -      July 14th, 01:18. IP: 49.80.216.112
    - May 7th, 00:32   - September 12th, 01:03. IP: 60.250.10.247
    Description: My office computer
    - May 7th, 07:16   - September 13th, 07:17. IP: 203.69.59.198
    Description: My own computer
複製代碼

OK，接下來就能夠發佈SDK到CocoaPods了

驗證.podspec文件

首先須要驗證你的代碼是否有錯以及Podspec文件，那麼這個時候下面這條命令就起到很是大的做用了：

pod lib lint RKBluetoothLEKit.podspec
複製代碼

這條命令是用來驗證你的Podspec文件是否有問題，而且代碼裏面是否有問題命令。建議這條命令後面跟着--verbose的參數。 --allow-warnings 是否容許警告，在用到第三方框架的時候，有的時候是自帶會有warmings的代碼，用這參數能夠屏蔽警告。這個參數強烈但願你們加上。

上傳

終於到達上傳的時間了，運行命令:

pod trunk push RKBluetoothLEKit.podspec  
複製代碼

遇到第三方庫的告警致使終止添加--allow-warnings便可如：

pod trunk push RKBluetoothLEKit.podspec --verbose  --allow-warnings
複製代碼

只要經過上述命令便可上傳項目到Cocoapods官方的倉庫裏去，固然若是你有新的tag版本的話也是經過該命令進行上傳新的版本到Cocoapods的。而咱們能夠經過pod search 名字來查詢是否上傳成功。

-> RKBluetoothLEKit (0.1.0)
   車精靈中控藍牙SDK
   pod 'RKBluetoothLEKit', '~> 0.1.0'
Homepage: https://github.com/yuanzj/RKBluetoothLEKit
Source:   https://github.com/yuanzj/RKBluetoothLEKit.git
Versions: 0.1.0 [master repo]
複製代碼

尾巴

最後在集成了RKBluetoothLEKit庫使用的時候發現可以編譯和運行經過就是在代碼中導入頭文件的地方會提示 「could not build module ‘XXX’」
一開始覺得RKBluetoothLEKit.podspec 文件編寫有問題google 了不少地方嘗試了不少方法結果都沒有效果。

這個問題最近終於完全完美解決了 把target 下 Build Settings 中 Allow Non-modular includes in Framework Modules 選項卡設爲yes

在實施過程了查閱了不少資料在這裏表示由衷的感謝

How to Use a Third Party Framework in a Private CocoaPod

Cocoapods系列教程(三)——私有庫管理和模塊化管理

使用CocoaPods開發並打包靜態庫