protocolbuffers應用在iOS的配置以及使用方法

Protocol Buffers 是 Google 出品的用來序列化/反序列化數據的工具。原生支持 C++、Java、Python。

若是要在 iOS 上使用 PB，能夠直接使用 C++，可是編譯過程很麻煩，所以這裏使用的是第三方的庫。

安裝 Protocol Buffers

• 安裝 homebrew

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

• 安裝 automake、libtool、protobuf。這裏安裝的 protobuf 是 google 官方版本。

brew install automake
brew install libtool
brew install protobuf

• 先下載protocolbuffer的源碼 protocolbuffer 。裏面有ios的部分，能夠編譯成framework的動態庫或靜態庫，我作好一個demo,能夠用現成的，見github demo 。
• 安裝protocolbuffer，protol類成成工具，一種辦法是用上述源碼裏。

$ cd compiler
$ ./autogen.sh
$ ./configure
$ make
$ make install (optional)

 

• 編譯 protoc-gen-objc。protoc-gen-objc 是 protoc 的一個插件，使其能將 .proto 文件編譯成 objective-c 代碼。

git clone git@github.com:alexeyxo/protobuf-objc.git

cd protobuf-objc

./autogen.sh

# 後面的參數保證 configure 能找到 protobuf 相關的頭文件和庫
# 避免報 protobuf headers are required 錯誤
./configure CXXFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/lib

make

make install

若make後編譯不經過，報錯以下：

google/protobuf/message.cc:130:60: error: implicit instantiation of undefined template  
          'std::__1::basic_istream<char, std::__1::char_traits<char> >'  
      return ParseFromZeroCopyStream(&zero_copy_input) && input->eof();  
                                                               ^  
    /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/../lib/c++/v1/iosfwd:109:33: note:   
          template is declared here  
        class _LIBCPP_TYPE_VIS_ONLY basic_istream;  
                                    ^  
    google/protobuf/message.cc:135:67: error: implicit instantiation of undefined template  
          'std::__1::basic_istream<char, std::__1::char_traits<char> >'  
      return ParsePartialFromZeroCopyStream(&zero_copy_input) && input->eof();  
                                                                      ^  
    /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/../lib/c++/v1/iosfwd:109:33: note:   
          template is declared here  
        class _LIBCPP_TYPE_VIS_ONLY basic_istream;  
                                    ^  
    google/protobuf/message.cc:175:16: error: implicit instantiation of undefined template  
          'std::__1::basic_ostream<char, std::__1::char_traits<char> >'  
      return output->good();  
                   ^  
    /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/../lib/c++/v1/iosfwd:111:33: note:   
          template is declared here  
        class _LIBCPP_TYPE_VIS_ONLY basic_ostream;  
                                    ^  
    3 errors generated.  
    make[2]: *** [message.lo] Error 1  
    make[1]: *** [all-recursive] Error 1  
    make: *** [all] Error 2

根據錯誤信息，對報錯的文件進行以下修改：

protobuf-2.4.1/src/google/protobuf/message.cc，添加#include<istream>

添加後make成功。make install，安裝到自定義目錄。

這些完成以後，寫一個protoc文件測試： UserInfo.proto

enum UserStatus {
    OFFLINE = 0;
    ONLINE = 1;
}
message UserInfo {
    required int64 acctID = 1;
    required string name = 2;
    required UserStatus status = 3;
}

轉換：

$protoc --objc_out=. UserInfo.proto

在當前目錄出現兩個文件： UserInfo.pb.h UserInfo.pb.m

在 Podfile 中添加 pod 'ProtocolBuffers', '1.9.2' 而後執行 pod install 。

生成完成，使用起來很方便，導入framework靜態庫到工程中，使用方法：

UserInfoBuilder* builder = [UserInfo builder];
[builder setName:@"zhangsan"];
[builder setAcctId:1000];
[builder setStatus:UserStatusOnline];

UserInfo* info1 = [builder build];
NSData* data = info1.data;
NSLog(@"data:%@", data);


//data->obj

UserInfo* info2 = [UserInfo parseFromData:data];
NSLog(@"obj:%@", info2);