ProtocolBuffer for Objective-C 运行环境配置及使用

原文
或者参照这个,内附demo
一 、前言
最近要做一个新的项目需要用到Google的Protocol Buffer,所以最近两天一直在学习这个。在网上看了很多人写的相关博客,发现他们写的配置环境的步骤不尽相同,并且不需要那么复杂,所以就想写一篇最新的文章。 配置环境:mac OS 10.11.1 本文若有叙述错误之处,欢迎指点。
二 、Protocol Buffer简介
Protocolbuffer(简称Protobuf或PB)是由Google推出的一种数据交换格式,它独立于语言,独立于平台。Google 提供了三种语言的实现:java、c++ 和 python,每一种实现都包含了相应语言的编译器以及库文件。可以把它用于分布式应用之间的数据通信或者异构环境下的数据交换。与传统的XML和JSON不同的是,它是一种二进制格式,免去了文本格式转换的各种困扰,并且转换效率非常快,由于它的跨平台、跨编程语言的特点,让它越来越普及,尤其是网络数据交换方面日趋成为一种主流。
PB目前托管在GitHub,链接地址:https://github.com/google/protobuf,源码的主要功能可以分为两部分:
PB基础库:完成对象->二进制数据的序列化、二进制数据->对象的反序列化这两个转换过程的支持;PB编译器:源码生成器,将PB格式定义文件。proto(PB数据格式的一种定义文件)转换为对象源码(支持C++,JAVA,Python等格式)。
截止目前PB的最新版本为3.0.0-beta-2,已经加入了对Objective-C的支持(其它之前低版本中也已经有OC扩展支持)。在使用cocoaPods的项目里使用pod search ProtocolBuffers进行搜索,搜索结果如下:

pod search ProtocolBuffers

注意:本文是以ProtocolBuffers:https://github.com/alexeyxo/protobuf-objc.git 为例进行演示的,因为它生成的代码支持ARC。
三、Mac环境配置
安装很简单,对着README操作一遍即可,我贴出自己在终端的命令行。需要输入的命令行依次为:1)打开终端,查看mac里面有没有装Homebrew,键入以下命令
brew -v

2)如果没有安装Homebrew就使用下面的命令安装
ruby -e “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)”

3)安装protobuf编译器和所需的工具
brew install automakebrew install libtoolbrew install protobuf

具体演示:(省略部分命令)
Last login: Fri Jan 8 09:59:02 on ttys001wushangkundeiMac:~ wushangkun$ brew -v-bash: brew: command not foundwushangkundeiMac:~ wushangkun$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"**==>**** This script will install:**/usr/local/bin/brewPress RETURN to continue or any other key to abort**==>**** /usr/bin/sudo /bin/chmod g+rwx /usr/local/. /usr/local/bin**Password:**==>**** /usr/bin/sudo /usr/sbin/chown wushangkun /usr/local/. /usr/local/bin****==>**** /usr/bin/sudo /usr/bin/chgrp admin /usr/local/. remote: Counting objects: 3934, done.remote: Compressing objects: 100% (3777/3777), done.remote: Total 3934 (delta 34), reused 2251 (delta 22), pack-reused 0Receiving objects: 100% (3934/3934), 3.43 MiB | 888.00 KiB/s, done.Resolving deltas: 100% (34/34), done.From https://github.com/Homebrew/homebrew * [new branch] master -> origin/masterChecking out files: 100% (3936/3936), done.HEAD is now at ef28579 ipfs: update 0.3.10 bottle.**==>**** Installation successful!****==>**** Next steps**Runbrew helpto get startedwushangkundeiMac:~ wushangkun$ brew install automake**==>**** Installing dependencies for automake: ****autoconf****==>**** Installing automake dependency: ****autoconf**######################################################################## 100.0%In order to prevent conflicts with Apple's own libtool we have prepended a "g"so, you have instead: glibtool and glibtoolize.**==>**** Summary**🍺 /usr/local/Cellar/libtool/2.4.6: 69 files, 3.6MwushangkundeiMac:~ wushangkun$ brew install protobuf mkdir -p /Users/wushangkun/Library/Python/2.7/lib/python/site-packages echo 'import site; site.addsitedir("/usr/local/lib/python2.7/site-packages")' >> /Users/wushangkun/Library/Python/2.7/lib/python/site-packages/homebrew.pth**==>**** Summary**🍺 /usr/local/Cellar/protobuf/2.6.1: 118 files, 6.9MwushangkundeiMac:~ wushangkun$

4)以上步骤进行完之后,开始Clone this repository,在桌面新建protobuf-objc 文件夹,在终端里进入该文件下下载代码
git clone https://github.com/alexeyxo/protobuf-objc.git

5)Build it !
./scripts/build.sh

