Jonatan Kronqvist 82033e827f Support long in state again (#13692) | 10 years ago | |
---|---|---|
.settings | 10 years ago | |
WebContent | 10 years ago | |
all | 10 years ago | |
build | 10 years ago | |
buildhelpers | 10 years ago | |
checkstyle | 10 years ago | |
client | 10 years ago | |
client-compiled | 10 years ago | |
client-compiler | 10 years ago | |
eclipse | 10 years ago | |
liferay | 10 years ago | |
push | 10 years ago | |
scripts | 10 years ago | |
server | 10 years ago | |
shared | 10 years ago | |
tests/testbench/com/vaadin/tests/components | 10 years ago | |
themes | 10 years ago | |
uitest | 10 years ago | |
.classpath | 10 years ago | |
.gitignore | 10 years ago | |
.project | 11 years ago | |
README.md | 11 years ago | |
build.properties | 10 years ago | |
build.xml | 10 years ago | |
common.xml | 10 years ago | |
gwt-files.xml | 11 years ago | |
ivy-taskdefs.xml | 11 years ago | |
ivysettings-publish.xml | 10 years ago | |
ivysettings.xml | 10 years ago | |
pom-template.xml | 10 years ago | |
publish.properties | 11 years ago | |
publish.xml | 10 years ago |
Vaadin 7 consists of three separate repositories
Start by cloning these repositories into the same folder:
git clone https://github.com/vaadin/vaadin.git
git clone https://github.com/vaadin/gwt.git
git clone https://github.com/vaadin/gwt-tools.git
The vaadin and gwt repositories contain project code. The gwt-tools project only contain dependency jars used by the other projects.
Do not rename the repositories as the rest of this document relies on using the standard naming.
Assuming you have cloned the repositories as described in “Cloning the project repositories” above, you can import the vaadin and gwt projects into Eclipse as follows:
Start Eclipse and use the root checkout folder (the one containing the vaadin, gwt and gwt-tools folders) as the workspace folder
You’ll need the Apache Ivy plug-in for Eclipse to build the project later on, in “Compiling the Default Widget Set and Themes”.
http://www.apache.org/dist/ant/ivyde/updatesite
in the “Work with:” text fieldIf you have installed IvyDE via the Eclipse Marketplace previously, make sure that you also have Apache Ivy Ant Targets installed, which is not included in that IvyDE installation:
If it isn’t included, follow the installation process above, but select only Apache Ivy library > Apache Ivy Ant Tasks
Line width: 72
Format comments: true
Join lines: true
Insert whitespace before closing empty end-tags: true
Indent-using spaces: true
Indentation size: 4
You should now have three projects in your workspace. If the vaadin project does not compile without errors, choose Ivy -> Resolve from the vaadin project popup menu. Now all projects should compile without errors (there might be warnings).
Note that the first compilation takes a while to finish as Ivy downloads dependencies used in the projects.
Compile the default widget set by executing the default target in build/ide.xml in the vaadin project. In Eclipse this is done by opening build/ide.xml, right clicking on it and choosing Run As -> Ant Build.
The vaadin project includes an embedded Jetty which is used for running the UI tests. It is a standard Java application: com.vaadin.launcher.DevelopmentServerLauncher. Launch it in debug mode in Eclipse by right clicking on it and selecting Debug As -> Java Application.
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 (Add ?restartApplication to ensure).
The JUnit tests for the projects can be run using
ant test
Running this in the gwt directory will run the GWT JUnit tests. Running it in the vaadin directory will run the Vaadin JUnit tests.
Running the Vaadin TestBench tests currently requires access to a correctly configured TestBench 2 cluster, only available inside Vaadin.
The distribution files can be built in a few steps. First build the gwt project by running
ant
in the gwt directory. The elemental package needs to be built separately:
ant elemental
Building the elemental package is not possible on Windows as it requires gcc.
Move to the vaadin project directory and unpack the previously built gwt jars
ant -f gwt-files.xml unpack.gwt
Then build the vaadin project by running
ant
in the vaadin directory.