1、下載地址:https://code.google.com/p/protobuf/downloads/list
安裝 ./configure && make && make install
2、試執行 protoc 命令,如果提示鏈接庫錯誤,則執行 ldconfig
3、編譯 .proto 文件成 C++ 頭文件和源文件
protoc Login.proto --cpp_out=.
注:可以使用 protoc *.proto --cpp_out=. 批量編譯多個 proto 文件。
4、上面的 Login.proto 文件內容如下:
package s3; message Login { required string username = 1; required string password = 2; }
解析:看到消息定義中的 1,2 嗎?每個字段都有唯一的一個標識符,這些標識符是用來在消息的二進制格式中識別各個字段的,一旦開始使用就不能夠再改變。其中 1~15 的標識號在編碼的時候會占用一個字節,16~2047 的標識號則占用2個字節。所以應該為那些頻繁出現的消息元素保留 1~15 的標識號。
最小的標識號可以從1開始,最大到229 - 1, or 536,870,911。不可以使用其中的[19000-19999]的標識號, Protobuf協議實現中對這些進行了預留。如果非要在.proto文件中使用這些預留標識號,編譯時就會報警。
5、編寫測試文件 test.cpp 如下:
#include "Login.pb.h" #include <iostream> #include <fstream> bool write() { s3::Login obj; obj.set_username("aaaaaa"); obj.set_password("111111"); std::fstream output("Login.log", std::ios::out | std::ios::trunc | std::ios::binary); if(!obj.SerializeToOstream(&output)) { return false; } return true; } bool read() { s3::Login obj; std::fstream input("Login.log",std::ios::in | std::ios::binary); if(!obj.ParseFromIstream(&input)) { return false; } std::cout<<"username:"<<obj.username()<<std::endl; std::cout<<"password:"<<obj.password()<<std::endl; return true; } int main() { if(write()) read(); }
上面會輸出: tianya123456
解析:表面上看是12個字符,實際上是12+3=15個字符,以ASCII 10 為開頭字符,然后每個字段前有一個字符,其ASCII 等於該字段的長度,所以上面的輸出實際上是:
10 6 97 97 97 97 97 97 97 6 49 49 49 49 49 49
但這是所有字段都是字符串的情況,如果有 int32 的話,就不一樣了,反正注意看到的長度不是真正的長度就好了,pb能夠進行序列化和反序列化就是依據這個來的。
另外,開發過程中需要經常查看數據,可以調用對象的 DebugString() 函數即可返回可讀性良好的數據。
6、編寫 CMakeLists.txt 如下:
add_executable(test test.cpp Login.pb.cc)
target_link_libraries(test protobuf)
或者直接使用:
g++ test.cpp Login.pb.cc -o test -lprotobuf
7、常用方法:
bool SerializeToString(string* output) const: 序列化消息,將存儲字節的以string方式輸出。注意字節是二進制,而非文本;
bool ParseFromString(const string& data): 解析給定的string
bool SerializeToOstream(ostream* output) const: 寫消息給定的c++ ostream中
bool ParseFromIstream(istream* input): 從給定的c++ istream中解析出消息
8、參考:
http://hideto.iteye.com/blog/445848
開發者指南:http://blog.163.com/jiang_tao_2010/blog/static/12112689020114305013458/
二、JAVA版:
1、下載 apache-maven-3.1.0-bin.tar.gz 解壓,並把 apache-maven-3.1.0/bin 目錄添加到 PATH 變量
2、安裝 JAVA 環境, yum install java && yum install java-devel
3、下載 protobuf-2.5.0.tar.gz 解壓,先安裝 protobuf ,見上面,略。然后 進入 protobuf-2.5.0/java 目錄,依次執行 mvn test && mvn install && mvn package
4、經過第三步,在 target 目錄下生成 .jar 文件
詳細參考:
http://blog.csdn.net/sunxinhere/article/details/8225302
http://blog.csdn.net/dodo_check/article/details/8573592
Unity中的使用:
1、首先使用第三方的C#庫 protobuf-net,首頁為 https://code.google.com/p/protobuf-net/
下載方式有兩種 ,一種是直接下載,一種是通過官方推薦的工具下載,我是直接下載的:
https://code.google.com/p/protobuf-net/downloads/list
下載下來之后,里面有一個工具 protogen.exe,可以用來把 .proto 文件生成 C# 的格式:
protogen.exe -i:Login.proto -o:Login.cs
2、關於 protobuf-net 的dll 在unity發布到IOS機器上是無法使用的,解決方案請參考:
http://game.ceeger.com/forum/read.php?tid=13479
3、關於 unity 的版本控制:
http://blog.k-res.net/archives/1113.html
4、關於兩個SVN需要共用的資源,如服務端和客戶端使用同一份 proto 文件夾,可以使用SVN的外部命令,參考下面的網頁:
http://blog.csdn.net/echoisland/article/details/6584875
比如把存放在服務端的 proto 文件夾同步到客戶端的某個目錄下,命令如下:
svn propset svn:externals "proto svn://172.16.116.200/coldjoke/Trunk/server/proto" .
表示把 svn://172.16.116.200/coldjoke/Trunk/server/proto 同步到當前目錄(由命令最后面的 . 決定)的 proto 文件夾。
如果要刪除這個外部命令,可以使用:
svn propdel svn:externals
需要注意的是,服務端的任何修改 proto 文件夾內的操作,都會及時可更新到客戶端;但客戶端如果修改了 proto 文件夾中的內容,即使在有權限的情況下,也必須進入 proto 文件夾中提交才可生效,在 proto 文件夾外部提交是不會提交 proto 的內容的,因為本質上, proto 文件夾是對應着另一個不同的SVN。所以這種方法,更適用於一方較頻繁修改,而另一方一般只需要同步的情況下,否則有一方的操作將會有些許麻煩。如還可適用於美術的SVN,同步到客戶端的相應SVN目錄;策划的腳本SVN同步到服務端和客戶端的目錄等需求。
http://game.ceeger.com/forum/read.php?tid=13479
解決 protobuf 在 unity3d 中使用燒IOS版本不能聯網的問題:
http://blog.csdn.net/panda_bear/article/details/9949751
unity2d:
http://unity3d.9tech.cn/news/2014/0213/39832.html
unity 視頻:
http://www.unitymanual.com/topic/video/index.html