在iOS中Protocol Buffer(Protobuf3.3.0)的使用

一、ProtocolBuffer

最新版本Protobuf3.3.0 在iOS中的使用(OC与Swift使用一样)
具体作用参考官方文档

在使用时会遇到很多的错误,为了少走弯路,请耐心看。。。

二、What are protocol buffers?

protocol buffers是一种灵活,高效,自动化的结构化数据序列化机制。类似于我们现在使用的XML和JSON。是Google公司推出出的。但是(但是的前面都他妈是废话)与传统的XML和JSON不同的是,它是一种二进制格式,免去了文本格式转换的各种困扰,并且转换效率非常快,由于它的跨平台、跨编程语言的特点,它越来越普及,尤其是网络数据交换信息量较大方面使用起来更加便利。

PB目前托管在GitHub,链接地址:
https://github.com/google/protobuf
或者https://github.com/google/protobuf/releases(尽量选择后者,找到你所需的语言安装包)
源码的主要功能可以分为两部分:

1、PB编译器:源码生成器,将PB格式定义文件**.proto(PB数据格式的一种定义文件)转换为对象源码(支持C++,JAVA,Python,Objective-C,Javascript,PHP等格式),主要使用命令行操作。
2、PB基础库:完成序列化与反序列化转换过程的支持

  • 对 象 >>>>二进制(序列化)
  • 二进制 >>>>对 象(反序列化)
    (把对象转换为字节序列的过程称为对象的序列化;
    把字节序列恢复为对象的过程称为对象的反序列化。)

三、Protoc 编辑器环境配置

配置protobuf编译器

首先将文件下载下来https://github.com/google/protobuf/releases

1、 配置protobuf编译器环境

打开终端执行命令进入到文件的根目录:
$ cd protobuf-3.3.0
然后依次执行:
$ ./configure
$ make
$ make check
$ sudo make install
检测安装完毕-使用命令:
$ protoc --version 或者查看帮助$ protoc -h
如果编译顺利的话,便可以使用protoc命令了,以后便可以用这个命令将.proto文件转换为不同语言的源代码文件了。

2、使用PB编译器编译.proto文件

安装好PB,使用PB编译器来生成我们需要的数据类型文件。
在桌面touch个文件夹名为Class,
$ cd desktop -> $ touch Class -> $ cd Class
在空文件夹Class 创建一个Person.proto文件(名字自定义)
$ touch Person.proto
创建好后就定义一些数据类型(使用终端或编辑器都可以)
按照官方标准语法https://developers.google.com/protocol-buffers/ 编写通用代码
文件中写入:

syntax = "proto3";

message Person {
  string name = 1;
  int32 uid = 2;
  string email = 3;
  enum PhoneType {
    MOBILE = 0;
    HOME = 1;
    WORK = 2;
  }
  message PhoneNumber {
    string number = 1;
    PhoneType type = 2;
  }
   repeated PhoneNumber phone = 4;
}

保存退出,命令行确保在Class文件夹中,执行命令:
$ protoc *.proto --objc_out=../Class
若没问题,这是文件夹中应该已经生成了model文件。
若报错,1、请检查命令;2、检测***.proto文件中的标点符号;

3、引入iOS工程

一种使用Pod方式引入

