search term:

sbt 2.0.0-RC13

Key changes since 2.0.0-RC12

See https://github.com/sbt/sbt/releases/tag/v2.0.0-RC13

Hi everyone. On behalf of the sbt project, I am happy to announce sbt 2.0.0-RC13, a beta version of sbt 2.x. sbt 2.0 is a new version of sbt, based on Scala 3 constructs and Bazel-compatible cache system.

Please try it out, and report any issues you might come across. Note: sbt 2.0.0-RC13 will keep binary compatibility with 2.0.0 and 2.x.

Headline features of sbt 2.0

See also sbt 2.0 change summary for the details.

How to upgrade

Download the official sbt runner for sbt 1.12.11 or later from SDKMAN, or download from https://github.com/sbt/sbt/releases/tag/v1.12.11 to upgrade the sbt shell script, the launcher, and sbtn. Runner can launch any version of sbt.

The sbt version used for your build is upgraded by putting the following in project/build.properties:

sbt.version=2.0.0-RC13

This mechanism allows that sbt 2.0.0-RC13 is used only for the builds that you want.

🐛 Bug fixes

Execution log

sbt 2.0.0 adds experimental execution log feature to debug caching issues. The execution log can be enabled with sbt.experimental_execution_log system property has either true or a file path:

$ sbt --server -Dsbt.experimental_execution_log=true compile

This will generate an execution log file in target/global-logging/exec-log****.log:

{
  "input": {
    "digest": "sha256-a50da1cd086987bc273861a815da4e90ba4735d4a21b965e861e583382a985d6/48",
    "codeContentHash": "murmur3-0000000000000000ffffffffce70de5a/0",
    "extraHash": "murmur3-00000000000000000000000000000000/0",
    "str": "(CompileInputs2(Vector(${CSR_CACHE}/https/repo1.maven.org/maven2/org/scala-lang/scala3-library_3/3.7.4/scala3-library_3-3.7.4.jar, ${CSR_CACHE}/https/repo1.maven.org/maven2/org/scala-lang/scala-library/2.13.16/scala-library-2.13.16.jar),Vector(${BASE}/src/main/scala/example/A.scala),Vector(),Vector(),${OUT}/jvm/scala-3.7.4/testtest/classes,${OUT}/jvm/scala-3.7.4/testtest/zinc/inc_compile_3.zip,Vector((JAVA_CLASS_VERSION,61.0))))"
  },
  "cacheHit": true,
  "exitCode": 0,
  "outputs": ["${OUT}/value/sha256-a50da1cd086987bc273861a815da4e90ba4735d4a21b965e861e583382a985d6/48.json>sha256-f222bfd59f319bb6a2d4d58003b2131c0c42a10cdb4da9df971480ca8d044f7b/179", "${OUT}/jvm/scala-3.7.4/testtest/zinc/inc_compile_3.zip>sha256-8c4b789c3aa4624346a1d0145d15a1c992a6fba4d43fa38f0dc45b829f29157e/878", "${OUT}/jvm/scala-3.7.4/testtest/classes.sbtdir.zip>sha256-722ec6b34b2461dbbc066e434a7707d369f41f2e25e773d9547f19414e5adeb7/1971"]
}

This was contributed by @eed3si9n in #9203.

🚀 Updates

Documentation localization

sbt 2.x documentation is reorganized following the four-documentation principle (Diátaxis).

Most pages are localized, for example why sbt exists (English), sbt の存在理由 (Japanese), and sbt 的存在理由 (Chinese, Simplified). Contributions are welcome in this area as well.

Plugin ecosystem migration

Help us cross build wiki page currently lists dozens of plugins being migrated to sbt 2.x by cross building to sbt 1.x and 2.x. Let us know a plugin you need is missing from the migration effort.

Participation

I work on sbt in my own time with collaboration with Scala Center, Anatolii Kmetiuk (new maintainer), Adrien Piquerez (alumni), and other volunteers, like Kenji Yoshida, Jerry Tan, Matthias Kurz (Play maintainer), and recently Billy Autrey to name a few.

sbt 2.0.0-RC13 was brought to you by many contributors, including those who contributed to sbt 1.x series, migrating plugins, but according to git shortlog -sn --no-merges 00eba85d98c854527125ae1655b5332c19b5afd8...733bcfb23997930915b563e7d27b1a1f6c0490da --not 1.11.x and git shortlog -sn --group=author --group=trailer:co-authored-by --no-merges 242bd18d30c418620024d089b587f6d263d34247...v2.0.0-RC13 --not 1.12.x:

516 Eugene Yokota (eed3si9n)
208 Kenji Yoshida (xuwei-k)
146 Adrien Piquerez
51  Jerry Tan (friendseeker)
37  MkDev11
34  bitloi
30  Scala Steward
21  calm329
15  dependabot[bot]
14  Yasuhiro Tatsuno
13  E.G
11  Anatolii Kmetiuk
11  Pandaman
10  João Ferreira
9 Anton Sviridov
8 Aleksandra Zdrojowa
7 Dream
7 GlobalStar117
7 Matt Dziuban
5 Dairus
4 Martin Duhem
4 john0030710
3 Angel98518
3 Brice Jaglin
3 Li Haoyi
3 gayanMatch
2 Billy Autrey
2 BitToby
2 Brian Hotopp
2 Damian Reeves
2 Daniil Sivak
2 Dmitrii Naumenko
2 Douglas Ma
2 Frank S. Thomas
2 Jame4u
2 Josh Soref
2 Kamil Podsiadło
2 Marco Zühlke
2 Matthew de Detrich
2 Matthias Kurz
2 Michał Pawlik
2 Miguel Vilá
2 NeedmeFordev
2 Pluto
2 Renzo
2 Rikito Taniguchi
2 SID
2 Satoshi Dev
2 byteforge
2 circlecrystalin
2 it-education-md
1 Albert Meltzer
1 BrianHotopp
1 Deborah Funmilola Olaboye
1 Eve
1 Francluob
1 Guillaume Massé
1 Hamza Remmal
1 Hugo van Rijswijk
1 Idan Ben-Zvi
1 Jakub Kozłowski
1 James Roper
1 Karl Yngve Lervåg
1 Lazz
1 Lukas Rytz
1 Nikita Vilunov
1 OlegYch
1 Pegasus
1 Rex Kerr
1 Roberto Tyley
1 Saber
1 SalesforcePeak
1 SlowBrainDude
1 Zainab Ali
1 bohdansolovie
1 chrisrock1124
1 corevibe555
1 dev-miro26
1 dive2tech
1 fireXtract
1 kijuky
1 nathanlao

Thanks to everyone who’s helped improve sbt and Zinc by using them, reporting bugs, improving our documentation, porting builds, porting plugins, and submitting and reviewing pull requests.

For anyone interested in helping sbt, there are many avenues for you to help, depending on your interest. If you’re interested, Contributing, “help wanted”, “good first issue”, and Discussions are good starting points.

FYI - Scala Days talk

I gave a talk in Scala Days 2025 about sbt 2.0 (recording, slide deck).

Scala Center is a non-profit center at EPFL to support education and open source.