Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Check whether and which of your modules contain Vaadin implementations.
  2. If they do, get the https://github.com/vaadin/framework8-migration-tool .
    1. Install it locally and run like a Java jar afterwards.
    2. The script automatically changes the imports of the affected classes and thus – in the majority of cases – will make your module(s) compatible with Vaadin 8.
  3. As stated on https://vaadin.com/docs/framework/migration/migrating-to-vaadin8.html, some dependencies have to be added in order to use compatible classes from Vaadin 7 (such as TextField .)

    Change the vaadin-server dependency from 

    Mgnl mini code snippet
    Styleboxed

    <dependency>
    <groupId>com.vaadin</groupId>
    <artifactId>vaadin-server</artifactId>
    <version>7.7.6</version>
    </dependency>

    to 

    Mgnl mini code snippet
    Styleboxed

    <dependency>
    <groupId>com.vaadin</groupId>
    <artifactId>vaadin-compatibility-server</artifactId>
    <version>8.0.0</version>
    </dependency>

    The full list of compatibility packages available for Framework 8:

    • vaadin-compatibility-server
    • vaadin-compatibility-client
    • vaadin-compatibility-client-compiled
    • vaadin-compatibility-shared
    • vaadin-compatibility-themes

    (lightbulb) To be able to use the good new Vaadin 8 features, add also:

    Mgnl mini code snippet
    Styleboxed

    <dependency>
    <groupId>com.vaadin</groupId>
    <artifactId>vaadin-server</artifactId>
    <version>8.0.0</version>
    </dependency>


  4. (warning) Normally, you won't need this step since you have a Magnolia running for you. However, in case you are demoing your module as a custom Vaadin application, then you have to include Vaadin7WidgetSet :

    1. Either annotate the UI class as such with @Widgetset("com.vaadin.v7.Vaadin7WidgetSet"),

    2. or do it in your GW[i]T configuration file by adding <inherits name="com.vaadin.v7.Vaadin7WidgetSet" /> .

The Vaadin widgetset

...

Enterprise Edition Pro

If you had EE Pro 5.4.x or previous and are installing EE Pro 5.6.x, you must replace the widgetset in the magnolia.properties file due to component personalization bringing in new features to the page editor. Either replace or add (depending on the update path):

Code Pro
magnolia.ui.vaadin.widgetset=info.magnolia.widgetset.MagnoliaProWidgetSet

...

Community Edition

The Community Edition uses the MagnoliaWidgetSet :

...