Share on:


We are very pleased to announce the final release of Scala 2.11.0!
There have been no code changes since RC4, just improvements to documentation and version bump to the most recent stable version of Akka actors. Here’s the difference between the release and RC4.
Code that compiled on 2.10.x without deprecation warnings should compile on 2.11.x (we do not guarantee this for experimental APIs, such as reflection). If not, please file a regression. We are working with the community to ensure availability of the core projects of the Scala 2.11.x eco-system, please see below for a list. This release is not binary compatible with the 2.10.x series, to allow us to keep improving the Scala standard library.
The Scala 2.11.x series targets Java 6, with (evolving) experimental support for Java 8. In 2.11.0, Java 8 support is mostly limited to reading Java 8 bytecode and parsing Java 8 source. Stay tuned for more complete (experimental) Java 8 support.

New features in the 2.11 series

This release contains all of the bug fixes and improvements made in the 2.10 series, as well as:
The Scala team and contributors fixed 613 bugs that are exclusive to Scala 2.11.0! We also backported as many as possible. With the release of 2.11, 2.10 backports will be dialed back.
A big thank you to everyone who’s helped improve Scala by reporting bugs, improving our documentation, participating in mailing lists and other public fora, and – of course – submitting and reviewing pull requests! You are all awesome.
Concretely, according togit log --no-merges --oneline master --not 2.10.x --format='%aN' | sort | uniq -c | sort -rn, 112 people contributed code, tests, and/or documentation to Scala 2.11.x: Paul Phillips, Jason Zaugg, Eugene Burmako, Adriaan Moors, Den Shabalin, Simon Ochsenreither, A. P. Marki, Miguel Garcia, James Iry, Iain McGinniss, Rex Kerr, Grzegorz Kossakowski, Vladimir Nikolaev, Eugene Vigdorchik, François Garillot, Mirco Dotta, Rüdiger Klaehn, Raphael Jolly, Kenji Yoshida, Paolo Giarrusso, Antoine Gourlay, Hubert Plociniczak, Aleksandar Prokopec, Simon Schaefer, Lex Spoon, Andrew Phillips, Sébastien Doeraene, Luc Bourlier, Josh Suereth, Jean-Remi Desjardins, Vojin Jovanovic, Vlad Ureche, Viktor Klang, Valerian, Prashant Sharma, Pavel Pavlov, Michael Thorpe, Jan Niehusmann, Heejong Lee, George Leontiev, Daniel C. Sobral, Christoffer Sawicki, yllan, rjfwhite, Volkan Yazıcı, Ruslan Shevchenko, Robin Green, Olivier Blanvillain, Lukas Rytz, James Ward, Iulian Dragos, Ilya Maykov, Eugene Yokota, Erik Osheim, Dan Hopkins, Chris Hodapp, Antonio Cunei, Andriy Polishchuk, Alexander Clare, 杨博, srinivasreddy, secwall, nermin, martijnhoekstra, kurnevsky, jinfu-leng, folone, Yaroslav Klymko, Xusen Yin, Trent Ogren, Tobias Schlatter, Thomas Geier, Stuart Golodetz, Stefan Zeiger, Scott Carey, Samy Dindane, Sagie Davidovich, Runar Bjarnason, Roland Kuhn, Roberto Tyley, Robert Nix, Robert Ladstätter, Rike-Benjamin Schuppner, Rajiv, Philipp Haller, Nada Amin, Mike Morearty, Michael Bayne, Mark Harrah, Luke Cycon, Lee Mighdoll, Konstantin Fedorov, Julio Santos, Julien Richard-Foy, Juha Heljoranta, Johannes Rudolph, Jiawei Li, Jentsch, Jason Swartz, James Roper, Havoc Pennington, Evgeny Kotelnikov, Dmitry Petrashko, Dmitry Bushev, David Hall, Daniel Darabos, Dan Rosen, Cody Allen, Carlo Dapor, Brian McKenna, Andrey Kutejko, Alden Torres.
Thank you all very much.
If you find any errors or omissions in these relates notes, please submit a PR!

Reporting Bugs / Known Issues

Please file any bugs you encounter. If you’re unsure whether something is a bug, please contact the scala-user mailing list.
Before reporting a bug, please have a look at these known issues.

Scala IDE for Eclipse

The Scala IDE with this release built in is available from this update site for Eclipse 4.2/4.3 (Juno/Kepler). Please have a look at the getting started guide for more info.

Available projects

