ProtocolBuffer-Swift使用

ProtocolBuffer环境安装

Github地址

环境安装步骤：

• 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='./'