Cocoapods創建開源庫

使用Cocoapods來管理一個自己的私有庫,在做項目的時候,可以方便我們自己管理和使用。想象一下,如果你的代碼庫在多個項目中使用,其中一個文件更新,你需要在多少個項目中修改文件?而使用Cocoapods只需pod update一下。。。

下面介紹一下創建私有庫的詳細過程。

1、注冊Trunk

trunk需要CocoaPods 0.33版本以上,用

pod --version

命令查看版本

如果版本低,需要升級:

sudo gen install cocoapods

pod setup

查看自己是否注冊過Trunk

pod trunk me

沒有注冊過會提示:You need to register a session first.

注冊

// 加上--verbose可以輸出詳細debug信息,方便出錯時查看。

pod trunk register xxxxx@163.com "name" --verbose

"name" 里面代表你的用戶名,最好起一個好的名字

xxxxx@163.com 代表你的郵箱

注冊完成之后會給你的郵箱發個郵件,進入郵箱郵件里面有個鏈接,需要點擊確認一下

確認結果:

image

注冊成功后可以再查看一下個人信息

pod trunk me


截圖1.png

2、創建一個項目,添加到sourcetree創建本地倉庫

image

3、創建.podspec

cd 到你的項目下

// 注 SYCommonTool 這個是你框架的名稱

1、pod spec create SYCommonTool
截圖2.png

編輯.podspec文件

Pod::Spec.new do |spec|

spec.name = "SYCommonTool"

spec.version = "0.0.1"

spec.summary = "A just test demo"

spec.description = <<-DESC

創建項目中常用組件的集合,不斷更新

DESC

注意: description不能太短

spec.homepage = "[https://github.com/lisiyuan1993/SYCommonTool](https://github.com/lisiyuan1993/SYCommonTool)"

spec.license = "MIT"

# spec.license = { :type => "MIT", :file => "FILE_LICENSE" }

spec.author = { "lisiyuan" => "184275267@qq.com" }

spec.platform = :ios, "8.0"

spec.source = { :git => "[https://github.com/lisiyuan1993/SYCommonTool](https://github.com/lisiyuan1993/SYCommonTool).git", :tag => "#{spec.version}" }

spec.source_files = "SYCommonTool/**/*.{h,m}"

source_files: 寫法

'SYCommonTool/*' '*'表示匹配所有文件

'SYCommonTool/SYCommonTool/*.{h,m}' '*.{h,m}' 表示匹配所有以.h和.m結尾的文件

'SYCommonTool/**/*.h' '**' 表示匹配所有子目錄

注意--常常遇到這個報錯:file patterns: The `source_files` pattern did not match any file.

這個錯誤也是使用指令pod lib lint SYCommonTool.podspec檢查文件是否合法時發生的;

這個是在指定共享的類庫時, 文件路徑不對, 也就是設置s.source_files字段時, 發生了錯誤, 這里的路徑是相對于SYCommonTool.podspec文件的, 如果是與SYCommonTool.podspec同級的文件夾, 直接寫文件夾名稱即可, 如:

s.source_files = "SYCommonTool"

如果有多級目錄, 一定要逐級-逐級-逐級添加. 這里也可以這么寫:

s.source_files = "SYCommonTool/**/*.{h,m}"

spec.exclude_files = "Classes/Exclude"

end

4、如果前面沒有選擇創建這個LICENSE文件, 創建LICENSE(許可證/授權)文件,此文件必須要有

創建一個文件名字命名為LICENSE,內容為:只需要把前面的版權改一下就行了,后面的都一樣

Copyright (c) 2019 nuckyLee

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all

copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

SOFTWARE.

5、上傳到Git

將包含配置好的 .podspec, LICENSE 的項目提交 Git

6、打tag

查看所有的tag

$ git tag

git tag 0.0.1 添加一個tag

將0.0.1標簽提交到git服務器

$ git push origin 0.0.1