The following Scala projects have already been released against 2.11.0! We’d love to include yours in this list as soon as it’s available – please submit a PR to update these release notes.

  1. "org.scalacheck" %% "scalacheck" % "1.11.3"

  2. "org.scalatest" %% "scalatest" % "2.1.3"

  3. "org.scalautils" %% "scalautils" % "2.1.3"

  4. "com.typesafe.akka" %% "akka-actor" % "2.3.2"

  5. "com.typesafe.scala-logging" %% "scala-logging-slf4j" % "2.0.4"

  6. "org.scala-lang.modules" %% "scala-async" % "0.9.1"

  7. "org.scalikejdbc" %% "scalikejdbc-interpolation" % "2.0.0-beta1"

  8. "com.softwaremill.scalamacrodebug" %% "macros" % "0.4"

  9. "com.softwaremill.macwire" %% "macros" % "0.6"

  10. "com.chuusai" %% "shapeless" % "1.2.4"

  11. "com.chuusai" %% "shapeless" % "2.0.0"

  12. "org.nalloc" %% "optional" % "0.1.0"

  13. "org.scalaz" %% "scalaz-core" % "7.0.6"

  14. "com.nocandysw" %% "platform-executing" % "0.5.0"

  15. "com.qifun" %% "stateless-future" % "0.1.1"

  16. "com.github.scopt" %% "scopt" % "3.2.0"

  17. "com.dongxiguo" %% "fastring" % "0.2.4"

  18. "com.github.seratch" %% "ltsv4s" % "1.0.0"

  19. "com.googlecode.kiama" %% "kiama" % "1.5.3"

  20. "org.scalamock" %% "scalamock-scalatest-support" % "3.0.1"

  21. "org.scalamock" %% "scalamock-specs2-support" % "3.0.1"

  22. "com.github.nscala-time" %% "nscala-time" % "1.0.0"

  23. "com.github.xuwei-k" %% "applybuilder70" % "0.1.2"

  24. "com.github.xuwei-k" %% "nobox" % "0.1.9"

  25. "org.typelevel" %% "scodec-bits" % "1.0.0"

  26. "org.typelevel" %% "scodec-core" % "1.0.0"

  27. "com.sksamuel.scrimage" %% "scrimage" % "1.3.20"

  28. "net.databinder" %% "dispatch-http" % "0.8.10"

  29. "net.databinder" %% "unfiltered" % "0.7.1"

  30. "io.argonaut" %% "argonaut" % "6.0.4"

  31. "org.specs2" %% "specs2" % "2.3.11"

  32. "com.propensive" %% "rapture-core" % "0.9.0"

  33. "com.propensive" %% "rapture-json" % "0.9.1"

  34. "com.propensive" %% "rapture-io" % "0.9.1"

  35. "org.scala-stm" %% "scala-stm" % "0.7"

The following projects were released against 2.11.0-RC4, with an 2.11 build hopefully following soon:

  1. "org.scalafx" %% "scalafx" % "8.0.0-R4"

  2. "org.scalafx" %% "scalafx" % "1.0.0-R8"

  3. "org.scalamacros" %% "paradise" % "2.0.0-M7"

  4. "com.clarifi" %% "f0" % "1.1.1"

  5. "org.parboiled" %% "parboiled-scala" % "1.1.6"

  6. "org.monifu" %% "monifu" % "0.4"

Cross-building with sbt 0.13

When cross-building between Scala versions, you often need to vary the versions of your dependencies. In particular, the new scala modules (such as scala-xml) are no longer included in scala-library, so you’ll have to add an explicit dependency on it to use Scala’s xml support.
Here’s how we recommend handling this in sbt 0.13. For the full build and Maven build, seeexample.

  1. scalaVersion := "2.11.0"

  2. crossScalaVersions := Seq("2.11.0", "2.10.3")

  3. // add scala-xml dependency when needed (for Scala 2.11 and newer)

  4. // this mechanism supports cross-version publishing

  5. libraryDependencies := {

  6. CrossVersion.partialVersion(scalaVersion.value) match {

  7. case Some((2, scalaMajor)) if scalaMajor >= 11 =>

  8. libraryDependencies.value :+ "org.scala-lang.modules" %% "scala-xml" % "1.0.1"

  9. case _ =>

  10. libraryDependencies.value

  11. }

  12. }

Important changes

For most cases, code that compiled under 2.10.x without deprecation warnings should not be affected. We’ve verified this by compiling a sizeable number of open source projects.
Changes to the reflection API may cause breakages, but these breakages can be easily fixed in a manner that is source-compatible with Scala 2.10.x. Follow our reflection/macro changelog for detailed instructions.
We’ve decided to fix the following more obscure deviations from specified behavior without deprecating them first.
The following changes were made after a deprecation cycle (Thank you, @soc, for leading the deprecation effort!)
Finally, some notable improvements and bug fixes:
To catch future changes like this early, you can run the compiler under -Xfuture, which makes it behave like the next major version, where possible, to alert you to upcoming breaking changes.


