Akka HTTP is binary backwards compatible within for all version within the 10.0.x range. However, there are a set of APIs that are marked with the special annotation
@ApiMayChange which are exempt from this rule, in order to allow them to be evolved more freely until stabilising them, by removing this annotation. See The @DoNotInherit and @ApiMayChange markers for further information.
This migration guide aims to help developers who use these bleeding-edge APIs to migrate between their evolving versions within patch releases.
ClientTransportClientTransport SPI and API have changed in #1195.
ClientTransport.TCP is now constant and doesn’t take any parameters any more.
ClientTransport.connectTo now has a new
settings: ClientConnectionSettings parameter. This is a binary and source incompatible change to an
@ApiMayChange API. So far, this API was not documented or exposed so we hope that only few users are affected.
In order to provide a more descriptive name,
HttpApp#route has been renamed to
HttpApp#routes. The previous name might have led to some confusion by wrongly implying that only one route could be returned in that method. To migrate to 10.0.6, you must rename the old
route method to