使用Kotlinx Serialization时ProGuard配置为何与官方文档不符？

1. 插件与AGP版本不兼容 #

你当前使用的Kotlin Serialization插件版本为2.0.20，若项目中Android Gradle Plugin（AGP）版本与之不匹配，会导致插件自动注入混淆规则的机制失效。官方文档提到的“无需手动配置”是基于插件与AGP版本兼容的前提，版本不匹配时自动注入逻辑无法正常工作。

2. KMP模块间混淆规则传递失效 #

如果序列化实体类放在KMP共享模块中，Android应用模块可能无法正确继承共享模块由插件生成的混淆规则。共享模块作为Android Library，其混淆规则需要通过AGP的依赖传递机制同步到应用模块，若模块配置存在问题（如共享模块未正确启用Android Library插件的混淆支持），就会导致实体类被混淆。

3. 自定义R8规则覆盖默认配置 #

官方文档的结论基于默认R8混淆配置，若你的项目自定义了R8规则（比如开启了更激进的混淆选项、移除了默认规则集），可能会覆盖插件自动注入的规则，导致序列化类的元数据被删除，进而找不到序列化器。

4. 插件重复配置导致生效异常 #

你在项目级和模块级都显式指定了Serialization插件版本，这种重复配置可能导致插件在部分模块中未正确初始化，无法生成对应的混淆规则。建议统一在项目级声明插件并设置apply(false)，模块级直接引用，避免版本冲突或加载异常。

优化建议 #

• 统一插件版本管理：在libs.versions.toml中定义Serialization插件版本，模块级通过alias引用，避免手动指定版本。例如：
  在libs.versions.toml添加：

  [plugins]
  kotlin-serialization = { module = "org.jetbrains.kotlin.plugin.serialization", version = "2.0.20" }
  

  模块级plugins块使用alias(libs.plugins.kotlin.serialization)替代手动声明版本。
• 验证AGP与插件兼容性：对照官方兼容性矩阵，确保Kotlin版本、AGP版本和Serialization插件版本相互匹配。
• 检查自动生成的混淆规则：构建后查看build/outputs/mapping/release/rules.txt，确认是否包含-keep @kotlinx.serialization.Serializable class **类规则，若缺失则说明插件未正确注入规则，需排查模块配置。

内容的提问来源于stack exchange，提问作者Muhammad Ahmed AbuTalib