protobuf

時間 2019-12-06

原文原文鏈接

一、下載地址：https://code.google.com/p/protobuf/downloads/listphp

安裝 ./configure && make && make installhtml

二、試執行 protoc 命令，若是提示連接庫錯誤，則執行 ldconfigjava

三、編譯 .proto 文件成 C++ 頭文件和源文件ios

protoc Login.proto --cpp_out=.

注：可使用 protoc *.proto --cpp_out=. 批量編譯多個 proto 文件。 apache

四、上面的 Login.proto 文件內容以下：maven

package s3;
message Login
{
    required string username = 1;
    required string password = 2;
}

解析：看到消息定義中的 1，2 嗎？每一個字段都有惟一的一個標識符，這些標識符是用來在消息的二進制格式中識別各個字段的，一旦開始使用就不可以再改變。其中 1~15 的標識號在編碼的時候會佔用一個字節，16~2047 的標識號則佔用2個字節。因此應該爲那些頻繁出現的消息元素保留 1~15 的標識號。ide

最小的標識號能夠從1開始，最大到2²⁹ - 1, or 536,870,911。不可使用其中的[19000－19999]的標識號， Protobuf協議實現中對這些進行了預留。若是非要在.proto文件中使用這些預留標識號，編譯時就會報警。svn

五、編寫測試文件 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() 函數便可返回可讀性良好的數據。

六、編寫 CMakeLists.txt 以下：

add_executable(test test.cpp Login.pb.cc)
target_link_libraries(test protobuf)

或者直接使用：

g++ test.cpp Login.pb.cc -o test -lprotobuf

七、經常使用方法：

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中解析出消息

八、參考：

http://hideto.iteye.com/blog/445848

開發者指南：http://blog.163.com/jiang_tao_2010/blog/static/12112689020114305013458/

2、JAVA版：

一、下載 apache-maven-3.1.0-bin.tar.gz 解壓，並把 apache-maven-3.1.0/bin 目錄添加到 PATH 變量

二、安裝 JAVA 環境， yum install java && yum install java-devel

三、下載 protobuf-2.5.0.tar.gz 解壓，先安裝 protobuf ，見上面，略。而後進入 protobuf-2.5.0/java 目錄，依次執行 mvn test && mvn install && mvn package

四、通過第三步，在 target 目錄下生成 .jar 文件

詳細參考：

http://blog.csdn.net/sunxinhere/article/details/8225302

http://blog.csdn.net/dodo_check/article/details/8573592

Unity中的使用：

一、首先使用第三方的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

二、關於 protobuf-net 的dll 在unity發佈到IOS機器上是沒法使用的，解決方案請參考：

http://game.ceeger.com/forum/read.php?tid=13479

三、關於 unity 的版本控制：

http://blog.k-res.net/archives/1113.html

四、關於兩個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