The Vaadin Gradle plugin allows you to easily build Vaadin projects with Gradle. It helps with the most tedious tasks when building a Vaadin project like building the widgetset and running development mode. It also helps you to quickly get started by providing tasks for project, component and theme creation.
Build automatically tested on Travis CI
You do not need to compile the plugin from scratch if you want to use it. You only need to add the following line to your projects build.gradle to start using the plugin.
apply from: 'http://plugins.jasoft.fi/vaadin.plugin'
or to use a specific version of the plugin
apply from: 'http://plugins.jasoft.fi/vaadin.plugin?version=x.x.x'
If you are behind a proxy and cannot use the plugin url directly you then you can download the plugin jar from http://vaadin.com/addon/vaadin-plugin-for-gradle and include it in your build.gradle like so:
buildscript {
repositories {
flatDir dirs: '<Directory where the plugin jar can be found>'
}
dependencies {
classpath group: 'fi.jasoft.plugin', name: 'gradle-vaadin-plugin', version: '0.6'
}
}
repositories {
flatDir dirs: '<Directory where the plugin jar can be found>'
}
The following tasks are available in the plugin
createVaadinComponent
- Creates a new Vaadin Component.createVaadinComposite
- Creates a new Vaadin Composite for use with VisualDesigner.createVaadinProject
- Creates a new Vaadin Project.createVaadinServlet3Project
- Creates a new Vaadin project based on Servlet 3.0createVaadinTheme
- Creates a new Vaadin ThemecreateVaadinWidgetsetGenerator
- Creates a new widgetset generator for optimizing the widgetsetdevmode
- Run Development Mode for easier debugging and development of client widgets.superdevmode
- Run Super Development Mode for easier client widget development.themes
- Compiles a Vaadin SASS theme into CSSvaadinRun
- Runs the Vaadin application on an embedded Jetty Serverwidgetset
- Compiles Vaadin Addons and components into Javascript.
The following configuration options are available
vaadin.version
- Vaadin version (Vaadin 6 and 7 supported). Defaults to latest Vaadin 7vaadin.widgetset
- The fully qualified name of the widgetset (eg. com.example.helloworld.MyWidgetset)vaadin.widgetsetGenerator
- The fully qualified name of the widgetset generator.vaadin.servletVersion
- What server version is your application using. Default is 2.5vaadin.debugPort
- On what port should the debugger listen. Default is 8000vaadin.manageWidgetset
- Should the plugin manage the widgetset for you. Default is true.vaadin.manageDependencies
- Should the plugin manage the Vaadin depencies for you. Default is true.vaadin.serverPort
- The port the embedded server listens to. Default is 8080.vaadin.jvmArgs
- Additional JVM arguments passed to the vaadinRun task. Default is ''.vaadin.addon.author
- The author of the Vaadin addon.vaadin.addon.license
- The licence of the Vaadin addon.vaadin.addon.title
- The title for the addon as seen in the Vaadin Directory.vaadin.mainSourceSet
- Defines the main source set where all source files will be generated.vaadin.push
- Should vaadin push be enabled for the application. Default is false.vaadin.debug
- Should the application be run in debug mode. Default is true.
vaadin.gwt.version
- GWT version used with Vaadin 6. Defaults to 2.3.0.vaadin.gwt.style
- Compilation style of the GWT compiler. Default is OBF.vaadin.gwt.optimize
- Optimization level of the GWT compiler. Default is 0.vaadin.gwt.logLevel
- The log level of the GWT compiler. Default is INFO.vaadin.gwt.localWorkers
- The amount of threads the GWT compiler should use. Default is the amount of CPU's available.vaadin.gwt.draftCompile
- Should GWT draft compile be used. Default is false.vaadin.gwt.strict
- Should the GWT Compiler be run in strict mode. Default is false.vaadin.gwt.userAgent
- The browsers you want to support. All browser are supported by default.vaadin.gwt.jvmArgs
- Additional JVM arguments passed to the widgetset compiler. Default is ''.vaadin.gwt.extraArgs
- Extra compiler arguments that should be passed to the widgetset compiler.vaadin.gwt.sourcePaths
- Source folders where GWT code that should be compiled to JS is found. Default is 'client' and 'shared'.vaadin.gwt.collapsePermutations
- Should all permutations be compiled into a single js file for faster compilation time (but larger file size).
vaadin.devmode.noserver
- Do not run the embedded Jetty server when running devmode. Default is false.vaadin.devmode.superDevMode
- Add support for super devmode. Default is false.vaadin.devmode.bindAddress
- The address the DevMode server should be bound to. Default is 127.0.0.1.vaadin.devmode.codeServerPort
- The port the DevMode server should be bound to. Default is 9997.
vaadin.jrebel.enabled
- Should JRebel be used when running the project. Default is falsevaadin.jrebel.location
- Absolute path of jrebel.jar (required ifjrebel.enabled
is set to true)
vaadin.plugin.terminateOnEnter
- Should the vaadinRun and devmode tasks be terminated on enter-key. Default true.vaadin.plugin.logToConsole
- Should server logs be logged to the console or to a log file. Default is logging to file.vaadin.plugin.openInBrowser
- Should the application be opened in a browser tab after the application is launched. Default true.