Version 8.25.2 built on 2024-05-14.

Release Notes for Vaadin Framework 8.25.2

Overview of Vaadin Framework 8.25.2 Release

Vaadin Framework 8.25.2 is a feature release that includes a number of new features and bug fixes, as listed in the list of enhancements below.

Change log for Vaadin Framework 8.25.2

Below is a list of notable user-facing changes for the maintenance releases of Vaadin 8.25.

You can find a full change history starting with Vaadin 8.15.0 in GitHub. Please note, that development of Vaadin Framework 7 and 8 has moved to a private repository as part of the change from Apache 2.0 to Vaadin Commercial License, and as such a Git commit history is not available to the public.

Vaadin 8.25.2

Vaadin 8.25.1

Vaadin 8.25.0

Incompatible or behavior-altering changes in 8.25

Known Issues and Limitations

Getting started with Vaadin Framework

Vaadin Framework is a Java framework for building modern web applications that look great, perform well and make you and your users happy. The Framework is available under the Apache License, Version 2.0 (see the license.html in the Vaadin Framework ZIP package).

The easiest ways to start using Vaadin Framework are:

Vaadin Framework is also available as a ZIP package downloadable from the Vaadin Download page.

Package Contents

Inside the ZIP installation package you will find:

See the README.TXT in the installation package for detailed information about the package contents.

For server-side development, copy the vaadin-server, vaadin-client-compiled, vaadin-shared, and vaadin-themes from the main folder and the dependencies from the lib folder to the WEB-INF/lib folder of your Vaadin project. (The vaadin-client-compiled is necessary if you do not wish to compile the widget set by your own, which you need to do if you use almost any add-on components.)

Migrating from Vaadin Framework 7.7

Most Vaadin Framework 7 applications need some changes when migrating to Vaadin Framework 8. In addition to updating dependencies, all references to Framework 7 style data binding and components using it need to be updated either to use new Framework 8 style data binding or to use the compatibility versions in separate packages.

Vaadin Framework 7 compatible versions of the old data binding API and components (with the exception of Form) are available in the package com.vaadin.v7 in modules vaadin-compatibility-server, vaadin-compatibility-shared etc. that can be used instead of vaadin-server, vaadin-shared etc. The package vaadin-compatibility-client-compiled ontains the widgetset com.vaadin.v7.Vaadin7WidgetSet which can be used instead of DefaultWidgetSet. Please note that the rename to com.vaadin.v7 has only been applied to classes that are only relevant for the compatibility modules. Some classes have also been renamed while still being part of the non-compatibility modules.

All applications using either Reindeer, Runo, Chameleon or Base theme must include the vaadin-compatibility-themes package.

There is a migration tool which helps with some of the migration steps.

Some Vaadin Framework 7 add-ons do not work in version 8 - please check the add-ons in Vaadin Directory for Framework version 8 support.

Common Upgrade Steps

Always when upgrading from an earlier Vaadin Framework version, you must:

Remember also to refresh the project in your IDE to ensure that the new version of everything is in use.

By using the " ?debug " URL parameter, you can verify that the version of the servlet, the theme, and the widget set all match.

Eclipse users should always check if there is a new version of the Eclipse Plug-in available.

Maven users should update the Vaadin Framework dependency version in the pom.xml .

Vaadin Framework 8.25.2 Dependencies

When using Maven, Ivy, Gradle, or other dependency management system, all Framework dependencies are downloaded automatically. This is also the case when using the Vaadin Plugin for Eclipse.

The Vaadin Framework ZIP installation package includes the dependencies in the lib subfolder. These need to be copied to the WEB-INF/lib folder of the web application that uses Vaadin Framework.

The dependencies are listed in the Licensing description. Some are explicit dependencies packaged and distributed as separate JARs, while some are included inside other libraries.

Bean Validation

If you use the bean validation feature, you need a Bean Validation API implementation. You need to install the implementation JAR in the WEB-INF/lib directory of the web application that uses validation.

Supported Technologies

The server-side Vaadin Framework 8 is compatible with Java 8 and 11. Note, that the client-side Java code, compiled using GWT to be run as JS on the browser side, only supports language features up to Java 9 and a subset of JDK libraries. Vaadin Framework 8 is developed and tested with Oracle JDK, but other compliant Java distributions should work as well. More about Java support in FAQ. Vaadin Framework 8 is especially supported on the following operating systems:

Vaadin Framework 8 requires Java Servlet API 3.0 but also supports later versions and should work with any Java application server that conforms to the standard. The following application servers are supported:

Vaadin Framework 8 supports the JSR-286 Portlet specification and all portals that implement the specification should work provided they support Java 8 and Servlet 3.0. The following portals are supported:

Vaadin Framework 8.25.2 supports the following desktop browsers:

Additionally, Vaadin Framework supports the built-in browsers in the following mobile operating systems:

Vaadin on the Web