手把手教你發(fā)布自己的CocoaPods開(kāi)源庫(kù)
發(fā)布自己的cocoapods開(kāi)源庫(kù)按照以下步驟,良心制作,包教包會(huì)!!
下面我會(huì)通過(guò)一個(gè)名為IFMMenu的項(xiàng)目來(lái)講解一下整個(gè)過(guò)程。
1.寫(xiě)好代碼,上傳到github
github上創(chuàng)建項(xiàng)目倉(cāng)庫(kù)的時(shí)候記得創(chuàng)建LICENSE(許可證/授權(quán))文件,此文件必須要有。
github上創(chuàng)建項(xiàng)目倉(cāng)庫(kù)
2.將自己的項(xiàng)目打成tag
因?yàn)閏ocoapods是依賴(lài)tag版本的,所以必須打tag,以后再次更新只需要把你的項(xiàng)目打一個(gè)tag,然后修改.podspec文件中的版本接著提交到cocoapods官方就可以了,提交命令請(qǐng)看下面
- //為git打tag, ***次需要在前面加一個(gè)v
- git tag "v1.0.0"
- git push --tags
3.注冊(cè)CocoaPods
trunk需要CocoaPods 0.33版本以上,用pod --version命令查看版本,如果版本低,需要升級(jí)。
- pod --version
- //版本低于0.33
- sudo gen install cocoapods
- pod setup
已經(jīng)注冊(cè)過(guò)的不需要注冊(cè),怎么看自己有沒(méi)有注冊(cè)
- pod trunk me
pod trunk me信息
若未注冊(cè),執(zhí)行以下命令,郵箱以及用戶(hù)名請(qǐng)對(duì)號(hào)入座。用戶(hù)名我使用的是Github上的用戶(hù)名。
- // 加上--verbose可以輸出詳細(xì)錯(cuò)誤信息,方便出錯(cuò)時(shí)查看。
- pod trunk register example@example.com 'liugangios' --verbose
注冊(cè)完成之后會(huì)給你的郵箱發(fā)個(gè)郵件,進(jìn)入郵箱郵件里面有個(gè)鏈接,需要點(diǎn)擊確認(rèn)一下。
注冊(cè)完成后使用pod trunk me檢驗(yàn)注冊(cè)是否成功。
4.創(chuàng)建.podspec
cd到你項(xiàng)目的目錄,執(zhí)行命令
- pod spec create IFMMenu
5.編輯.podspec
創(chuàng)建好后,打開(kāi).podspec,刪除注釋, 前面有#的為注釋,也可以用以下代碼替換,然后編輯自己的庫(kù)信息。
- Pod::Spec.new do |s|
- s.name = 'IFMMenu'
- s.version = '1.0.2'
- s.authors = { 'liugangios' => 'example@example.com' }
- s.homepage = 'https://github.com/liugangios/IFMMenu'
- s.summary = 'a dropdown menu for ios like wechat homepage.'
- s.source = { :git => 'https://github.com/liugangios/IFMMenu.git',
- :tag => s.version.to_s }
- s.license = { :type => "MIT", :file => "LICENSE" }
- s.platform = :ios, '7.0'
- s.requires_arc = true
- s.source_files = 'IFMMenu'
- s.public_header_files = 'IFMMenu/*.h'
- s.ios.deployment_target = '7.0'
- end
- s.name:名稱(chēng),pod search搜索的關(guān)鍵詞,注意這里一定要和.podspec的名稱(chēng)一樣,否則報(bào)錯(cuò)
- s.version:版本號(hào),to_s:返回一個(gè)字符串
- s.author:作者
- s.homepage:項(xiàng)目主頁(yè)地址
- s.summary: 項(xiàng)目簡(jiǎn)介
- s.source:項(xiàng)目源碼所在地址
- s.license:許可證
- s.platform:項(xiàng)目支持平臺(tái)
- s.requires_arc: 是否支持ARC
- s.source_files:需要包含的源文件
- s.public_header_files:需要包含的頭文件
- s.ios.deployment_target:支持的pod***版本
其他一些非必要字段
- s.social_media_url:社交網(wǎng)址
- s.resources:資源文件
- s.dependency:依賴(lài)庫(kù),不能依賴(lài)未發(fā)布的庫(kù)
- s.license= { :type => “MIT”, :file => “LICENSE” }
這里建議這樣寫(xiě),如果寫(xiě)別的會(huì)報(bào)警告,導(dǎo)致后面一直提交失敗。
source_files寫(xiě)法及含義
- "IFMMenu/*
- "IFMMenu/IFMMenu/*.{h,m}"
- "IFMMenu/**/*.h"
*表示匹配所有文件
*.{h,m}表示匹配所有以.h和.m結(jié)尾的文件
**表示匹配所有子目錄
s.source常見(jiàn)寫(xiě)法
- s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :commit => "68defea" }
- s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :tag => 1.0.0 }
- s.source = { :git => "https://github.com/liugangios/IFMMenu.git", :tag => s.version }
- commit => "68defea" 表示將這個(gè)Pod版本與Git倉(cāng)庫(kù)中某個(gè)commit綁定
- tag => 1.0.0表示將這個(gè)Pod版本與Git倉(cāng)庫(kù)中某個(gè)版本的comit綁定
- tag => s.version表示將這個(gè)Pod版本與Git倉(cāng)庫(kù)中相同版本的comit綁定
6.驗(yàn)證.podspec
到此檢查一下你工程中有以下文件:
- 你的項(xiàng)目,
- .podspec文件,
- LICENSE文件
項(xiàng)目?jī)?nèi)文件
使用以下命令測(cè)試本地.podspec文件是否存在語(yǔ)法錯(cuò)誤。
- pod spec lint IFMMenu.podspec --verbose
7.發(fā)布
- pod trunk push IFMMenu.podspec
時(shí)間較長(zhǎng),耐性等待,大概5-10分鐘,發(fā)布成功后會(huì)有以下提示
發(fā)布成功截圖
8.測(cè)試自己的cocoapods
這個(gè)時(shí)候使用pod search搜索的話(huà)會(huì)提示搜索不到,可以執(zhí)行以下命令更新本地search_index.json文件
- rm ~/Library/Caches/CocoaPods/search_index.json
然后
- pod search IFMMenu
該命令會(huì)重新創(chuàng)建search_index.json文件,5-10分鐘,耐性等待
搜索結(jié)果
完整命令
- git tag "v1.0.0"
- git push --tags
- pod trunk register example@example.com 'liugangios' --verbose
- pod trunk me
- pod spec create IFMMenu
- //編輯 IFMMenu.podspec
- pod spec lint IFMMenu.podspec
- pod trunk push IFMMenu.podspec
- rm ~/Library/Caches/CocoaPods/search_index.json
- pod search IFMMenu
報(bào)錯(cuò)處理
- [!] Unable to accept duplicate entry for: XXXXX (1.0.0)
意思是:不能接受同一版本的提交
解決方案:
1、執(zhí)行如下命令
- git tag 1.0.1
- git push --tags
2、修改XXXX.podspec文件中的內(nèi)容
- s.version = "1.0.1"
- s.source = { :Git => "https://github.com/xxx/xxx.git", :tag => "1.0.1" }
3、執(zhí)行命令pod spec lint、pod trunk push 庫(kù)名.podspec驗(yàn)證并提交到CocoPods
***
IFMMenu是一個(gè)仿微信首頁(yè)添加菜單的多功能、多種屬性可自定義的下拉菜單,歡迎download下載提意見(jiàn),star,感謝閱讀。