iOS下 安装Protobuf(ProtocolBuffers)

Protobuf是什么?

Protobuf 即 google protocol buffer 是一种数据封装格式协议,是google推出
的一种语言无关、平台无关、扩展性好的用于通信协议、数据存储的结构化数据串行化方法。支持
C++、Python、Java三种语言。

为什么要使用Protobuf?

在不同平台通信的时候，首先需要将对象进行序列化。iOS平台上我们常用NSKeyedArchiver进行
归档，当然也可以将数据处理为JSON或者XML格式。NSKeyedArchiver只能在iOS/Mac平台使用，
因此它归档的二进制数据不适合于在不同平台之间使用。JSON和XML虽然由于容易维护，易读而应用
比较广泛，但是对数据的利用效率都不是高。这时候该使用Protobuf了,因为Protobuf的优势是
效率高，同样的一份数据使用protobuf存储的时候更小，更加方便

安装步骤如下:

一.安装环境 

    1.打开终端
    2.查看你的mac上是否安装了brew
      $ brew -v
      Homebrew 1.6.8
      Homebrew/homebrew-core (git revision d822; last commit 2018-06-12)
     这是表明已经安装,如果没有安装,使用下面的命令安装下

   3.安装brew (使用ruby安装)
      $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/
   Homebrew/install/master/install)"

   4.下载依赖库(工具)
       $ brew install automake
       $ brew install libtool

   5.下载Protobuf
       $ brew install protobuf

   6.克隆protobuf-objc,也就是说吧代码下载到本地
      $ cd desktop 我是clone到桌面,你们可以随便放那
      $ git clone https://github.com/alexeyxo/protobuf-objc.git

    7.运行脚本
        $  cd ~/protobuf-objc    切换到clone的目录

        $  ./scripts/build.sh
     或者这样
        $ ./autogen.sh
        $ ./configure
        $ make
        # 如果希望安装protoc，执行下面的命令
        $ make install

      编译后报错:In file included from objc_helpers.cc:27:./google/protobuf/
     objectivec-descriptor.pb.h:17:2: error: This file was generated by 
      an older version of protoc which is 
      #error This file was generated by an older version of protoc which is
      ^
      ./google/protobuf/objectivec-descriptor.pb.h:18:2: error: incompatible with your
      Protocol Buffer headers. Please
    #error incompatible with your Protocol Buffer headers. Please
      ^
     ./google/protobuf/objectivec-descriptor.pb.h:19:2: error: regenerate this file
     with a newer version of protoc.
   #error regenerate this file with a newer version of proton.
    ......
出现这样的错误,不要慌,这是google自己版本的问题,我们不用管他,而且也不会像其他文章说的那
样,生成protoc-gen-objc这个插件,根本就不会生成,除非版本是2.6.0,这个问题采用下面的方式
一样能生成proto文件

二.生成后缀proto的文件
说明: 创建 proto 文件指定数据格式，可以选择proto2和proto3格式，它们有些细微的区别，在生成代码的时候会提示的，具体情况查看文档Language Guide proto3。下面使用proto3格式，并且保存为person.proto。

  1.  创建文件person.proto
      $  cd desktop  我还是切换到桌面
      $  touch person.proto
  2. 编辑person.proto文件
      2.1 使用终端编辑
           $ vi person.proto
              syntax = "proto3";
              message Person{
              string name = 1;
               int32 age = 20;
             enum DeviceType{
                      iOS = 0;
                     Android = 1;
                  }
              }
        2.2 放到xcode中直接写(推荐)

三.转化成objc文件

由于我们生成不了protoc-gen-objc,因此使用
protoc --plugin=/usr/local/bin/protoc-gen-objc  --objc_out=./ person.proto这种方式是不行的

我们使用 protoc 工具生成Objective-C代码:
终端输入: $ protoc --proto_path=A --objc_out=B person.proto

其中--proto_path=后跟A是需要处理的proto文件所在的文件夹，--objc_out=指明生成的是
Objective-C代码以及目标文件存放路径，B是目标文件存放路径,person.proto是需要处理的文件。

这时候我们就生成了2个文件,如下图

objc-proto文件

导入工程中,这两个文件是采用的手动引用计数，因此在加入项目后需要设置它们的编译参数。

设置

四.项目使用 (下载Protocol Buffers的源码(下载地址)，也可以到官网上下载)

 1.使用cocoapods方式导入
    pod  'Protobuf'  而不是   pod 'ProtocolBuffers',      
    使用 pod 'ProtocolBuffers'
    下载成功之后,编译一看,结果报错 
    #import "GPBProtocolBuffers_RuntimeSupport.h"无法找到

报错

  原因是pods下来的是不带GPB的,所以网上说的不对,应该是用
pod 'Protobuf' ,这样就没有问题
 
 2.静态库引入方式 
     1.下载Protocol Buffers的源代码 
     2.工程里引入ProtocolBuffers_iOS.xcodeproj,或者编译成静态库.a方式,然后公开头文件(如图2)
     3.设置依赖和连接库。(如图3)
     4.引入头文件(如图4)

图2 图3
图4

参考文章

https://my.oschina.net/kgdugyiy/blog/538333 安装和使用
https://developers.google.com/protocol-buffers/ 语法方面
https://github.com/google/protobuf/blob/master/src/README.md 官网教程
至于如何使用,下期文章会详细介绍,并提供demo,喜欢的,点下赞,谢谢!