添加新的release版本

$ git add . && git commit -m 'Release 0.0.1'

將本地所有標簽一次性提交到git服務器

$ git push origin –tags

$ git push --tags

如果我們的tag打錯了,沒有用的話,我們應該怎么刪除呢?
1、查看tags

git tag 就會羅列出我們所有的tags

2、刪除本地tags

git tag -d tagName

3、刪除遠程分支

git push origin :refs/tags/分支名稱(如:0.0.1) 就刪除了遠程分支

我之前沒有執行如下兩條set命令也push成功,但這一次一直不成功(提示"The source_filespattern did not match any file."錯誤),于是在網上有人說到要執行如下兩條命令,果然成功了,因為當時我的文件路徑(本地和網絡git上),確定是沒有錯的。

set the new version to 1.0.0

set the new tag to 1.0.0 (1.0.0要與podspec的version對應)

這兩條命令是為pod添加版本號并打上tag。然后執行pod驗證命令:

$ pod lib lint

這里要注意一點,有時你寫的podspec文件在后面push的時候會提示[iOS] file patterns: Thesource_filespattern did not match any fi錯誤,網上很多人都說是路徑不對!其實在確認你的路徑沒問題的情況下還報這個錯,那就git 對應的tag下根本沒有對應的podspec文件;
你進入到git 主頁,按下圖的方式點擊對應的tag
進入對應的tag后,你后發現根本沒有任何文件,所以肯定不會成功;

image

7、上傳代碼到Cocoapods

以上全部完成后, 最后一步就是上傳代碼到Cocoapods了;

首先, 使用下面的指令來檢查文件是否可用:

pod spec lint
出現錯誤: - ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code. You can use `--verbose` for more information.

- ERROR | xcodebuild: ....

- error: include of non-modular header inside framework module '' [-Werror,-Wnon-modular-include-in-framework-module]

...

原因就是我的庫的某個頭文件中直接import了第三方庫(我對它有依賴)的頭文件,我修改了spec.frameworks = "Foundation", "UIKit"解決。

如果沒有錯誤, 會輸出:

截圖3.png

最后就是上傳代碼了, 使用下面的指令進行上傳:

pod trunk push SYCommonTool.podspec

上傳的時間可能會有點長, 耐心等待, 成功后會輸出:

截圖4.png

8.測試自己的cocoapods

這個時候使用pod search搜索的話會提示搜索不到,可以執行以下命令更新本地search_index.json文件

rm ~/Library/Caches/CocoaPods/search_index.json

然后

pod search SYCommonTool

該命令會重新創建search_index.json文件,5-10分鐘,耐性等待

截圖5.png

!!!

不管你的spec版本是否已經發布過一版還是第一次發布,在你改了項目里面的代碼后你都必須像更新git代碼一樣先更新tag,只不過命令不同,具體如下:

1、進入到工程有podspec文件的目錄

2、git tag 0.0.1 添加一個tag

3、git add . && git commit -m 'Release 0.0.1' 添加新的release版本

4、git push --tags 在github上添加tag并更新內容

5、git push origin master 更新git、podspec中的version和tag

6、提交到cocopods:

pod trunk push pod search SYCommonTool.podspec

參考:

[Cocoapods]使用Cocoapods + Github托管代碼[http://www.lxweimin.com/p/a72a529dc659]

截圖5.png

(http://www.lxweimin.com/p/a72a529dc659)

手把手教你發布自己的cocoapods開源庫http://www.lxweimin.com/p/3a365f273439

[Cocoapods]項目添加Cocoapods支持遇到的坑http://www.lxweimin.com/p/283584683b0b

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,565評論 6 539
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,115評論 3 423
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,577評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,514評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,234評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,621評論 1 326
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,641評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,822評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,380評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,128評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,319評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,879評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,548評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,970評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,229評論 1 291
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,048評論 3 397
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,285評論 2 376

推薦閱讀更多精彩內容