在GitHub上搭建框架podspec過程以及遇到的問題

2017-10-31更新-------------------------------
給podspec添加第三方庫(kù)依賴的時(shí)候,需要判斷是否包含了第三方庫(kù)文件拍冠,否則會(huì)報(bào)錯(cuò)尿这,podspec校驗(yàn)不通過,如需要添加第三方庫(kù)依賴為:

s.dependency "HYTool", "~> 0.0.3"

則代碼中需要加入 __has_include 的判斷

#if __has_include(<HYTool/HYPathTool.h>)
#import <HYTool/HYPathTool.h>
#else
#import "HYPathTool.h"
#endif

這篇文章記錄了自己在GitHub上搭建框架podspec過程以及遇到的問題

總的來說可以分為5步驟

一庆杜、在GitHub上和電腦本地搭建項(xiàng)目

二妻味、配置.podspec文件

三、上傳本地項(xiàng)目文件到GitHub

四欣福、配置tag并驗(yàn)證podspec文件

五责球、發(fā)布框架

具體過程如下:

一、在GitHub上和電腦本地搭建項(xiàng)目

這一步主要就是把GitHub的項(xiàng)目和本地的項(xiàng)目關(guān)聯(lián)起來

1拓劝、在GitHub上新建一個(gè)項(xiàng)目倉(cāng)庫(kù)(只有LICENSE和README.md兩個(gè)文件)
2雏逾、把GitHub項(xiàng)目clone到電腦本地
3、在該文件目錄下新建項(xiàng)目或者導(dǎo)入已經(jīng)存在的項(xiàng)目郑临,并搭建項(xiàng)目文件結(jié)構(gòu)
4栖博、在該項(xiàng)目目錄下,即LICENSE或者README.md文件的同一級(jí)目錄新建一個(gè)同名的文件夾厢洞,用來存放相關(guān)的文件仇让,也是用于后續(xù)的pod文件路徑

文件目錄結(jié)構(gòu)大致如下(不是固定的,可以參考GitHub上開源框架的文件結(jié)構(gòu)躺翻,如AFNetworking)

- HYTransitionAnimation 
    - HYTransitionAnimation (用來放置框架文件丧叽,別人pod就是這個(gè)文件下的內(nèi)容)
    - HYTransitionAnimationDemo (演示Demo)
    - HYTransitionAnimation.podspec (podspec的配置文件)
    - LICENSE (證書信息)
    - README.md (使用說明)

二、配置.podspec文件

1公你、創(chuàng)建.podspec文件

命令為:pod spec create 項(xiàng)目名稱
如:pod spec create HYTransitionAnimation

2踊淳、編輯.podspec文件,文本編輯工具都可以陕靠,如Sublime
- version 版本信息迂尝,如0.2.1
- summary 摘要脱茉,如HYTransitionAnimation
- description 描述,如a collection of transition animation
- homepage 框架主頁(yè)垄开,一般都是填框架在GitHub的地址琴许,如https://github.com/oceanfive/HYTransitionAnimation
- license 證書類型,如MIT
- platform 平臺(tái)類型溉躲,如ios, "7.0"
- source 來源位置虚吟,如https://github.com/oceanfive/HYTransitionAnimation.git
- source_files 源文件位置,如HYTransitionAnimation/**/*.{h,m}
- frameworks 需要使用的框架签财,如 UIKit
- requires_arc ARC需要串慰,如true

platform 最好指定一下,否則可能會(huì)發(fā)生一些異常的錯(cuò)誤

以上配置內(nèi)容都創(chuàng)建文件的時(shí)候都有唱蒸,我們做的是根據(jù)需要進(jìn)行修改就好了邦鲫;
這里需要著重說一下source_files填寫的內(nèi)容,本人這里花的時(shí)間最多神汹,這里寫的是相對(duì)文件路徑庆捺,以podspec文件的作為參考標(biāo)準(zhǔn);建議按照HYTransitionAnimation/**/*.{h,m}這種格式填寫,意思是添加HYTransitionAnimation文件下包含子目錄的所有.h和m文件屁魏;

三滔以、上傳本地項(xiàng)目文件到GitHub

內(nèi)容和配置文件都完成之后需要上傳到GitHub才行;工具的話可以使用命令行氓拼,也可以使用sourcetree

四你画、配置tag并驗(yàn)證podspec文件

1、設(shè)置tag

命令:git tag "版本號(hào)"
如:git tag "0.2.1"
注意:tag一般和版本號(hào)相同桃漾,我試驗(yàn)結(jié)果是相同可以驗(yàn)證成功坏匪,不同會(huì)一直驗(yàn)證失敗

2、推送到遠(yuǎn)端

git push --tags

3撬统、驗(yàn)證podspec文件

命令:pod spec lint 框架名稱.podspec --verbose
如:pod spec lint HYTransitionAnimation.podspec --verbose

驗(yàn)證的時(shí)候可能會(huì)出現(xiàn)以下錯(cuò)誤适滓,

