Android中Protobuf的基本使用介紹
前言
Protobuf,類似于json和xml,是一種序列化結(jié)構(gòu)數(shù)據(jù)機制,可以用于數(shù)據(jù)通訊等場景,相對于xml而言更小,相對于json而言解析更快,支持多語言。
一、Proto文件示例
Protobuf使用.proto文件來定義數(shù)據(jù)格式,所以我們首先新建立一個person.proto文件,并在文件中填下如下內(nèi)容:
//指定proto的版本為proto3,不寫的話默認為proto2.
syntax = "proto3";
//包名
package proto;
//引入包
//import "";
//指定生成類所在的Java包名
option java_package = "com.example.demowork1";
//重命名,如果不寫,默認為文件名的首字母大寫轉(zhuǎn)化生成,如本文件如果不寫則是Person
option java_outer_classname = "PersonProto";
message Person{
string name = 1;
int32 id = 2;
bool boo = 3;
string email = 4;
string phone = 5;
}
這樣我們就定義好了一個基本的Person對象,下面我們對文件中的關(guān)鍵字進行一一說明:
**syntax:**指定proto的版本,protobuf目前有proto2和proto3兩個常用版本,如果沒有聲明,則默認是proto2.
**package:**指定包名。
**import:**導(dǎo)入包,類似于java的import.
**java_package:**指定生成類所在的包名
**java_outer_classname:**定義當(dāng)前文件的類名,如果沒有定義,則默認為文件的首字母大寫名稱
**message:**定義類,類似于java class;可以嵌套
**repeated:**字段可以有多個內(nèi)容(包括0),類似于array
需要注意的是在聲明了屬性之后,需要對屬性聲明一個tag(示例代碼中的:1,2,3)。
這個tag是ProtoBuf編碼是使用來標識屬性的,因此在定義了一個message的屬性之后,最好不要再去修改屬性的tag值以免造成舊數(shù)據(jù)解析錯誤。
二、在Android中的使用
protobuf可以在Android中進行使用,并且集成對應(yīng)的Gradle Plugin能夠快速的編譯proto文件。
其基本的編譯流程如下:

下面我們直接使用上面的person.proto文件來舉例說明。
1、 plugin配置
首先我們需要在工程目錄下的build.gradle文件中引入protobuf,示例代碼如下:
buildscript {
ext.kotlin_version = "1.3.72"
repositories {
google()
jcenter()
maven { url "https://jitpack.io" }
mavenCentral()
}
dependencies {
classpath "com.android.tools.build:gradle:4.1.0"
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
classpath 'com.google.protobuf:protobuf-gradle-plugin:0.8.8'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
然后我們還需要在Module目錄下的build.gradle文件下添加配置,示例如下:
plugins {
...
id 'com.google.protobuf'
}
android{
...
sourceSets {
main {
java.srcDirs = ['src/main/java']
jniLibs.srcDirs = ['libs']
assets.srcDirs = ['assets']
proto {
//指定proto文件位置,你的proto文件放置在此文件夾中
srcDir 'src/main/proto'
}
}
}
}
dependencies{
...
implementation 'com.google.protobuf:protobuf-java:3.5.1'
implementation 'com.google.protobuf:protoc:3.5.1'
}
protobuf {
protoc {
artifact = 'com.google.protobuf:protoc:3.5.1' // 也可以配置本地編譯器路徑
}
generateProtoTasks {
all().each { task ->
task.builtins {
remove java
}
task.builtins {
java {}// 生產(chǎn)java源碼
}
}
}
}
在完成了上述配置之后,執(zhí)行一下rebuild方法,這樣我們就能夠自動生成proto java class文件了。
2.、基本調(diào)用
下面我們在Module工程中調(diào)用一下我們生成的文件,我們先首先生成一個Person對象,然后把轉(zhuǎn)換的byte[]再解析一下查看結(jié)果是否正確,代碼如下:
var person1 = PersonProto.Person.newBuilder().setName("Tom")
.setId(111).setBoo(false).setEmail("123@123.com").setPhone("123456789")
.build()
tvData.setOnClickListener {
var dataTemp = PersonProto.Person.parseFrom(person1.toByteArray())
LogUtil.instance.d(dataTemp.toString())
// mHandler.sendEmptyMessage(1)
}
執(zhí)行運行之后,我們能看到正確的輸出結(jié)果:
com.example.demowork1 D/message: name: "Tom"
id: 111
email: "123@123.com"
phone: "123456789"
總結(jié)
到此這篇關(guān)于Android中Protobuf的基本使用介紹的文章就介紹到這了,更多相關(guān)Android Protobuf內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android使用Pull解析器解析xml文件的實現(xiàn)代碼
Android使用Pull解析器解析xml文件的實現(xiàn)代碼,需要的朋友可以參考一下2013-02-02
Android ExpandableListView使用方法案例詳解
這篇文章主要介紹了Android ExpandableListView使用方法案例詳解,本篇文章通過簡要的案例,講解了該項技術(shù)的了解與使用,以下就是詳細內(nèi)容,需要的朋友可以參考下2021-08-08
android studio實現(xiàn)簡單的計算器功能
這篇文章主要為大家詳細介紹了android studio實現(xiàn)簡單的計算器功能,文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下2020-05-05
Android Jetpack 狠活Lifecycles與LiveData使用詳解
這篇文章主要為大家介紹了Android Jetpack 狠活Lifecycles與LiveData使用詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2022-10-10
Android實現(xiàn)一個比相冊更高大上的左右滑動特效(附源碼)
這篇文章主要介紹了Android實現(xiàn)一個比相冊更高大上的左右滑動特效(附源碼),本文給大家介紹的非常詳細,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2021-02-02
Android 用adb pull或push 拷貝手機文件到到電腦上,拷貝手機數(shù)據(jù)庫到電腦上,拷貝電腦數(shù)據(jù)庫到手機上
這篇文章主要介紹了Android 用adb pull或push 拷貝手機文件到到電腦上,拷貝手機數(shù)據(jù)庫到電腦上,拷貝電腦數(shù)據(jù)庫到手機上 的相關(guān)資料,需要的朋友可以參考下2016-01-01
OpenGL中的glutInitDisplayMode()函數(shù)的理解
今天小編就為大家分享一篇關(guān)于OpenGL中的glutInitDisplayMode()函數(shù)的理解,小編覺得內(nèi)容挺不錯的,現(xiàn)在分享給大家,具有很好的參考價值,需要的朋友一起跟隨小編來看看吧2019-04-04
Android調(diào)用系統(tǒng)攝像頭拍照并顯示在ImageView上
這篇文章主要為大家詳細介紹了Android調(diào)用系統(tǒng)攝像頭拍照并顯示在ImageView上,具有一定的參考價值,感興趣的小伙伴們可以參考一下2018-04-04
Android程序開發(fā)之Listview下拉刷新上拉(滑動分頁)加載更多
這篇文章主要介紹了Android程序開發(fā)之Listview下拉刷新上拉(滑動分頁)加載更多的相關(guān)資料,非常不錯,具有參考借鑒價值,需要的朋友可以參考下2016-07-07

