CD2H gitForager

vaadin/framework8-migration-tool

Name: framework8-migration-tool

Owner: Vaadin

Description: Helper tool for migrating from Vaadin Framework 7 to 8

Created: 2016-09-05 07:47:06.0

Updated: 2018-03-06 03:39:20.0

Pushed: 2017-08-18 08:45:47.0

Homepage: null

Size: 36

Language: Java

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Migration Tool for Converting Vaadin Framework 7 Projects to Vaadin Framework 8

This tool has been added to the vaadin-maven-plugin, and can be run with the target `vaadin:upgrade8`. Please refer to the documentation on how to migrate.

Building the Project

Running mvn clean install produces a runnable JAR in the local Maven folder. The project is currently not available in Maven central.

Using the Tool

To convert a Vaadin 7 project, execute the JAR in the project folder, e.g. in “myproject” run

java -jar $HOME/.m2/repository/com/vaadin/framework8-migration-tool/8.0-SNAPSHOT/framework8-migration-tool-8.0-SNAPSHOT.jar

What Is Migrated?

The tool changes

Class imports from com.vaadin.ui to com.vaadin.v7.ui for all components which have been moved to the compatibility package in Vaadin Framework 8.
Declarative (HTML) files to use <vaadin7-text-field> instead of <vaadin-text-field> for all components which have been moved to the compatibility package in Vaadin Framework 8.

The tool does not, and you need to

Update the dependencies in the project from version 7.x to 8.x
Make sure that you are using Java 8
Update any fully-qualified classnames used in the code for classes that have been moved to compatibility packages
Update your vaadin.version property to some Vaadin Framework 8 version (e.g. 8.0.0).
Change project dependencies from vaadin-server to vaadin-compatibility-server
Change project dependencies from vaadin-client-compiled to vaadin-compatibility-client-compiled if you are using com.vaadin.DefaultWidgetSet
Change project widget set from com.vaadin.DefaultWidgetSet to com.vaadin.v7.Vaadin7WidgetSet if you are using DefaultWidgetset. This is typically declared with a @Widgetset annotation in your UI or in the web.xml file.
Recompile your widget set if you are not using com.vaadin.DefaultWidgetSet

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.