使用步骤:
1.转换:将我们编写好的XXX.proto文件转成Objective-C文件,也就是XXX.h和XXX.m文件,转换的工具是使用protoc这种二进制文件来生成的,这个文件需要自己生成,下面会介绍如何使用它来转换Objective-C文件
2.集成:在iOS项目中加入protobuf库和步骤1生成的OC文件
转换
编译Protocol Buffers。生成重要的代码生成工具(protoc)。由于Protocol Buffers编译时使用了autoconf/automake/libtool等UNIX工具,Mac可能没有自带,需要手动安装。可以使用Homebrew安装。如果没有安装Homebrew的话,一行代码搞定,打开终端输入:
/usr/bin/ruby -e "$(curl -fsSL
然后安装需要的UNIX工具
brew install autoconf automake libtool
接下来cd到下载的目录下,依次执行:
./autogen.sh
./configure
make
make check
sudo make install
再执行
- objectivec/DevTools/full_mac_build.sh
执行完后会看到src目录下生成了protoc二进制文件
2.使用protoc转换
创建proto文件,比如Person.proto
syntax = "proto3";
message Person
{
int32 age = 1;
string username = 2;
string phone = 3;
}
需要注意的是要指明proto的语法规则是proto2还是proto3
在src目录(protoc所在目录)执行
protoc --proto_path=... --objc_out=... XXX.proto
其中proto_path是我们创建的proto文件所在目录,objc_out为Objective-C文件输出路径,XXX.proto是我们创建的proto文件,可以一次转换多个proto文件,加在XXX.proto后面即可。
举例:我们在src目录下新建两个文件夹,gen和protocols文件夹,gen为输出目录,protocols用于存放proto文件,将创建的Person.proto放在protocols文件夹下,执行命令
protoc --proto_path=protocols --objc_out=gen protocols/Person.proto
然后在gen文件夹下就会生成Person.pbobjc.h和Person.pbobjc.m文件。
iOS中集成protobuf
1.将生成的Ojective-C文件(上面例子的Person.pbobjc.h和Person.pbobjc.m)放到项目中,如果项目使用了ARC,要将.m(例子的Person.pbobjc.m)的Complier Flags设为-fno-objc-arc。(protobuf基于性能原因没有使用ARC)现在应该都是使用的ARC了吧,所以这个是必须的。
修改编译文件.jpeg2.加入protobuf库
这里有两种方式
·第一种是使用CocoaPods集成
platform :ios, '7.1'
pod 'Protobuf', '~> 3.1.0'
需要注意的是 platform :iOS, ‘7.1’也就是7.1以上才能导入这个库,不过现在最低支持到8了,可以忽略
·第二种是把相关文件拖入项目中。
拖入相关文件到项目中,将objectivec文件夹下的所有的.h文件和.m文件(除了GPBProtocolBuffers.m)(GPB开头的那些文件)以及整个google文件夹add到项目中,如果项目中使用了ARC需要将以上所有.m文件的的Complier Flags设为-fno-objc-arc。这种方法的优点是灵活性强,没有7.1的束缚。缺点是操作麻烦点,如果用了ARC的话还要手动添加-fno-objc-arc(使用CocoaPods集成会自动添加)
第二种我没试过,如果想省事,就用cocoapods吧
到此,就可以使用了:
简单的使用
- (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);
}