新建工程PBDemo,终端执行:
$ cd PBDemo
创建 Podfile文件
$ touch Podfile
编辑 Podfile文件
$ vim Podfile
进入文件后点击键盘(英文输入法) i 进入 insert状态 开始编辑(注意标点符号

platform :ios,'8.0'
target 'PBDemo' do 
   pod 'Protobuf','~>3.3.0'
end

然后执行保存, 点击esc 输入 :wq,回车。
注意上面的 pod 'Protobuf','~>3.3.0' 否则没有3.3.0版本,以后若有新版本,可先使用 $ pod search Protobuf查询下。
使用Pod来导入库
$ pod install
完成后退出工程,再次进入就会看到PB依赖库了。以后使用的时候切记如下两点:
① 从此以后需要使用Cocoapods生成的 .xcworkspace文件来打开工程,而不是使用以前的.xcodeproj文件。
② 每次更改了Podfile文件,都需要重新执行一次pod update命令。

 **补充:** 执行pod install后,除了Podfile,还会生成一个名为
Podfile.lock的文件,它会锁定当前各依赖库的版本,之后即使多
次执行pod install也不会更改版本,只有执行pod update才会改变
Podfile.lock,这在多人协作的时候,这样可以防止第三方库升级
时候造成大家各自的第三方库版本不一致。所以在提交版本
的时候不能把它落下,也不要添加到.gitignore中。(转)

pod install 完后重新打开PBDemo.xcworkspace 工程,
将编译好的PB文件引入工程,如图:


接着,生成的文件是不支持ARC,需要手动转一下

点击工程---Build Phases ---Compile Source 中的Person.pbobjc.m文件添加-fno-objc-arc保存变编译suc。
如图:

到此,使用Pod引入ProtocolBuffer就完了,就是一些测试了,如下:

在ViewController中引入Person.pbobjc.h头文件
加入测试代码:

    // 创建对象
    Person *person = [Person new];
    person.name = @"weiCL";
    person.uid = 20170810;
    person.email = @"cl9000@126.com";
    
    // 序列化为Data
    NSData *data = [person data];
    NSLog(@"NSData= %@", data);
    
    // 反序列化为对象
    Person *person2 = [Person parseFromData:data error:NULL];
    NSLog(@"name:%@ uid:%d email:%@",person2.name,person2.uid,person2.email);
    

OK,下一种方式直接引入经常会出现错误,解决方法具体请看下面

===========================================
另一种直接将相关类文件拖入工程

1、 新建一个工程PBDemo3,show in Finder 创建文件夹名称为:protocolbuf (此名称可自定义,但后面面要使用其路径),和创建个Lib文件夹备用
2、打开下载好的protobuf-3.3.0(或最新版本),会有个objectivec的文件夹。拷贝里面所有的文件,放到上面创建的protocolbuf 文件夹中。




3、使用Xcode打开工程,将Lib文件夹引入工程,然后选中Lib文件夹,点击左下角“+”(Add Files to PBDemo3), 引用protocolBuffer源文件到工程中
(源文件里面有两个工程配置文件:ProtocolBuffers_iOS.xcodeproj和ProtocolBuffers_OSX.xcodeproj,引用ProtocolBuffers_iOS.xcodeproj就好)。这里我们只引入库文件,另创建Lib文件只是为了方便管理。


4、选中工程: targets —> Build Phases —> Link Binary With Libraries, 引用源码静态库文件:libProtocolBuffers.a


5、在工程设置搜索静态库的头文件(pb文件在protocolbuf文件夹里面):
   targets —> Build Setting —> Search Paths —> Header Search Paths, 写入:$(PROJECT)/protocolbuf


完成后 build 一下。suc
6、 将我们上面通过PB编译器生成的数据模型文件Class文件夹(内含Person.proto,Person.pbobjc.h和Person.pbobjc.m)
拖入工程,(尽量使用Add File to ...引入)
因为不支持arc, 所以需要在*.pbobjc.m设置-fno-objc-arc, 然后就可以使用了。具体目录如图:

Build一下、suc 、进行测试、测试代码如上不重复了这里。

===========================================

Demo源码 : https://github.com/cl9000/ProtocolBufferDemo.git

如有问题,不吝赐教,及时联系,共同进步。

最后,感谢参考的博文:
方式一:使用Pod
ProtocolBuffer for Objective-C 运行环境配置及使用
ProtocolBuffers-3 For Objective C (1)-简单的使用
方式二:直接引入
iOS之ProtocolBuffer搭建和示例demo

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

推荐阅读更多精彩内容