Zinc is the incremental compiler for Scala.
Most Scala developers use it constantly without noticing. It's leveraged by build tools such as sbt, IntelliJ, Maven, Gradle, Mill, Pants, Bazel, and Bloop.
Zinc reduces compilation times without sacrificing correctness. When you change a source file, Zinc analyzes the structure of your code and recompiles only the source files affected by your change. The result should be identical to the output of a clean compile.
Code of conduct
All communication in sbt/*
repositories and chat rooms
is covered by Scala Code of Conduct.
Please be kind and courteous to each other.
Contributing
This project is maintained by Lightbend, the Scala Center, and other OSS contributors.
You're welcome to participate. To learn how, see the CONTRIBUTING guide.
Integrating Zinc
Most Scala users don't need to think about Zinc at all. Just use any of the build tools listed above, and you get Zinc's benefits.
If you're a build tool author, add Zinc to your project with:
libraryDependencies += "org.scala-sbt" %% "zinc" % "$ZINC_VERSION"
where $ZINC_VERSION
is the latest tag pushed to the GitHub repository.
To integrate Zinc, you have two options:
- Interface directly with Zinc APIs and maintain your own integration.
- Use Bloop (which has a compilation server that simplifies tooling integrations).
Note to compiler bridge authors
The compiler bridge classes are loaded using java.util.ServiceLoader. In other words, the class implementing xsbti.compile.CompilerInterface2
must be mentioned in a file named: /META-INF/services/xsbti.compile.CompilerInterface2
.
Acknowledgements
Logo | Acknowledgement |
---|---|
We thank Yourkit for supporting this open-source project with its full-featured profiler. |