[!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a `.swift-version` file to set the version for your Pod. For example to use Swift 2.3, run:
`echo "2.3" > .swift-version`.

解決:在終端執(zhí)行命令 echo "3.0" > .swift-version ,會(huì)生成一個(gè)文件(這是一個(gè)隱藏文件)

注:錯(cuò)誤解決之后需要重新執(zhí)行步驟三恋追、四凭迹,一直到驗(yàn)證成功才行,驗(yàn)證成功后顯示內(nèi)容如下:

HYTransitionAnimation.podspec passed validation.

五苦囱、發(fā)布框架

1嗅绸、注冊(cè)trunk

命令:pod trunk register 郵箱地址 "用戶名稱" --verbose
如:pod trunk register 123456789@qq.com "one" --verbose
這時(shí)候會(huì)有一封郵件發(fā)送到郵箱地址,需要你去驗(yàn)證才行

2沿彭、發(fā)布

命令:pod trunk push 框架名稱.podspec
如:pod trunk push HYTransitionAnimation.podspec

發(fā)布成功時(shí)終端顯示內(nèi)容如下:

?? Congrats

?? HYTransitionAnimation (0.2.0) successfully published
?? August 30th, 01:25
?? https://cocoapods.org/pods/HYTransitionAnimation
?? Tell your friends!


這時(shí)候就可以在其他項(xiàng)目中使用pod導(dǎo)入了

End-----

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末朽砰,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子喉刘,更是在濱河造成了極大的恐慌瞧柔,老刑警劉巖,帶你破解...
    沈念sama閱讀 219,039評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件睦裳,死亡現(xiàn)場(chǎng)離奇詭異造锅,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)廉邑,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,426評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門哥蔚,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人蛛蒙,你說我怎么就攤上這事糙箍。” “怎么了牵祟?”我有些...
    開封第一講書人閱讀 165,417評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵深夯,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我诺苹,道長(zhǎng)咕晋,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,868評(píng)論 1 295
  • 正文 為了忘掉前任收奔,我火速辦了婚禮掌呜,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘坪哄。我一直安慰自己质蕉,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,892評(píng)論 6 392
  • 文/花漫 我一把揭開白布翩肌。 她就那樣靜靜地躺著饰剥,像睡著了一般。 火紅的嫁衣襯著肌膚如雪摧阅。 梳的紋絲不亂的頭發(fā)上汰蓉,一...
    開封第一講書人閱讀 51,692評(píng)論 1 305
  • 那天,我揣著相機(jī)與錄音棒卷,去河邊找鬼顾孽。 笑死,一個(gè)胖子當(dāng)著我的面吹牛比规,可吹牛的內(nèi)容都是我干的若厚。 我是一名探鬼主播,決...
    沈念sama閱讀 40,416評(píng)論 3 419
  • 文/蒼蘭香墨 我猛地睜開眼蜒什,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼测秸!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,326評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤霎冯,失蹤者是張志新(化名)和其女友劉穎铃拇,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體沈撞,經(jīng)...
    沈念sama閱讀 45,782評(píng)論 1 316
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡慷荔,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,957評(píng)論 3 337
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了缠俺。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片显晶。...
    茶點(diǎn)故事閱讀 40,102評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖壹士,靈堂內(nèi)的尸體忽然破棺而出磷雇,到底是詐尸還是另有隱情,我是刑警寧澤躏救,帶...
    沈念sama閱讀 35,790評(píng)論 5 346
  • 正文 年R本政府宣布唯笙,位于F島的核電站,受9級(jí)特大地震影響落剪,放射性物質(zhì)發(fā)生泄漏睁本。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,442評(píng)論 3 331
  • 文/蒙蒙 一忠怖、第九天 我趴在偏房一處隱蔽的房頂上張望呢堰。 院中可真熱鬧,春花似錦凡泣、人聲如沸枉疼。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,996評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)骂维。三九已至,卻和暖如春贺纲,著一層夾襖步出監(jiān)牢的瞬間航闺,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,113評(píng)論 1 272
  • 我被黑心中介騙來泰國(guó)打工猴誊, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留潦刃,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,332評(píng)論 3 373
  • 正文 我出身青樓懈叹,卻偏偏與公主長(zhǎng)得像乖杠,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子澄成,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,044評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容

  • 一肮柜、創(chuàng)建的github倉(cāng)庫(kù)原文地址 1 進(jìn)入Github網(wǎng)站www.github.com登陸自己的賬號(hào)后 2 建立...
    freesan44閱讀 3,932評(píng)論 2 12
  • 項(xiàng)目組件化、平臺(tái)化是技術(shù)公司的共同目標(biāo)凰狞,越來越多的技術(shù)公司推崇使用pod管理第三方庫(kù)以及私有組件,一方面使項(xiàng)目架構(gòu)...
    swu_luo閱讀 21,782評(píng)論 0 39
  • 網(wǎng)上將自己的項(xiàng)目做成Pod 的文檔很多菲饼,但是有些文檔已經(jīng)很老了,不適合新手上手汛兜,經(jīng)過這兩天的研究我決定還是自己寫一...
    黃魚兒啦啦啦閱讀 7,130評(píng)論 10 17
  • Ruby 安裝 要安裝cocospods 首先需要安裝ruby巴粪,可以先安裝xcode通今,再安裝macport 粥谬,最后...
    山天大畜閱讀 1,859評(píng)論 0 1
  • 目前比較流行的組件化開發(fā),針對(duì)多個(gè) app 要用同一套代碼辫塌,將其做成 pod 倉(cāng)庫(kù)是比較好的解決方案漏策。代碼只有一份...
    ripperhe閱讀 5,411評(píng)論 8 39