目录
- 前言
- 一、proto文件示例
- 二、在android中的使用
- 1、 plugin配置
- 2.、基本调用
- 总结
上述就是android开发分享Android中Protobuf的基本使用介绍的全部内容,如果对大家有所用处且需要了解更多关于Android学习教程,希望大家多多关注—计算机技术网(www.ctvol.com)!
前言
protobuf,类似于json和xml,是一种序列化结构数据机制,可以用于数据通讯等场景,相对于xml而言更小,相对于json而言解析更快,支持多语言。
一、proto文件示例
protobuf使用.proto
文件来定义数据格式,所以我们首先新建立一个person.proto
文件,并在文件中填下如下内容:
//指定proto的版本为proto3,不写的话默认为proto2. syntax = "proto3"; //包名 package proto; //引入包 //import ""; //指定生成类所在的java包名 option java_package = "com.example.demowork1"; //重命名,如果不写,默认为文件名的首字母大写转化生成,如android开发分享Android中Protobuf的基本使用介绍件如果不写则是person option java_outer_classname = "personproto"; message person{ string name = 1; int32 id = 2; bool boo = 3; string email = 4; string phone = 5; }
这样我们就定义好了一个基本的person对象,下面我们对文件中的关键字进行一一说明:
**syntax:**指定proto的版本,protobuf目前有proto2和proto3两个常用版本,如果没有声明,则默认是proto2.
**package:**指定包名。
**import:**导入包,类似于java的import.
**java_package:**指定生成类所在的包名
**java_outer_classname:**定义当前文件的类名,如果没有定义,则默认为文件的首字母大写名称
**message:**定义类,类似于java class;可以嵌套
**repeated:**字段可以有多个内容(包括0),类似于array
需要注意的是在声明了属性之后,需要对属性声明一个tag(示例代码中的:1,2,3)。
这个tag是protobuf编码是使用来标识属性的,因此在定义了一个message的属性之后,最好不要再去修改属性的tag值以免造成旧数据解析错误。
二、在android中的使用
protobuf可以在android中进行使用,并且集成对应的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 {}// 生产java源码 } } } }
在完成了上述配置之后,执行一下rebuild方法,这样我们就能够自动生成proto java class文件了。
2.、基本调用
下面我们在module工程中调用一下我们生成的文件,我们先首先生成一个person对象,然后把转换的byte[]再解析一下查看结果是否正确,代码如下:
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) }
执行运行之后,我们能看到正确的输出结果:
com.example.demowork1 d/message: name: "tom" id: 111 email: "123@123.com" phone: "123456789"
总结
到此这篇关于android中protobuf的基本使用介绍的文章就介绍到这了,更多相关android protobuf内容请搜索<计算机技术网(www.ctvol.com)!!>以前的文章或继续浏览下面的相关文章希望大家以后多多支持<计算机技术网(www.ctvol.com)!!>!
本文来自网络收集,不代表计算机技术网立场,如涉及侵权请联系管理员删除。
ctvol管理联系方式QQ:251552304
本文章地址:https://www.ctvol.com/addevelopment/1041114.html