ProtocolBuffer环境安装
环境安装步骤：
- ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
- brew install automake
- brew install lib tool
- brew install protobuf
客户端集成(通过cocoa pods)
use_frameworks!
pod 'ProtocolBuffers-Swift'
服务器集成
- 因为服务器使用Mac编写,不能直接使用cocoapods集成
- 因为需要将工程编译为静态库来集成
- 到Git中下载整个库
- 执行脚本: ./scripts/build.sh
（cd 到刚下载的ProtocolBuffer-swift master文件中执行脚本: ./scripts/build.sh） - 添加: ./src/ProtocolBuffers/ProtocolBuffers.xcodeproj到项目中
ProtocolBuffer的使用,并且在TARGET中添加ProtocolBuffers.Frameworks
创建.proto文件
在项目中, 创建一个(或多个).proto文件
之后会通过该文件, 自动帮我们生成需要的源文件(比如C++生成.cpp源文件, 比如java生成.java源文件, Swift就生成.swift源文件)
Snip20170804_4.png
Snip20170804_5.png
源码规范
syntax = "proto2";
message Person {
required int64 id = 1;
required string name = 2;
optional string email = 3;
}
具体说明
syntax = "proto2";为定义使用的版本号, 目前常用版本proto2/proto3
message是消息定义的关键字，等同于C++/Swift中的struct/class，或是Java中的class
Person为消息的名字，等同于结构体名或类名
required前缀表示该字段为必要字段，既在序列化和反序列化之前该字段必须已经被赋值
optional前缀表示该字段为可选字段, 既在序列化和反序列化时可以没有被赋值
repeated通常被用在数组字段中
int64和string分别表示整型和字符串型的消息字段
id和name和email分别表示消息字段名，等同于Swift或是C++中的成员变量名
标签数字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="./"
错误代码：
protoc-gen-swift: program not found or is not executable
--swift_out: protoc-gen-swift: Plugin failed with status code 1.
到github中点击打开链接下载，然后按照readme中(cd 到刚下载的ProtocolBuffer-swift master文件中)得提示执行./script/build.sh命令，如果没有报错，那么应该是可
以通过命令生成对应的protoswift文件了。生成指令，首先cd到你存放proto配置文件目录下然后使用protoc 文件名称.proto --swift_out='./'
