dailyLearning -- IM開發(fā)中protobuf-objc安裝及使用

Protobuf簡介

Protocol Buffer是google 的一種數(shù)據(jù)交換的格式叁怪,已經(jīng)在Github開源审葬,目前最新版本是3.1.0。它獨(dú)立于語言奕谭,獨(dú)立于平臺(tái)涣觉。google 提供了多種語言的實(shí)現(xiàn):Java、C#血柳、C++官册、Go 和 Python,Objective-C,每一種實(shí)現(xiàn)都包含了相應(yīng)語言的編譯器以及庫文件难捌。由于它是一種二進(jìn)制的格式膝宁,比使用 XML 進(jìn)行數(shù)據(jù)交換快許多「酰可以把它用于分布式應(yīng)用之間的數(shù)據(jù)通信或者異構(gòu)環(huán)境下的數(shù)據(jù)交換员淫。作為一種效率和兼容性都很優(yōu)秀的二進(jìn)制數(shù)據(jù)傳輸格式,可以用于諸如網(wǎng)絡(luò)傳輸击敌、配置文件介返、數(shù)據(jù)存儲(chǔ)等諸多領(lǐng)域。

說明
protobuf3.0.0以上才官方支持Objective-C愚争,低于3.0.0的請(qǐng)忽略或使用第三方轉(zhuǎn)換工具
開發(fā)環(huán)境:32bit & 64bit iOS, 64bit OS X映皆,Xcode7.0+
基于性能原因沒有使用ARC,但可以被ARC代碼調(diào)用

步驟

  • 轉(zhuǎn)換:將我們編寫好的XXX.proto文件轉(zhuǎn)成Objective C文件轰枝,也就是XXX.h和XXX.m文件捅彻,轉(zhuǎn)換的工具是使用protoc這種二進(jìn)制文件來生成的,這文件需要自己生成鞍陨,稍后會(huì)介紹如何使用它來轉(zhuǎn)換Objective-C文件
  • 集成:如果在iOS項(xiàng)目中加入protobuf庫以及步驟1生成的OC文件

轉(zhuǎn)換
生成protoc

如果沒有裝autoconf automake libtool需要先裝這幾個(gè)步淹,這里使用brew來安裝从隆,在shell執(zhí)行 brew install autoconf automake libtool即可,如果沒有brew請(qǐng)自行先安裝brew缭裆。
下載面向Objective-C的protobuf庫键闺,地址為(https://github.com/google/protobuf/releases),要下載對(duì)應(yīng)Objective-C的版本比如 protobuf-objectivec-3.1.0.zip,解壓澈驼。

cd到下載的目錄,依次執(zhí)行:

$ ./autogen.sh
$ ./configure
$ make
$ make check
$ sudo make install

再執(zhí)行

- objectivec/DevTools/full_mac_build.sh

執(zhí)行完后會(huì)看到src目錄下生成了protoc二進(jìn)制文件

使用protoc轉(zhuǎn)換
創(chuàng)建proto文件辛燥,比如Person.proto

syntax = "proto3";
message Person
{ 
    int32 age = 1;
    string username = 2;
    string phone = 3;
}

需要注意的是要指明proto的語法規(guī)則是proto2還是proto3。
在src目錄(protoc所在目錄)執(zhí)行

protoc --proto_path=... --objc_out=... XXX.proto

其中proto_path是我們創(chuàng)建的proto文件所在目錄缝其,objc_out為Objective-C文件輸出路徑,XXX.proto是我們創(chuàng)建的proto文件挎塌,可以一次轉(zhuǎn)換多個(gè)proto文件,加在XXX.proto后面即可内边。

舉例:我們?cè)趕rc目錄下新建兩個(gè)文件夾榴都,gen和protocols文件夾,gen為輸出目錄漠其,protocols用于存放proto文件嘴高,將創(chuàng)建的Person.proto放在protocols文件夾下,執(zhí)行命令

protoc --proto_path=protocols --objc_out=gen protocols/Person.proto

然后在gen文件夾下就會(huì)生成Person.pbobjc.h和Person.pbobjc.m文件和屎。

集成
將生成的Ojective-C文件(上面例子的Person.pbobjc.h和Person.pbobjc.m)放到項(xiàng)目中拴驮,如果項(xiàng)目使用了ARC,要將.m(例子的Person.pbobjc.m)的Complier Flags設(shè)為-fno-objc-arc。(protobuf基于性能原因沒有使用ARC)

加入protobuf庫眶俩,有兩種方式

  • 第一種是使用CocoaPods集成

