How google/ksp works
KSP is a Kotlin compiler-plugin API and runtime for annotation-driven symbol processing. The main workflow is that a Gradle or command-line compilation starts KSP, processors query a resolver over source symbols, and the code generator writes outputs for compilation. The graph also includes the documented incremental-processing capability and the distinct Gradle and command-line entry points. The tree and excerpts establish these modules and responsibilities, but do not expose all runtime wiring, so uncertain internal calls are omitted.
Main entry points: KotlinSymbolProcessing.kt KSP engine · SymbolProcessor.kt Processor API · ResolverAAImpl.kt Resolver · KSClassDeclarationImpl.kt Symbol implementations
Components 16
Build integration
- Gradle plugin
gradle-plugin/src/main/kotlin/com/google/devtools/ksp/gradle/KspSubplugin.kt - CLI entry points
kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/cmdline
Processing runtime
- Processor API
api/src/main/kotlin/com/google/devtools/ksp/processing/SymbolProcessor.kt - Symbol model
api/src/main/kotlin/com/google/devtools/ksp/symbol/KSNode.kt - KSP engine
kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/KotlinSymbolProcessing.kt - Resolver
kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/ResolverAAImpl.kt
Symbol analysis
- PSI resolution
kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/common/impl/PsiResolutionStrategy.kt - Analysis API
kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/common/impl/AAResolutionStrategy.kt - Symbol implementations
kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/symbol/kotlin/KSClassDeclarationImpl.kt
Outputs and incrementality
- Code generation
common-util/src/main/kotlin/com/google/devtools/ksp/common/impl/CodeGeneratorImpl.kt - Incremental tracking
kotlin-analysis-api/src/main/kotlin/com/google/devtools/ksp/impl/IncrementalContextAA.kt - Generated sources
Other components
- Processor author
- Gradle build
- CLI invocation
- Kotlin compilation
Connections 14
- Processor author → Processor API: implements
- Gradle build → Gradle plugin: applies
- CLI invocation → CLI entry points: starts
- Gradle plugin → KSP engine: starts processing
- CLI entry points → KSP engine: starts processing
- KSP engine → Resolver: provides
- Resolver → Symbol implementations: exposes symbols
- PSI resolution → Symbol implementations: builds symbols
- Analysis API → Symbol implementations: builds symbols
- Processor API → Resolver: queries
- Processor API → Code generation: writes through
- Code generation → Generated sources: writes
- KSP engine → Incremental tracking: tracks changes
- Generated sources → Kotlin compilation: compiles