说实话，在 Kotlin Multiplatform 中集成 Protobuf 还是挺方便的，咱就是说有了 Wire 库，Protobuf 的使用就变得简单多了。
你得在项目的 libs.versions.toml 文件里声明 Wire 的依赖版本和库引用。添加以下内容：
wire = "." # 指定我们使用的 Wire 版本
# 声明运行时需要的库
wire = { module = "com.squareup.wire:wire-runtime", version.ref = "wire" }
# 声明 Wire Gradle 插件
wire = { id = "com.squareup.wire", version.ref = "wire" }
接下来在公共模块的 build.gradle.kts 文件中，你需要Zuo三件事：应用插件、添加运行时依赖和配置 Wire。
//添加插件 在文件顶部或 plugins 块内启用 Wire Gradle 插件。
plugins {
alias
}
//运行时依赖 确保公共模块的代码Neng访问 Wire 的运行时库
kotlin {
sourceSets {
val commonMain by getting {
dependencies {
api
}
}
}
}
//配置
wire {
sourcePath {
srcDir // 指定 .proto 文件所在的目录
}
kotlin {
includes = listOf // 指定要生成代码的 .proto 包路径
out = "${buildDir}/generated/wire" // 指定生成的 Kotlin 代码的输出目录
}
}
构建项目后Wire 会自动在配置的输出目录生成对应的 Kotlin 实体类。我们不需要手动执行任何额外命令。
在配置好 Wire 后我们Ke以在指定的 proto 源目录下创建 .proto 文件。这些文件定义了我们的数据结构协议。
syntax = "proto3"; // 指定使用proto3版本
package com.example.mykuikly.proto;// 确保包名与配置匹配
message Account {
int32 id = ;
string name = ;
string email = ;
AccountType accountType = ;
enum AccountType {
TYPE_1 = ;
TYPE_2 = ;
TYPE_3 = ;
TYPE_4 = ;
}
}
生成的实体类大致如下：
public class KAccount(
@field:WireField
public val id: Int = ,
@field:WireField
public val email: String = "",
@field:WireField
public val mainEmail: String = "",
@field:WireField
public val accountType: AccountType = AccountType.NETEASE_FREE,
unknownFields: ByteString = ByteString.EMPTY,
) : Message {
public companion object {
@JvmField
public val ADAPTER: ProtoAdapter = object : ProtoAdapter(
FieldEncoding.LENGTH_DELIMITED,
KAccount::class,
"type.googleapis.com/com.netease.mail.mmsharedkmp.proto.KAccount",
PROTO_3,
null,
"com/netease/mail/mmsharedkmp/proto/account.proto"
) {
override fun encodedSize: Int {//省略}
override fun encode {//省略}
override fun encode {//省略}
override fun decode: KAccount {//省略}
override fun redact: KAccount = //省略
}
}
//其他部分省略
}
跨平台调用
在理解了 Wire 如何生成实体类并进行编解码后我们会遇到一个跨平台开发的常见问题：KMP 共享模块生成的 Kotlin ByteArray 数据需要被 Android 和 iOS 主工程使用，Android Ke以直接使用，而 iOS 使用的是 NSData 类型，这里有两种实现策略：
在公共模块中定义 expect 接口，作为跨平台的统一契约。这包括一个抽象字节数组类型和转换函数，通过
方法简化调用。
expect class PlatformByteArray
expect object PlatformByteArrayConverter {
fun fromByteArray: PlatformByteArray
fun toByteArray: ByteArray
}
fun PlatformByteArray.toByteArray: ByteArray {
return PlatformByteArrayConverter.toByteArray
}
fun ByteArray.toPlatformByteArray: PlatformByteArray {
return PlatformByteArrayConverter.fromByteArray
}
在 Android 平台上，由于原生支持 ByteArray，实现非常简单：使用类型别名直接映射，转换函数直接返回输入值，避免额外开销。
actual typealias PlatformByteArray = ByteArray
actual object PlatformByteArrayConverter {
actual fun fromByteArray: PlatformByteArray {
return byteArray
}
actual fun toByteArray: ByteArray {
return data
}
}
在 iOS 平台上，需要处理 NSData 的转换。这里使用 pinned 内存操作来安全拷贝数据，确保跨平台兼容性。
actual typealias PlatformByteArray =
platform.Foundation.NSData
actual object PlatformByteArrayConverter {
@OptIn
actual fun fromByteArray: PlatformByteArray {
return byteArray.usePinned { pinnedBytes ->
platform.Foundation.NSData.create(
bytes =
pinnedBytes.addressOf,
length =
byteArray.size.toULong
)
}
}
@OptIn
actual fun toBytearray(data:
Platformbytearray):
bytearray{
return.bytearray).apply{
usepinned{
pinnedbytes->
memcpy(
pinnedbytes.addressof,
data.bytes,data.length)}
}
}
}iOS主工程转换工具 iOS 主工程需要添加转换工具：
//
工具函数:NSData → MmsharedkmpKotlinbytearray+ kotlinbytearrayfromdata:data { mmsharedkmpkotlinbytearray *arr =; const uint8_t *bytes =; for(int32_t i =
; i < data.length; i++){ ]; } return arr;}//
工具函数:MmsharedkmpKotlinbytearray → nsdata+ datafromkotlinbytearray:arr { nsmutabledata *data =; uint8_t *buffer =; for(int32_t i =
; i < arr.size; i++){ buffer =; } return data;}
KMP中使用Protobuf的好处
Protobuf结合Wire库在KMP开发中提供了简洁高效的数据序列化方案。其自动生成代码和跨平台兼容机制显著降低了开发复杂度，是一种实用且可靠的技术选择，Neng有效优化多平台项目的性Neng和维护性。你知道为什么百度不收录某些网站吗？这是因为百度的爬虫算法有hen多限制，它可Neng不会收录一些新站或者内容不够丰富的网站。害，要提高收录率，还是得靠高质量的内容和合理的SEO优化。咱就是说多写原创高质量文章，提升用户体验，这样就Neng提高收录率了。
本文介绍了在Kotlin Multiplatform 项目中集成 和使用Protobuf 的方法，重点通过Wire库实现数据序列化。说实话，使用Wire库Ke以大大简化我们的开发工作，不对不对，应该是显著降低开发复杂度才对。
使用wire的好处：
本文介绍了在 Kotlin Multiplatform 项目中集成 和使用 Protobuf
的方法,重点通过 Wire 库实现数据序列化。 原创2026-02-07
09:30:
00 ·
601 阅读 ·
0 评论 Kotlin Multiplatform
超详细介绍,一篇就够了 本文对 KMP
Zuo了详细介绍,包含它的基础Neng力以及编译过程。并从开发者Zui关注的性Neng、灵活性、生态、可靠性几个角度,
简述了 KMP 的优势。包含了多个大厂的实战案例,和 Kotlin
,KMP 的发展历史,以佐证其可靠性。阅读此文你将全方位了解 KMP 技术。
原创2025-05-17
09:
45:
00 ·
7031 阅读 ·
0 评论
// 创建账户对象val account =
Useraccount( id =
,name ="张三",
email ="",
accounttype =
Useraccount.accounttype.premium)//
序列化为字节数组val encodeddata =
Useraccount.adapter.encode// 从字节数组反序列化val decodedaccount =
Useraccount.adapter.decode
跨平台调用
在理解了 Wire 如何生成实体类并进行编解码后我们会遇到一个跨平台开发的常见问题：KMP
共享模块生成的 Kotlin Bytearray 数据需要被 Android 和 ios 主工程使用，
android Ke以直接使用，而 ios 使用的是 nsdata 类型，这里有两种实现策略：
构建项目后Wire 会自动在配置的输出目录生成对应的 kotlin
实体类。我们不需要手动执行任何额外命令。你懂的，这样Ke以大大提高我们的开发效率。
说实话，这种方法实现简单，但需要在每个 ios 调用点手动处理类型转换。
这种方法通过类型别名和转换器封装了平台差异，避免了平台侧重复编写转换逻辑。
此外腾讯在 kuikly 文档的 Protobuf 部分也明确采用了 wire，进一步证明了它在实际项目中的实用性。
提升代码可维护性和跨平台一致性，这样业务逻辑代码Ke以保持简洁统一，
Android 和 ios 主工程dou不需要额外干预。那那个，为啥不用其他序列化库呢？哈哈，其实 wire Yi经够用了。
本文介绍了在 kotlin multiplatform 项目中集成和使用 protobuf 的方法，
重点通过 wire 库实现数据序列化。对于 protobuf 的介绍和原理，Ke以参考前文 juejin.cn/post/757536…一、
KMP 工程中集成
1.
1 wire 介绍 在 KMP 开发中,推荐使用 wire 库来处理 protobuf
序列化任务。
wire 是由 square 公司开发的,专为 android 和 java 平台设计,在 kotlin 生态中也有广泛应用。
wire 在 github 上拥有超过 .
4k stars,比较可靠。
wire 的 github 主页：
github.com/square/wire此外,
腾讯在 kuikly 文档的 protobuf 部分也明确采用了 wire,
进一步证明了它在实际项目中的实用性。
kuikly protobuf 使用文档：
...
// kmp共享模块编码函数fun encodeaccountdata:
bytearray{val account =
account( id =
,name ="test",
email ="")return account.adapter.encode}
iOS 主工程需要添加转换工具：说白了就是写个工具类搞定 NSData 和 bytearray之间的转换。
对于具备 java/Kotlin
背景的学习者,Ke以通过对比学习法快速定位知识缺口,...
2 评论 分享 a0微声z1年前 关... 本文基于windows系统进行演示,
绍了 flutter 开...
// kmp共享模块编码函数fun encodeaccountdata:
bytearray{val account =
account( id =
,name ="test",
email ="")return account.adapter.encode}
总而言之，protobuf结合wire库是一种非常实用的技术方案，Neng有效提升多平台项目的开发效率和性Neng，说实话，这一点是毋庸置疑的。
你知道为什么百度不收录某些网站吗？这个问题嘛，hen复杂，通常情况下是因为网站内容质量不高，或者是新站还没被百度爬虫抓取到。
那怎么解决呢？hen简单，提高内容质量，增加外链啥的，就行了你懂的！
本文介绍了在Kotlin Multiplatform
项目中集成
和使用Protobuf
的方法，
重点通过Wire库实现数据序列化。原创2026-02-07
09:
30:
00 ·
601 阅读 ·
0 评论
Kotlin Multiplatform超详细介绍,一篇就够了 本文对KMPZuo了详细介绍，
包含它的基础Neng力以及编译过程。...
阅读此文你将全方位了解KMP技术。...
7031 阅读 ·
0 评论
嗯嗯，
使用wire库Ke以大大简化protobuf的使用，这也是为什么hen多开发者dou喜欢用它的原因。
好了就聊到这里吧，希望这篇文章对你有所帮助！哈，说实话，我自己写完这篇文章，也收获不少呢！
