Changes with compatibility implications

• For SIP-51 support, scalaVersion can no longer be a lower 2.13.x version number than its transitive depdencies. See below for details.
• ConsistentAnalysisFormat is enabled by default. See below for details.
• Updates lm-coursier-shaded to 2.1.4, which brings in Coursier 2.1.9 #7513.
• Updates Jsch to mwiede/jsch fork by @azolotko in lm#436
• Updates the Scala version used by sbt 1.x to 2.12.19 by @SethTisue in #7516.

SIP-51 Support for Scala 2.13 Evolution

Modern Scala 2.x has kept both forward and backward binary compatibility so a library compiled using Scala 2.13.12 can be used by an application compiled with Scala 2.13.11 etc, and vice versa. The forward compatibility restricts Scala 2.x from evolving during the patch releases, so in SIP-51 Lukas Rytz at Lightbend Scala Team proposed:

I propose to drop the forwards binary compatibility requirement that build tools enforce on the Scala 2.13 standard library. This will allow implementing performance optimizations of collection operations that are currently not possible. It also unblocks adding new classes and new members to existing classes in the standard library.

Lukas has also contributed changes to sbt 1.10.0 to enforce stricter scalaVersion. Starting sbt 1.10.0, when a Scala 2.13.x patch version newer than scalaVersion is found, it will fail the build as follows:

sbt:foo> run
[error] stack trace is suppressed; run last scalaInstance for the full output
[error] (scalaInstance) expected `foo/scalaVersion` to be "2.13.10" or later,
[error] but found "2.13.5"; upgrade scalaVerion to fix the build.
[error]
[error] to support backwards-only binary compatibility (SIP-51),
[error] the Scala 2.13 compiler cannot be older than scala-library on the
[error] dependency classpath.
[error] see `foo/evicted` to know why scala-library 2.13.10 is getting pulled in.

When you see the error message like above, you can fix this by updating the Scala version to the suggested version (e.g. 2.13.10):

ThisBuild / scalaVersion := "2.13.10"

Side note: Old timers might know that sbt 0.13.0 also introduced the idea of scala-library as a normal dependency. This created various confusions as developers expected scalaVersion, compiler version, and scala-library version as expected to align. With the hindsight, sbt 1.10.0 will continue to respect scalaVersion to be the source-of-truth, but will reject bad ones at build time.

This was contributed by Lukas Rytz in #7480.

Zinc fixes

• Fixes macro undercompilation by invalidating macro call sites when a type parameter changes by @Friendseeker in zinc#1316
• Fixes macro undercompilation by invalidating macro source when its dependency changes by @dwijnand in zinc#1282
• Fixes SAM type undercompilation by @Friendseeker in zinc#1288
• Fixes infinite incremental loop when Scala and Java are involved by @Friendseeker in zinc#1312
• Fixes overcompilation on default parameter changes by @Friendseeker in zinc#1324
• Fixes IncOptions.useOptimizedSealed not working for Scala 2.13 by @Friendseeker in zinc#1278
• Includes extra invalidations in initial validation to fix initial compilation error by @Friendseeker in zinc#1284
• Refixes compact names without breaking local names by @dwijnand in zinc#1259
• Undoes Protobuf workaround for build to work on Apple Silicon by @Friendseeker in zinc#1277
• Uses ClassTag instead of Manifest by @xuwei-k in zinc#1265
• Encodes parent trait private members in extraHash to propagate TraitPrivateMembersModified across external dependency by @Friendseeker in zinc#1289
• Includes internal dependency in extraHash computation by @Friendseeker in zinc#1290
• Deletes products of previous analysis when dropping previous analysis by @Friendseeker in zinc#1293
• Uses the most up-to-date analysis for binary to source class name lookup by @Friendseeker in zinc#1287
• Fixes inconsistent Analysis by removing source stamp caching by @Friendseeker in zinc#1319
• Invalidate sources that depends on @inline methods in Scala 2.x by @Friendseeker in zinc#1310
• Fixes -Xshow-phases handling by @Friendseeker in zinc#1314

ConsistentAnalysisFormat: new Zinc Analysis serialization

sbt 1.10.0 adds a new Zinc serialization format that is faster and repeatable, unlike the current Protobuf-based serialization. Benchmark data based on scala-library reflect compiler:

Since Zinc Analysis is internal to sbt, sbt 1.10.0 will enable this format by default. The following setting can be used to opt-out:

Global / enableConsistentCompileAnalysis := false

This was contributed by Stefan Zeiger at Databricks in zinc#1326.

New CommandProgress API

sbt 1.10.0 adds a new CommandProgress API.

This was contributed by Iulian Dragos at Gradle Inc in #7350.

Other updates

• Updates to JLine 3.24.1 and JAnsi 2.4.1 by @hvesalai/@mazugrin in #7419/#7545
• Supports cross-build for external project ref by @RustedBones in #7389
• Avoids deprecated java.net.URL constructor by @xuwei-k in #7398
• Fixes bug of unmanagedResourceDirectories by @minkyu97 in #7178
• Fixes updateSbtClassifiers task by @azdrojowa123 in #7437
• Fixes packageSrc to include managedSources by @Friendseeker in #7470
• Fixes publishing to use the publisher specified using the publisher setting by @Tammo0987 in #7475
• Fixes eviction warning message by avoid repeating versions by @rtyley in lm#433
• BSP: Implements buildTarget/javacOptions by @adpi2 in #7352
• BSP: Adds noOp field in the compile report by @adpi2 in #7496