具体演示:
Last login: Fri Jan 8 10:06:15 on ttys001wushangkundeiMac:~ wushangkun$ cd /Users/wushangkun/Desktop/protobuf-objc wushangkundeiMac:protobuf-objc wushangkun$ git clone https://github.com/alexeyxo/protobuf-objc.gitCloning into 'protobuf-objc'...remote: Counting objects: 2788, done.remote: Total 2788 (delta 0), reused 0 (delta 0), pack-reused 2788Receiving objects: 100% (2788/2788), 32.92 MiB | 683.00 KiB/s, done.Resolving deltas: 100% (1761/1761), done.Checking connectivity... done.wushangkundeiMac:protobuf-objc wushangkun$ lsprotobuf-objcwushangkundeiMac:protobuf-objc wushangkun$ cd protobuf-objc/wushangkundeiMac:protobuf-objc wushangkun$ ./scripts/build.sh+ ./autogen.shglibtoolize: putting auxiliary files in '.'.glibtoolize: copying file './ltmain.sh' ********* ********* ********* ********* 省略部分。。。 ********* ********* ********* *********mv -f .deps/objectivec-descriptor.pb.Tpo .deps/objectivec-descriptor.pb.Pomv -f .deps/objc_message.Tpo .deps/objc_message.Po/bin/sh ../../libtool --tag=CXX --mode=link g++ -I/usr/local/include -lprotobuf -lprotoc -L/usr/local/lib -o protoc-gen-objc main.o objc_enum_field.o objc_file.o objc_message_field.o objc_enum.o objc_generator.o objc_primitive_field.o objc_extension.o objc_helpers.o objc_field.o objc_message.o objectivec-descriptor.pb.o libtool: link: g++ -I/usr/local/include -o protoc-gen-objc main.o objc_enum_field.o objc_file.o objc_message_field.o objc_enum.o objc_generator.o objc_primitive_field.o objc_extension.o objc_helpers.o objc_field.o objc_message.o objectivec-descriptor.pb.o -Wl,-bind_at_load -lprotobuf -lprotoc -L/usr/local/libmake[2]: Nothing to be done forall-am'.+ make installMaking install in src/compiler ../.././install-sh -c -d '/usr/local/bin' /bin/sh ../../libtool --mode=install /usr/bin/install -c protoc-gen-objc '/usr/local/bin'libtool: install: /usr/bin/install -c protoc-gen-objc /usr/local/bin/protoc-gen-objcmake[2]: Nothing to be done for install-data-am'.make[2]: Nothing to be done forinstall-exec-am'.make[2]: Nothing to be done for install-data-am'.wushangkundeiMac:protobuf-objc wushangkun$
运行完成后,最终会生成一个protoc-gen-objc插件,被安装到/usr/local/bin/目录下。如果没有错误的话,以后便可以用这个命令将.proto文件转换为不同语言的源代码文件。
四、为工程添加PB依赖库
添加PB依赖库有两种方式,可以直接把/src/runtime/ProtocolBuffers.xcodeproj作为子项目添加到你的工程里,具体添加方式和注意事项可自行参阅相关文档解决。我现在使用CocoaPod来添加依赖库:1)在终端中进入你项目的文件夹,利用vim创建一个名为Podfile的文件,输入i进入vim编辑模式 ;2)在你的Podfile中添加:
platform:ios,’7.0’pod ‘ProtocolBuffers’, ‘~> 1.9.9.2’

按ESC后取消编辑状态,输入:wq回车退出。需要注意的几点:platform那一行,ios三个字母都要小写,而且与前面的冒号之间不能有间隔,后面的版本号也可以不写,但是有些开源库对版本是有要求的,比如要在6.0以上才能运行,遇到这样的开源库就需要写上版本号。
3)在Terminal中执行 :pod install,完成后退出工程,再次进入就会看到PB依赖库了。以后使用的时候切记如下两点:① 从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程,而不是使用以前的.xcodeproj文件。② 每次更改了Podfile文件,都需要重新执行一次pod update命令。
补充: 当执行pod install之后,除了Podfile,还会生成一个名为Podfile.lock的文件,它会锁定当前各依赖库的版本,之后即使多次执行pod install也不会更改版本,只有执行pod update才会改变Podfile.lock在多人协作的时候,这样可以防止第三方库升级时候造成大家各自的第三方库版本不一致。所以在提交版本的时候不能把它落下,也不要添加到.gitignore中。
wushangkundeiMac:~ wushangkun$ cd /Users/wushangkun/Desktop/J1Test/J1Hospital wushangkundeiMac:J1Hospital wushangkun$ vim PodfilewushangkundeiMac:J1Hospital wushangkun$ pod installUpdating local specs repositoriesAnalyzing dependenciesDownloading dependenciesInstalling ProtocolBuffers (1.9.9.2)Generating Pods projectIntegrating client project[!] Please close any current Xcode sessions and useJ1Hospital.xcworkspacefor this project from now on.Sending statsPod installation complete! There is 1 dependency from the Podfile and 1 totalpod installed.wushangkundeiMac:J1Hospital wushangkun$
注意: 在使用的时候你可能会碰到在代码里导入(#import)头文件没有提示,虽然自己手写出来也能使用,但总觉得不方便。在stackoverflow上找到了解决办法:把pods目录添加到用户头文件检索的路径即可。具体实现方法如下:选择target ——- BuildingSettings ——– User Header Search Paths,双击空白区域点击“+”号,输入“$(PODS_ROOT)”,选择recursive(会在相应的目录递归搜索文件)。
这样设置完成后,再导入第三方库就会有提示了。

头文件引用修改

四、使用PB编译器编译.proto文件
为了验证ProtocolBuffer环境已经搭建好了,我们就做个测试。在桌面建一个prototest文件夹,直接拷贝电脑里一个已有的User.proto文件做测试


User.proto

然后通过以下命令来生成model的源代码文件:
protoc --plugin=/usr/local/bin/protoc-gen-objc User.proto --objc_out="./"

在当前目录下便可以看到User.pb.h和User.pb.m这两个文件了(需要注意的是生成的代码是支持ARC的!!)。将生成的 .h 和 .m 文件添加到工程中,编译。这里会提示找不到GeneratedMessageProtocol。你只需要将其注释掉就行了。
五、查看版本

protoc --version
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,271评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,275评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,151评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,550评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,553评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,559评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,924评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,580评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,826评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,363评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,940评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2 342

推荐阅读更多精彩内容