使用CocoaPods集成莹汤,有一個(gè)現(xiàn)成的pod可以使用–Protobuf,可以pod search Protobuf搜索查看詳情快鱼,pod內(nèi)容為

platform :ios, '7.1'
pod 'Protobuf', '~> 3.1.0'

需要注意的是 platform :iOS, ‘7.1’
7.1及以上才能導(dǎo)入這個(gè)庫,這種方式優(yōu)點(diǎn)是操作簡單颠印,缺點(diǎn)是platform :ios, ‘7.1’ 要7.1或以上

  • 第二種是把相關(guān)文件拖入項(xiàng)目中。

拖入相關(guān)文件到項(xiàng)目中抹竹,將objectivec文件夾下的所有的.h文件和.m文件(除了GPBProtocolBuffers.m)(GPB開頭的那些文件)以及整個(gè)google文件夾add到項(xiàng)目中线罕,如果項(xiàng)目中使用了ARC需要將以上所有.m文件的的Complier Flags設(shè)為-fno-objc-arc。這種方法的優(yōu)點(diǎn)是靈活性強(qiáng)窃判,沒有7.1的束縛钞楼。缺點(diǎn)是操作麻煩點(diǎn),如果用了ARC的話還要手動(dòng)添加-fno-objc-arc(使用CocoaPods集成會(huì)自動(dòng)添加),記得添加User Header Search Paths為$(PROJECT_DIR)/項(xiàng)目名/后接文件地址 不然頭文件會(huì)報(bào)錯(cuò)
簡單使用

直接上代碼

- (void)viewDidLoad {
     [super viewDidLoad];
     Person *person = [[Person alloc] init];
     person.age = 100; 
     person.username = @"huang";
     person.phone = @"10086";
     NSData *data = [person data];
     Person *p = [Person parseFromData:data error:nil];
     NSLog(@"person:%@",p);
}

附加 Homebrew 安裝地址:https://brew.sh/index_zh-cn.html
原文地址

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末袄琳,一起剝皮案震驚了整個(gè)濱河市询件,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌唆樊,老刑警劉巖宛琅,帶你破解...
    沈念sama閱讀 221,635評(píng)論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異逗旁,居然都是意外死亡嘿辟,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,543評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來红伦,“玉大人英古,你說我怎么就攤上這事£级粒” “怎么了召调?”我有些...
    開封第一講書人閱讀 168,083評(píng)論 0 360
  • 文/不壞的土叔 我叫張陵,是天一觀的道長蛮浑。 經(jīng)常有香客問我某残,道長,這世上最難降的妖魔是什么陵吸? 我笑而不...
    開封第一講書人閱讀 59,640評(píng)論 1 296
  • 正文 為了忘掉前任玻墅,我火速辦了婚禮,結(jié)果婚禮上壮虫,老公的妹妹穿的比我還像新娘澳厢。我一直安慰自己,他們只是感情好囚似,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,640評(píng)論 6 397
  • 文/花漫 我一把揭開白布剩拢。 她就那樣靜靜地躺著,像睡著了一般饶唤。 火紅的嫁衣襯著肌膚如雪徐伐。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,262評(píng)論 1 308
  • 那天募狂,我揣著相機(jī)與錄音办素,去河邊找鬼。 笑死祸穷,一個(gè)胖子當(dāng)著我的面吹牛性穿,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播雷滚,決...
    沈念sama閱讀 40,833評(píng)論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼需曾,長吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了祈远?” 一聲冷哼從身側(cè)響起呆万,我...
    開封第一講書人閱讀 39,736評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎车份,沒想到半個(gè)月后谋减,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,280評(píng)論 1 319
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡躬充,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,369評(píng)論 3 340
  • 正文 我和宋清朗相戀三年逃顶,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了讨便。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,503評(píng)論 1 352
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡以政,死狀恐怖霸褒,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情盈蛮,我是刑警寧澤废菱,帶...
    沈念sama閱讀 36,185評(píng)論 5 350
  • 正文 年R本政府宣布,位于F島的核電站抖誉,受9級(jí)特大地震影響殊轴,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜袒炉,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,870評(píng)論 3 333
  • 文/蒙蒙 一旁理、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧我磁,春花似錦孽文、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,340評(píng)論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至郁副,卻和暖如春减牺,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背存谎。 一陣腳步聲響...
    開封第一講書人閱讀 33,460評(píng)論 1 272
  • 我被黑心中介騙來泰國打工拔疚, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人愕贡。 一個(gè)月前我還...
    沈念sama閱讀 48,909評(píng)論 3 376
  • 正文 我出身青樓草雕,卻偏偏與公主長得像,于是被迫代替她去往敵國和親固以。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,512評(píng)論 2 359

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