elmot e6ae6a6100 Updated READMEs | pirms 8 gadiem | |
---|---|---|
.settings | pirms 8 gadiem | |
all | pirms 8 gadiem | |
bom | pirms 8 gadiem | |
buildhelpers | pirms 8 gadiem | |
checkstyle | pirms 8 gadiem | |
client | pirms 8 gadiem | |
client-compiled | pirms 8 gadiem | |
client-compiler | pirms 8 gadiem | |
documentation | pirms 8 gadiem | |
eclipse | pirms 8 gadiem | |
liferay | pirms 8 gadiem | |
push | pirms 8 gadiem | |
scripts | pirms 8 gadiem | |
server | pirms 8 gadiem | |
shared | pirms 8 gadiem | |
themes | pirms 8 gadiem | |
uitest | pirms 8 gadiem | |
widgets | pirms 8 gadiem | |
.classpath | pirms 8 gadiem | |
.gitignore | pirms 8 gadiem | |
.project | pirms 8 gadiem | |
LICENSE | pirms 8 gadiem | |
README.md | pirms 8 gadiem | |
build.properties | pirms 8 gadiem | |
common.xml | pirms 8 gadiem | |
ivy-taskdefs.xml | pirms 8 gadiem | |
ivysettings.xml | pirms 8 gadiem | |
pom-template.xml | pirms 9 gadiem | |
pom.xml | pirms 8 gadiem |
Vaadin is a Java framework for building modern web applications that look great, perform well and make you and your users happy.
For instructions about using Vaadin to develop applications, please refer to https://vaadin.com/learn
To contribute, first refer to Contributing Code for general instructions and requirements for contributing code to the Vaadin framework.
Instructions on how to set up a working environments for developing the Vaadin framework follow below.
git clone https://github.com/vaadin/vaadin.git
command or clone the repository your favorite Git tool.
If using Windows, you might want to add these Git settings: core.autocrlf=false
and core.fileMode=false
.mvn install
in the project root.
Note that the first compilation takes a while to finish as maven downloads dependencies used in the projects.Now the project should compile without further configuration.
install
maven goal in vaadin-client-compiled
module root.
In Eclipse this is done by right clicking on vaadin-client-compiled project it and choosing Run As -> Maven Build….install
maven goal in vaadin-themes
module root.
In Eclipse this is done by right clicking on vaadin-themes project it and choosing Run As -> Maven Build….The following preferences need to be set to keep the project consistent. You need to do this especially to be able to contribute changes to the project.
Line width: 72
Format comments: true
Join lines: true
Insert whitespace before closing empty end-tags: true
Indent-using spaces: true
Indentation size: 4
The vaadin project includes an embedded Jetty (com.vaadin.launcher.DevelopmentServerLauncher) which is used for running the UI tests. In Eclipse you can launch it using the included launch configuration: Right click on *eclipse/Development Server (vaadin).launch” and select Debug As -> Development Server (vaadin).
This launches a Jetty on port 8888 which allows you to run any UI class in the project by opening http://localhost:8888/run/<UI class name>?restartApplication in your browser, e.g. http://localhost:8888/run/com.vaadin.tests.components.label.LabelModes?restartApplication (Use ?restartApplication to ensure the correct UI is shown).
The distribution files can be built by running maven goal
maven clean install
in the project root directory.
To use a specific version number, modify <version>
tag in root pom.xml file.
This goal runs all project tests TestBench tests, which require access to a a TestBench cluster, currently only available internally at Vaadin Ltd.
The unit tests for the projects can be run using
ant test
Run UI tests
com.vaadin.launcher.DevelopmentServerLauncher
, Working dir into $MODULE_DIR$
,
Use classpath of module into vaadin-uitest
and click Apply. Now you have a run configuration for UI testsRun SuperDev mode TODO