|
| 1 | +--- |
| 2 | +layout: post |
| 3 | +title: Announcing Scala.js 1.15.0 |
| 4 | +category: news |
| 5 | +tags: [releases] |
| 6 | +permalink: /news/2023/12/29/announcing-scalajs-1.15.0/ |
| 7 | +--- |
| 8 | + |
| 9 | +We are pleased to announce the release of Scala.js 1.15.0! |
| 10 | + |
| 11 | +This release mainly brings a change in how the Scala 2 standard library is versioned in anticipation of |
| 12 | +[SIP 51](https://docs.scala-lang.org/sips/drop-stdlib-forwards-bin-compat.html). |
| 13 | + |
| 14 | +If either of the following applies to you, no action is required: |
| 15 | +- You use sbt-scalajs |
| 16 | +- You exclusively use Scala 3 |
| 17 | + |
| 18 | +Users of other build tools will need to wait for support or temporarily adjust the dependency manually. |
| 19 | + |
| 20 | +Read on for more details. |
| 21 | + |
| 22 | +<!--more--> |
| 23 | + |
| 24 | +## Getting started |
| 25 | + |
| 26 | +If you are new to Scala.js, head over to [the tutorial]({{ BASE_PATH }}/tutorial/). |
| 27 | + |
| 28 | +If you need help with anything related to Scala.js, you may find our community [in `#scala-js` on Discord](https://discord.com/invite/scala) and [on Stack Overflow](https://stackoverflow.com/questions/tagged/scala.js). |
| 29 | + |
| 30 | +Bug reports can be filed [on GitHub](https://github.com/scala-js/scala-js/issues). |
| 31 | + |
| 32 | +## Release notes |
| 33 | + |
| 34 | +If upgrading from Scala.js 0.6.x, make sure to read [the release notes of Scala.js 1.0.0]({{ BASE_PATH }}/news/2020/02/25/announcing-scalajs-1.0.0/) first, as they contain a host of important information, including breaking changes. |
| 35 | + |
| 36 | +This is a **minor** release: |
| 37 | + |
| 38 | +* It is backward binary compatible with all earlier versions in the 1.x series: libraries compiled with 1.0.x through 1.13.x can be used with 1.15.0 without change. |
| 39 | +* Despite being a minor release, 1.15.0 is forward binary compatible with 1.13.x or later. It is *not* forward binary compatible with 1.12.x. Libraries compiled with 1.15.0 can be used with 1.13.x or later but not with 1.12.x or earlier. |
| 40 | +* It is *not* entirely backward source compatible: it is not guaranteed that a codebase will compile *as is* when upgrading from 1.13.x (in particular in the presence of `-Xfatal-warnings`). |
| 41 | + |
| 42 | +As a reminder, libraries compiled with 0.6.x cannot be used with Scala.js 1.x; they must be republished with 1.x first. |
| 43 | + |
| 44 | +## Changes with compatibility concerns |
| 45 | + |
| 46 | +If you are using sbt-scalajs, you do not need to do anything on upgrade. |
| 47 | + |
| 48 | + |
| 49 | + |
| 50 | + |
| 51 | +## Improvements |
| 52 | + |
| 53 | +* Add java.io.FilterReader to the javalib (thanks to @ekrich). |
| 54 | +* Reduce memory usage of the linker with more static string allocation. |
0 commit comments