Deprecation is essential to two of the 2.11.x series’ three themes (faster/smaller/stabler). They make the language and the libraries smaller, and thus easier to use and maintain, which ultimately improves stability. We are very proud of Scala’s first decade, which brought us to where we are, and we are actively working on minimizing the downsides of this legacy, as exemplified by 2.11.x’s focus on deprecation, modularization and infrastructure work.
The following language “warts” have been deprecated:
We’d like to emphasize the following library deprecations:
Deprecation is closely linked to source and binary compatibility. We say two versions are source compatible when they compile the same programs with the same results. Deprecation requires qualifying this statement: “assuming there are no deprecation warnings”. This is what allows us to evolve the Scala platform and keep it healthy. We move slowly to guarantee smooth upgrades, but we want to keep improving as well!

Binary Compatibility

When two versions of Scala are binary compatible, it is safe to compile your project on one Scala version and link against another Scala version at run time. Safe run-time linkage (only!) means that the JVM does not throw a (subclass of) LinkageError when executing your program in the mixed scenario, assuming that none arise when compiling and running on the same version of Scala. Concretely, this means you may have external dependencies on your run-time classpath that use a different version of Scala than the one you’re compiling with, as long as they’re binary compatibile. In other words, separate compilation on different binary compatible versions does not introduce problems compared to compiling and running everything on the same version of Scala.
We check binary compatibility automatically with MiMa. We strive to maintain a similar invariant for the behavior (as opposed to just linkage) of the standard library, but this is not checked mechanically (Scala is not a proof assistant so this is out of reach for its type system).


We distinguish forwards and backwards compatibility (think of these as properties of a sequence of versions, not of an individual version). Maintaining backwards compatibility means code compiled on an older version will link with code compiled with newer ones. Forwards compatibility allows you to compile on new versions and run on older ones.
Thus, backwards compatibility precludes the removal of (non-private) methods, as older versions could call them, not knowing they would be removed, whereas forwards compatibility disallows adding new (non-private) methods, because newer programs may come to depend on them, which would prevent them from running on older versions (private methods are exempted here as well, as their definition and call sites must be in the same compilation unit).
These are strict constraints, but they have worked well for us in the Scala 2.10.x series. They didn’t stop us from fixing 372 issues in the 2.10.x series post 2.10.0. The advantages are clear, so we will maintain this policy in the 2.11.x series, and are looking (but not yet commiting!) to extend it to include major versions in the future.


Note that so far we’ve only talked about the jars generated by scalac for the standard library and reflection. Our policies do not extend to the meta-issue: ensuring binary compatibility for bytecode generated from identical sources, by different version of scalac? (The same problem exists for compiling on different JDKs.) While we strive to achieve this, it’s not something we can test in general. Notable examples where we know meta-binary compatibility is hard to achieve: specialisation and the optimizer.
In short, if binary compatibility of your library is important to you, use MiMa to verify compatibility before releasing. Compiling identical sources with different versions of the scala compiler (or on different JVM versions!) could result in binary incompatible bytecode. This is rare, and we try to avoid it, but we can’t guarantee it will never happen.


Just like the 2.10.x series, we guarantee forwards and backwards compatibility of the"org.scala-lang" % "scala-library" % "2.11.x" and"org.scala-lang" % "scala-reflect" % "2.11.x" artifacts, except for anything under the scala.reflect.internal package, as scala-reflect is still experimental. We also strongly discourage relying on the stability of scala.concurrent.impl andscala.reflect.runtime, though we will only break compatibility for severe bugs here.
Note that we will only enforce backwards binary compatibility for the new modules (artifacts under the groupId org.scala-lang.modules). As they are opt-in, it’s less of a burden to require having the latest version on the classpath. (Without forward compatibility, the latest version of the artifact must be on the run-time classpath to avoid linkage errors.)
Finally, Scala 2.11.0 introduces scala-library-all to aggregate the modules that constitute a Scala release. Note that this means it does not provide forward binary compatibility, whereas the core scala-library artifact does. We consider the versions of the modules that "scala-library-all" % "2.11.x" depends on to be the canonical ones, that are part of the official Scala distribution. (The distribution itself is defined by the new scala-dist maven artifact.)

License clarification

Scala is now distributed under the standard 3-clause BSD license. Originally, the same 3-clause BSD license was adopted, but slightly reworded over the years, and the “Scala License” was born. We’re now back to the standard formulation to avoid confusion.