后臺(tái)搞重構(gòu),特么接口變了不少,之前的不少接口有變化,改的煩死了。改完覺(jué)得這樣不行啊尼瑪,原先afn只封裝了一層,然后參考了下github上的開(kāi)源庫(kù),對(duì)封裝進(jìn)行了修改,后面打算抽時(shí)間再在自己項(xiàng)目里再封裝一層。想著改都改了干脆做成自己的SDK,以后有新項(xiàng)目也可以用,方便移植。
昨天搞了大半天上傳SDK的事情,記錄一下。先文字,圖后面再上傳SDK的時(shí)候再截。
首先肯定是要在GitHub上注冊(cè)一個(gè)賬號(hào)并登陸,首頁(yè)右上角點(diǎn)擊“+”創(chuàng)建一個(gè) New repository,跳轉(zhuǎn)到創(chuàng)建設(shè)置界面,name一般與sdk項(xiàng)目相同,description就是簡(jiǎn)介,因?yàn)槭亲鳛閟dk,所以選擇Public,點(diǎn)選README,也可以在這里直接選add.gitgnore和add license,不過(guò)我看的教程是用終端創(chuàng)建的,下文會(huì)提到,下次試試。
點(diǎn)綠色的Create repository完成工程創(chuàng)建.創(chuàng)建工程。跳轉(zhuǎn)到了自己的工程頁(yè)面后,點(diǎn)擊Clone,將帶隱藏的.git文件的同名工程文件夾下載到本地,假設(shè)該目錄為a。假設(shè)我們已經(jīng)寫(xiě)好了SDK并放在了一個(gè)文件夾里名叫SDK,那我們?cè)趧偛畔螺d的目錄下創(chuàng)建工程,名叫SDK-demo,用于演示SDK使用;在工程同級(jí)放一個(gè)SDK文件夾,用于提供給cocoapods。這樣能使我們的工程結(jié)構(gòu)清晰明了。
將工程上傳到GitHub。可以用終端也可以用GitHubDesktop對(duì)工程進(jìn)行管理。個(gè)人習(xí)慣用終端.
cd到a。
git add -A
git commit -m 'sdk'
git push origin master注冊(cè)一個(gè)cocoapods賬號(hào)。直接在終端輸入 pod trunk me 查看自己的賬號(hào)信息,未注冊(cè)則輸入pod trunk register 按照提示輸入賬號(hào)密碼注冊(cè),注意這里要在對(duì)應(yīng)郵箱中打開(kāi)接受到的鏈接,打開(kāi)后能看到注冊(cè)成功提示。
創(chuàng)建. podspec文件。該文件為Pods依賴(lài)庫(kù)的描述文件,每個(gè)Pods依賴(lài)庫(kù)必須有且僅有那么一個(gè)描述文件。文件名稱(chēng)要和我們想創(chuàng)建的依賴(lài)庫(kù)名稱(chēng)保持一致。
再cd到a
pod spec create SDK
vi SDK.podspec
i
各種編輯
:wq
會(huì)發(fā)現(xiàn)創(chuàng)建的podspec里面一大堆不需要的文字,刪也要?jiǎng)h個(gè)半天,所以推薦的方法是,
找個(gè)成熟的SDK復(fù)制他的podspec文件到a,改名為SDK
vi SDK.podspec。
i
各種編輯
:wq
這里對(duì)文件里的內(nèi)容要進(jìn)行總結(jié)一下,因?yàn)樘畈缓镁蜔o(wú)法提交到cocoapods
以我的SDK的文件內(nèi)容做??
Pod::Spec.new do |s|
s.name = "TYNetworkTool" #SDK名稱(chēng)
s.version = "0.0.2" #版本號(hào)
s.homepage = "https://github.com/TianyongWang/TYNetworkTool" #工程主頁(yè)地址
s.summary = "A short description of TYNetworkTool." #項(xiàng)目的簡(jiǎn)單描述
s.license = "MIT" #協(xié)議類(lèi)型
s.author = { "MasazumiQi" => "47940062@qq.com" } #作者及聯(lián)系方式
s.platform = :ios #支持的平臺(tái)
s.platform = :ios, "7.0" #平臺(tái)及版本
s.ios.deployment_target = "7.0" #最低系統(tǒng)版本
s.source = { :git => "https://github.com/TianyongWang/TYNetworkTool.git" ,:tag => "#{s.version}"} #工程地址及版本號(hào)
s.requires_arc = true #是否必須arc
s.source_files = "TYNetworkTool/*.{h,m}" #SDK實(shí)際的重要文件路徑,這里有個(gè)坑,后面文章再說(shuō)
s.frameworks = "UIKit","Foundation" #需要導(dǎo)入的frameworks名稱(chēng),注意不要帶上frameworks
s.dependency "AFNetworking" #依賴(lài)的第三方庫(kù)
s.dependency "YYCache" #依賴(lài)的第三方庫(kù)
end
添加podspec文件到GitHub.
git add 'SDK.podspec' 或者直接git add -A
git commit -m 'SDK.podspec'
git push添加LICENSE文件
vi LICENSE 直接復(fù)制個(gè)MIT就可以了
:wq
git add 'LICENSE' (或者git add )
git commit -m 'add LICENSE'
git push添加tag
git tag '0.0.1'
git add *
git commit -m 'add tag'
git push origin 0.0.1使用 pod spec lint 來(lái)檢測(cè)一下是否有錯(cuò)誤或警告,有則改之,每次本地的工程中有改動(dòng)并上傳到GitHub上之后需要改變tag 否則就會(huì)找不到你所改動(dòng)的,在改變了tag 之后需要將.podspec文件中的s.version和s.source 的tag 改成同樣的值。這一步真是搞了好久,出了好多錯(cuò)誤,雖然都一一解決了。。有時(shí)間單獨(dú)列個(gè)文章方便后續(xù)解決吧。
pod spec lint 無(wú)錯(cuò)誤則可以pod trunk push,收到發(fā)布成功提示了就可以了。
我試了下pod search SDK 來(lái)搜索自己建的SDK,居然搜不到。。然后用以下方法解決了。。估計(jì)是本地索引文件里沒(méi)更新就搜不到,刪除重建索引就可以了
刪除~/Library/Caches/CocoaPods目錄下的search_index.json文件
pod setup成功后會(huì)生成~/Library/Caches/CocoaPods/search_index.json文件。
終端輸入rm ~/Library/Caches/CocoaPods/search_index.json
刪除成功后再執(zhí)行pod search
- pod install SDK 到自己的項(xiàng)目里愉快的使用吧
迭代更新時(shí)候需要的操作SDK
- 將新代碼上傳到GitHub
- 升級(jí)tag 也就是第8步
- 修改podspec對(duì)應(yīng)的版本號(hào),對(duì)應(yīng)上一步的tag,有其他新增文件或者修改一并修改。
- 上傳podspec,也就是第6步
- 檢測(cè)一下podspec是否有錯(cuò),即第9步,有錯(cuò)就改
- 無(wú)錯(cuò)就pod trunk push。