如何让Apollo GraphQL Kotlin Codegen生成的Fragment支持序列化？

DevOps 小满

2026-6-27

Apollo GraphQL Kotlin Fragment序列化解决方案

要让codegen自动生成支持序列化的Fragment类，从而能安全保存到实例状态，最便捷的方式是通过配置Apollo插件，让生成的模型自动实现Android常用的Parcelable或者kotx.serialization序列化：

方式一：生成Parcelable实现（Android场景首选）

先在模块的build.gradle.kts中启用kotlin-parcelize插件：

plugins {
    id("com.android.application") // 或 library
    id("org.jetbrains.kotlin.android")
    id("kotlin-parcelize") // 新增该插件
    id("com.apollographql.apollo3")
}

配置Apollo服务生成Parcelable模型：

apollo {
    service("yourServiceName") {
        generateKotlinModels.set(true)
        kotlinModels {
            // 开启自动生成Parcelable实现，覆盖Fragment类
            parcelable.set(true)
        }
    }
}

执行Clean Project后Rebuild，生成的Fragment类会自动带上@Parcelize注解并实现Parcelable接口，直接就能放到SavedStateHandle或者Bundle里保存实例状态。

方式二：生成kotx.serialization序列化支持

如果项目采用kotx序列化体系，也可以配置codegen自动生成序列化注解：

启用kotx序列化插件并添加依赖：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("kotlinx-serialization") // 新增插件
    id("com.apollographql.apollo3")
}

dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.0") // 适配项目的版本
}

配置Apollo服务使用kotx序列化：

apollo {
    service("yourServiceName") {
        generateKotlinModels.set(true)
        kotlinModels {
            serializer.set(KotlinSerializer.KOTX_SERIALIZATION)
        }
    }
}