Mac配置ProtocolBuffer环境及使用

ProtocolBuffer是谷歌发明的一种数据传输协议

关于ProtocolBuffer的更多介绍请看这里

ProtocolBuffer的环境配置及安装

• 环境安装

打开终端依次之行如下命令

brew install automake
brew install libtool
brew install protobuf

• 客户端集成(通过cocoapods)

use_frameworks!
pod 'ProtocolBuffers-Swift' 

• 服务器集成

因为服务器不能直接使用cocoapods集成,需要将工程编译为静态库来集成

1.到Git中下载整个库
2.执行脚本: ./scripts/build.sh
3.添加: ./src/ProtocolBuffers/ProtocolBuffers.xcodeproj到项目中

ProtocolBuffer的使用

• 创建.proto文件

  1.在项目中, 创建一个(或多个).proto文件
  2.之后会通过该文件, 自动帮我们生成需要的源文件(比如C++生成.cpp源文件, 比如java生成.java源文件, Swift就生成.swift源文件)

• 源码规范

 syntax = "proto2";
message Person {
    required int64 id = 1;
    required string name = 2;
    optional string email = 3;
} 

规范说明

1.syntax = "proto2"; 为定义使用的版本号, 目前常用版本proto2/proto3
2.message是消息定义的关键字，等同于C++/Swift中的struct/class，或是Java中的class
3.Person为消息的名字，等同于结构体名或类名
4.required前缀表示该字段为必要字段，既在序列化和反序列化之前该字段必须已经被赋值
5.optional前缀表示该字段为可选字段, 既在序列化和反序列化时可以没有被赋值
6.repeated通常被用在数组字段中
7.int64和string分别表示整型和字符串型的消息字段
8.id和name和email分别表示消息字段名，等同于Swift或是C++中的成员变量名
9.标签数字1和2则表示不同的字段在序列化后的二进制数据中的布局位置, 需要注意的是该值在同一message中不能重复

定义有枚举类型Protocol Buffer消息

enum UserStatus {
    OFFLINE = 0;  //表示处于离线状态的用户
    ONLINE = 1;   //表示处于在线状态的用户
}
message UserInfo {
    required int64 acctID = 1;
    required string name = 2;
    required UserStatus status = 3;
}

定义有类型嵌套

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

• 代码编写完成后, 生成对应语言代码

protoc person.proto --swift_out="./"

环境配置遇到的问题

• 错误1

执行下面命令后
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
报错误如下图：

错误1

解决方法如上图箭头所示，删除Deleting /Library/Caches/目录下的Homebrew缓存数据

• 可能错误2

作者当时运行第二个命令时报如下错误

错误二

说目录已存在让删除目录：so，就删除目录并执行 brew update如下图

错误2

• 可能错误3

Error: The current working directory doesn't exist, cannot proceed.
shell-init: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory

由于作者当时错误一处理失败导致执行brew update出现此错误
请看图2的第二个箭头

• 可能错误4

同样是由于作者当时处理问题1出现失误造成
< Error: Fetching /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core failed!

原因：是由于该文件夹找不到
解决方法： cd 到上一层目录执行命令就行了

• 可能错误5

执行brew install protobuf遇见此错误
brew link autoconf automake libtool before protobuf can be installed

如图

错误5

解决办法：其实终端有提示，没错执行这个brew link autoconf automake libtool