Google Git
Sign in
android / platform / external / ksp / c4c7782c
commitc4c7782cb88e714026e20d804a6001261f8d3037[log] [tgz]
authorNicklas Ansman <nicklas@ansman.se>Sun Aug 18 20:15:56 2024 -0400
committerlaszio <ting-yuan@users.noreply.github.com>Wed Aug 21 17:39:33 2024 -0700
tree5749103f62adc998eb87aae97cd68bd4e6fd074e
parent54cf06c8f0d91a812d2edb0b495ce424b6004fdd [diff]
Use properties where possible in KspExtension

This PR converts all internal things in KspExtension to be properties
instead of lists and maps. This will ensure that reads are deferred for
as long as possible and will prevent forcing reads during configuration.

Unfortunately some properties cannot be changed without causing changes
to the ABI. New properties could be introduced but the names would have
to be different.
3 files changed
tree: 5749103f62adc998eb87aae97cd68bd4e6fd074e
  1. .github/
  2. api/
  3. benchmark/
  4. buildSrc/
  5. cmdline-parser-gen/
  6. common-deps/
  7. common-util/
  8. compiler-plugin/
  9. docs/
  10. examples/
  11. gradle/
  12. gradle-plugin/
  13. integration-tests/
  14. kotlin-analysis-api/
  15. symbol-processing/
  16. symbol-processing-aa-embeddable/
  17. symbol-processing-cmdline/
  18. test-utils/
  19. .editorconfig
  20. .gitignore
  21. build.gradle.kts
  22. CONTRIBUTING.md
  23. DEVELOPMENT.md
  24. gradle.properties
  25. gradlew
  26. gradlew.bat
  27. LICENSE
  28. README.md
  29. settings.gradle.kts
README.md

Kotlin Symbol Processing API

Welcome to KSP!

Kotlin Symbol Processing (KSP) is an API that you can use to develop lightweight compiler plugins. KSP provides a simplified compiler plugin API that leverages the power of Kotlin while keeping the learning curve at a minimum. Compared to KAPT, annotation processors that use KSP can run up to 2x faster.

Most of the documentation of KSP can be found on kotlinlang.org. Here are some handy links:

For debugging and testing processors, as well as KSP itself, please check DEVELOPMENT.md

KSP2 is in Beta!

KSP2 is a new implementation of the KSP API. It will be faster and easier to use than KSP 1.x. Please refer to the KSP2 introduction for more details.

Nightly Builds

Nightly builds of KSP for the latest Kotlin stable releases are published here.

maven("https://oss.sonatype.org/content/repositories/snapshots")

Feedback and Bug Reporting

Please let us know what you think about KSP by filing a Github issue or connecting with our team in the #ksp channel in the Kotlin Slack workspace!

If you are interested in sending PRs, please also check out the Contributor guide.

Ongoing and Future Works

Here are some planned features that have not yet been completely implemented:

  • Improve support to multiplatform. E.g., running KSP on a subset of targets / sharing computations between targets
  • Improve performance. There are a bunch of optimizations to be done!
  • Keep fixing bugs!