Migration Guide within Akka HTTP 10.0.x

General Notes

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.

Akka HTTP 10.0.7 -> 10.0.8

ClientTransport SPI / API Changes

ClientTransport 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.

Akka HTTP 10.0.6 -> 10.0.7

HttpApp#route has been renamed to HttpApp#routes

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 routes.

The source code for this page can be found here.