ProtocolBuffer是谷歌發(fā)明的一種數(shù)據(jù)傳輸協(xié)議
關(guān)于ProtocolBuffer的更多介紹請看這里
ProtocolBuffer的環(huán)境配置及安裝
-
環(huán)境安裝
打開終端依次之行如下命令
brew install automake
brew install libtool
brew install protobuf
-
客戶端集成(通過cocoapods)
use_frameworks!
pod 'ProtocolBuffers-Swift'
-
服務(wù)器集成
因為服務(wù)器不能直接使用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是消息定義的關(guān)鍵字笼平，等同于C++/Swift中的struct/class，或是Java中的class
3.Person為消息的名字薇溃，等同于結(jié)構(gòu)體名或類名
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中不能重復(fù)
定義有枚舉類型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;
}
-
代碼編寫完成后, 生成對應(yīng)語言代碼
protoc person.proto --swift_out="./"
環(huán)境配置遇到的問題
-
錯誤1
執(zhí)行下面命令后
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
報錯誤如下圖：
解決方法如上圖箭頭所示，刪除Deleting /Library/Caches/目錄下的Homebrew緩存數(shù)據(jù)
-
可能錯誤2
作者當時運行第二個命令時報如下錯誤
說目錄已存在讓刪除目錄：so，就刪除目錄并執(zhí)行
brew update如下圖
-
可能錯誤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
如圖
解決辦法：其實終端有提示蝇刀，沒錯執(zhí)行這個
brew link autoconf automake libtool
