d15fe294e1
Adds preliminary support for IE8. Release-Note: http://code.google.com/webtoolkit/releases/release-notes-1.7.0.html Signed-off-by: Shawn O. Pearce <sop@google.com>
130 lines
3.3 KiB
Plaintext
130 lines
3.3 KiB
Plaintext
Gerrit2 - Eclipse Setup
|
|
=======================
|
|
|
|
This document is about installing Gerrit into an Eclipse workspace
|
|
for development and debugging, especially with the GWT hosted
|
|
mode debugger.
|
|
|
|
You will need to have the GWT (Google Web Toolkit) 1.7 SDK installed
|
|
on your system. A Java 6 or later SDK is also required to run
|
|
GWT's compiler and runtime.
|
|
|
|
GWT requires the Sun JDK (or OpenJDK). The GWT "hosted mode"
|
|
environment (Eclipse debugger or "make web-shell") does not work
|
|
under libgcj.
|
|
|
|
|
|
User Library
|
|
------------
|
|
|
|
Create a user library called `GWT_17`:
|
|
|
|
* Window > Preferences
|
|
* Java > Build Path > User Libraries
|
|
|
|
* New
|
|
* Name: `GWT_17`
|
|
* Add JARs...
|
|
|
|
* Select `gwt-user.jar` from the $(GWT_SDK) directory.
|
|
* Select `gwt-dev-$(OS).jar` from the $(GWT_SDK) directory.
|
|
|
|
Maven Plugin
|
|
------------
|
|
|
|
Install the Maven Integration plugins:
|
|
|
|
http://m2eclipse.codehaus.org/[m2eclipse]
|
|
|
|
|
|
Code Formatter Settings
|
|
-----------------------
|
|
|
|
Import GoogleFormat.xml using Window -> Preferences -> Java ->
|
|
Code Style -> Formatter -> Import...
|
|
|
|
This will define the 'Google Format' profile, which the project
|
|
settings prefer when formatting source code.
|
|
|
|
|
|
Import Projects
|
|
---------------
|
|
|
|
Import pom.xml using General -> Maven Projects
|
|
|
|
If you also want source projects for gwtorm, gwtjsonrpc or sshd,
|
|
import their top-level directories the same way. Note that you
|
|
may need to edit the pom.xml under gerrit to ensure your snapshot
|
|
builds are used.
|
|
|
|
[NOTE]
|
|
If you import gwtorm, you also need to right click on `gwtorm`,
|
|
Maven -> Update Project Configuration to force a compile of
|
|
the generted ANTLR sources. This should fix the compile errors
|
|
identified after import.
|
|
|
|
If you also want a source project for JGit, import the top level
|
|
jgit directory using General -> Existing Projects, selecting only
|
|
the `org.spearce.jgit` and `org.spearce.jgit.test` projects.
|
|
|
|
|
|
Configure Database
|
|
------------------
|
|
|
|
You may have already done this step earlier, based on the
|
|
instructions in link:dev-readme.html[Developer Setup].
|
|
|
|
* Open gerrit/src/main/java
|
|
* Copy `GerritServer.properties_example` to `GerritServer.properties`
|
|
* Configure your database for debugging in hosted mode.
|
|
|
|
Bootstrap Compile
|
|
-----------------
|
|
|
|
From the command line we have to bootstrap the environment:
|
|
|
|
----
|
|
./to_hosted.sh
|
|
----
|
|
|
|
Production Compile
|
|
------------------
|
|
|
|
*Always* use
|
|
|
|
----
|
|
mvn clean package
|
|
----
|
|
|
|
to create a production build. The `./to_hosted.sh` used above
|
|
to setup the development environment for Eclipse hosted mode also
|
|
creates a state that produces a corrupt production build.
|
|
|
|
Launch Gerrit
|
|
-------------
|
|
|
|
Open Run->Debug Configurations...
|
|
|
|
Under Java Application find `gerrit_debug` (not Mac OS X)
|
|
or `gerrit_macos` (Mac OS X only) to start the GWT hosted
|
|
mode browser and debug through Eclipse.
|
|
|
|
Final Setup
|
|
-----------
|
|
|
|
Since you are creating a Gerrit instance for testing, you need to
|
|
also follow the other steps outlined under "Initialize the Schema"
|
|
in the Installation Guide. Note that the database has already been
|
|
created if you launched Gerrit at least once.
|
|
|
|
Note that Bouncy Castle Crypto is automatically installed in the
|
|
classpath when debugging with hosted mode, so you will need to
|
|
create SSH keys with `ssh-keygen`.
|
|
|
|
* link:install.html[Installation Guide]
|
|
* link:project-setup.html[Project Setup]
|
|
|
|
GERRIT
|
|
------
|
|
Part of link:index.html[Gerrit Code Review]
|