KSP 2.0 预览版介绍

Kotlin Symbol Processing (KSP) 2.0 目前处于预览阶段，旨在解决 KSP 1.0 的一些局限性，并支持新的 K2 Kotlin 编译器。Google 软件工程师 Ting-Yuan Huang 和 Jiaxiang Chen 详细解释了 KSP 2.0 的新架构和功能。

KSP 2.0 的新架构

与 KSP 1.0 作为编译器插件实现不同，KSP 2.0 是一个独立的库，无需设置编译器即可运行，并且完全控制其生命周期。这使得以编程方式调用 KSP 和在 KSP 处理器中设置断点变得更加容易。

以下代码片段展示了如何配置 KSP 2.0 并执行以处理符号列表：

val kspConfig = KSPJvmConfig.Builder().apply {
  // 所有配置在此进行
}.build()
val exitCode = KotlinSymbolProcessing(kspConfig, listOfProcessors, kspLoggerImpl).execute()

KSP 2.0 与 K2 编译器的集成

KSP 2.0 使用仍在测试阶段的 Kotlin K2 编译器来处理源代码。然而，如果用户更喜欢使用 K1 编译器，可以通过在 gradle.properties 中设置 languageVersion 来实现。

性能改进

KSP 2.0 解决了 KSP 1.0 中可能导致同一源文件多次编译的问题。通过与 K2 的集成，KSP 2.0 尝试与 K2 编译文件的方式对齐，确保文件只处理一次，从而提高性能。

开发者生产力提升

KSP 2.0 还引入了多项行为变化，以提高开发者的生产力、可调试性和错误恢复能力。

启用 KSP 2.0 预览版

在 KSP 1.0.14 或更高版本中，可以通过在 gradle.properties 中设置以下标志来启用 KSP 2.0 预览版：

ksp.useKSP2=true

KSP 简介

KSP 是一个 API，支持创建插件以扩展 Kotlin 编译器。它以与编译器无关的方式理解 Kotlin 语言特性，如扩展函数、声明站点方差和局部函数。

KSP API 根据 Kotlin 语法在符号级别建模 Kotlin 程序结构。当基于 KSP 的插件处理源程序时，诸如类、类成员、函数和相关参数等构造可供处理器访问，而诸如 if 块和 for 循环等则不可访问。

这使得基于 KSP 的插件比基于 kotlinc 构建的插件更不易碎，尽管后者功能更强大，但严格依赖于编译器版本。