ProtocolBuffer是谷歌發(fā)明的一種數(shù)據(jù)傳輸協(xié)議

關于ProtocolBuffer的更多介紹請看這里

ProtocolBuffer的環(huán)境配置及安裝

• 環(huán)境安裝

打開終端依次之行如下命令

brew install automake
brew install libtool
brew install protobuf

• 客戶端集成(通過cocoapods)

use_frameworks!
pod 'ProtocolBuffers-Swift' 

• 服務器集成

因為服務器不能直接使用cocoapods集成,需要將工程編譯為靜態(tài)庫來集成

1.到Git中下載整個庫
2.執(zhí)行腳本: ./scripts/build.sh
3.添加: ./src/ProtocolBuffers/ProtocolBuffers.xcodeproj到項目中

ProtocolBuffer的使用

• 創(chuàng)建.proto文件

  1.在項目中, 創(chuàng)建一個(或多個).proto文件
  2.之后會通過該文件, 自動幫我們生成需要的源文件(比如C++生成.cpp源文件, 比如java生成.java源文件, Swift就生成.swift源文件)

• 源碼規(guī)范

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

規(guī)范說明

1.syntax = "proto2"; 為定義使用的版本號, 目前常用版本proto2/proto3
2.message是消息定義的關鍵字，等同于C++/Swift中的struct/class，或是Java中的class
3.Person為消息的名字，等同于結構體名或類名
4.required前綴表示該字段為必要字段，既在序列化和反序列化之前該字段必須已經(jīng)被賦值
5.optional前綴表示該字段為可選字段, 既在序列化和反序列化時可以沒有被賦值
6.repeated通常被用在數(shù)組字段中
7.int64和string分別表示整型和字符串型的消息字段
8.id和name和email分別表示消息字段名，等同于Swift或是C++中的成員變量名
9.標簽數(shù)字1和2則表示不同的字段在序列化后的二進制數(shù)據(jù)中的布局位置, 需要注意的是該值在同一message中不能重復

定義有枚舉類型Protocol Buffer消息

enum UserStatus {
    OFFLINE = 0;  //表示處于離線狀態(tài)的用戶
    ONLINE = 1;   //表示處于在線狀態(tài)的用戶
}
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="./"

環(huán)境配置遇到的問題

• 錯誤1

執(zhí)行下面命令后
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
報錯誤如下圖：

錯誤1

解決方法如上圖箭頭所示，刪除Deleting /Library/Caches/目錄下的Homebrew緩存數(shù)據(jù)

• 可能錯誤2

作者當時運行第二個命令時報如下錯誤

錯誤二

錯誤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

由于作者當時錯誤一處理失敗導致執(zhí)行brew update出現(xiàn)此錯誤
請看圖2的第二個箭頭

• 可能錯誤4

同樣是由于作者當時處理問題1出現(xiàn)失誤造成
< Error: Fetching /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core failed!

原因：是由于該文件夾找不到
解決方法： cd 到上一層目錄執(zhí)行命令就行了

• 可能錯誤5

執(zhí)行brew install protobuf遇見此錯誤
<Error: You must brew link autoconf automake libtool before protobuf can be installed

如圖

錯誤5