Version 6.8.4 built on 2012-09-28.

Release Notes for Vaadin Framework 6.8.4

Vaadin is a Java application development framework for building modern web applications that look great, perform well and make you and your users happy. Vaadin is available under the Apache 2 license (see license.html in the JAR).

Overview of Vaadin 6.8.4 Release

Vaadin 6.8.4 is a maintenance release that includes a number of important bug fixes.

Changes in Vaadin 6.8.4

This release includes the following closed issues:

The full list of the closed issues can be found at

Enhancements in Vaadin 6.8

Below is a list of enchacements in the current minor release branch, first released in 6.8.0.

Package Contents

Vaadin Framework is distributed as a single JAR file. Inside the JAR you will find:

Vaadin 6.8.4 dependencies

Vaadin uses GWT 2.3.0 for widget set compilation. GWT can be downloaded from GWT can also be automatically downloaded by the Vaadin Plug-in for Eclipse. Please note that GWT 2.3.0 requires the validation-api-1.0.0.GA.jar and validation-api-1.0.0.GA-sources.jar files in addition to gwt-dev.jar and gwt-user.jar for widget set compilation.

Upgrading to Vaadin 6.8

When upgrading from an earlier Vaadin version, you must:

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

Using the "?debug" URL parameter you can verify that the version of the servlet (JAR), the theme and the widgetset all match.

Eclipse users should always check if there is a new version of the Eclipse Plug-in available. The Eclipse Plug-in can be used to update the Vaadin version in the project (Project properties » Vaadin).

Maven users should update the Vaadin dependency version in the pom.xml unless it is defined as LATEST . You must also ensure that the GWT dependency uses the correct version and recompile your project and your widget set.

Liferay and other portal users must install the new vaadin-6.8.4.jar as ROOT/WEB-INF/lib/vaadin.jar in the portal. Additionally the contents of the VAADIN folder from the JAR must be extracted to the ROOT/html/VAADIN directory in the Liferay installation. If your portal uses custom widgets, install the latest version of Vaadin Control Panel for Liferay for easy widget set compilation.

Upgrading from Vaadin 6.5 or earlier

If you are upgrading from 6.5.x or earlier, notice that Vaadin 6.8.4 uses GWT 2.3.0. Upgrade your dependencies as necessary. See the dependencies section for more information.

Upgrading from Vaadin 6.1 or earlier

The way widget sets are created was completely changed in Vaadin 6.2. Existing projects, where custom widgets (a custom widget set) are used, must be migrated when upgrading to Vaadin 6.2 or later. Projects where the default widget set is used do not need migration. See Vaadin 6.2.0 release notes for more details.

Notes and Limitations for Google App Engine

The following instructions and limitations apply when you run a Vaadin application under the Google App Engine.

For other known problems, see open tickets at developer site

Supported technologies

Vaadin is based on Java 5 and it is also compatible with most other operating system supporting Java 5 or newer. Vaadin is supported on the following operating systems:

Vaadin requires Java Servlet API 2.3 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 supports JSR-168 and JSR-286 Portlet specifications. All portals that implement either of the portlet specifications should work. The following portals are supported:

Vaadin also supports Google App Engine.

Vaadin supports the following browsers:

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

Vaadin on the Web