lagom
a0adc728dd75
Update Lagom and ConductR versions in the docs (#698)
Tim Moore
2 days ago
Fixes #575

1 2 3 1 2 3
//#sbt-conductr
addSbtPlugin("com.lightbend.conductr" % "sbt-conductr" % "2.3.0")
addSbtPlugin("com.lightbend.conductr" % "sbt-conductr" % "2.3.4")
//#sbt-conductr

26 27 28 29 30 31 32 33 34 35 36 26 27 28 29 30 31 32 33 34 35 36
1. The sbt Lagom template prompts for the following parameters. Press `Enter` to accept the defaults or specify your own values: * `name` - Becomes the name of the top-level directory. * `organization` - Used as a package name. * `version` - A version number for your system.
* `lagom-version` - The version number of Lagom, such as 1.3.0. Be sure to use the [current stable release](https://www.lagomframework.com/documentation/).
* `lagom-version` - The version number of Lagom, such as 1.3.2. Be sure to use the [current stable release](https://www.lagomframework.com/documentation/).
## Browse the build The build created by the template contains the following elements:

4 5 6 7 8 9 10 11 12 13 14 4 5 6 7 8 9 10 11 12 13 14
## Build changes ### Maven
If you're using a `lagom.version` property in the `properties` section of your root `pom.xml`, then simply update that to `1.3.0`. Otherwise, you'll need to go through every place that a Lagom dependency, including plugins, is used, and set the version there.
If you're using a `lagom.version` property in the `properties` section of your root `pom.xml`, then simply update that to `1.3.2`. Otherwise, you'll need to go through every place that a Lagom dependency, including plugins, is used, and set the version there.
### sbt It is not required, but is recommended, that you upgrade to sbt 0.13.13. To upgrade an existing project to sbt 0.13.13, open `project/build.properties`, and edit the sbt version to be 0.13.13, for example:
...
19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34
When creating new projects, the use of Activator is now deprecated. Instead, you should use sbt 0.13.13's `new` support. This requires upgrading your sbt launcher to 0.13.13. This can be done by downloading and installing it from [the sbt website](http://www.scala-sbt.org/download.html). Once you have upgraded sbt, you then need to upgrade Lagom. This can be done by editing the Lagom plugin version in `project/plugins.sbt`, for example: ```scala
addSbtPlugin("com.lightbend.lagom" % "sbt-plugin" % "1.3.0")
addSbtPlugin("com.lightbend.lagom" % "sbt-plugin" % "1.3.2")
```
If using ConductR with sbt, you should upgrade the ConductR sbt plugin to at least `2.3.4`.
In addition, when importing external Lagom projects into the Lagom development environment, `lagomExternalProject` is now deprecated, and should be replaced with `lagomExternalJavadslProject` or `lagomExternalScaladslProject`. ## Service Info It is now compulsory for Play applications to provide a [[ServiceInfo|ServiceInfo]] programmatically to run in the development environment. If you were providing `lagom.play.service-name` and `lagom.play.acls` via `application.conf` in your Play application, the development mode's `runAll` will still work, but this is now deprecated. If your Play app does not currently include a Guice module, you should add one and use the new `bindServiceInfo` method to configure the service name and ACLs that you wish to expose to the service gateway. The suggested location is `<play_app_folder>/app/Module.java` so that Guice will find it automatically.
## ConductR If using ConductR with sbt, you should upgrade the ConductR sbt plugin to at least `2.2.4`.

24 25 26 27 28 29 30 31 32 33 34 24 25 26 27 28 29 30 31 32 33 34
1. The template prompts for the following parameters. Press `Enter` to accept the defaults or specify your own values: * `name` - Becomes the name of the top-level project directory. * `organization` - Used as a package name. * `version` - A version number for your system.
* `lagom-version` - The version number of Lagom, such as 1.3.0. Be sure to use the [current stable release](https://www.lagomframework.com/documentation/).
* `lagom-version` - The version number of Lagom, such as 1.3.2. Be sure to use the [current stable release](https://www.lagomframework.com/documentation/).
## Browse the build The created project contains the following elements:

2 3 4 5 6 7 8 9 10 11 12 2 3 4 5 6 7 8 9 10 11 12 13
This guide gives a brief description of the steps required to migrate a Lagom 1.2 Java system to a Lagom 1.3 Scala system. ## Build changes
1. Upgrade the Lagom plugin version in `project/plugins.sbt` to `1.3.0`.
1. Upgrade the Lagom plugin version in `project/plugins.sbt` to `1.3.2`. 1. If using ConductR with sbt, you should upgrade the ConductR sbt plugin to at least `2.3.4`.
1. Replace `LagomJava` with `LagomScala`, and any references to `javadsl` components to their `scaladsl` equivalents. ## General code changes Generally, across your codebase, you will need to do the following:
About FluentSend Feedback