Mickael Istria [
https://community.jboss.org/people/mickael_istria] modified the document:
"How to Build JBoss Tools with Maven 3"
To view the document, visit:
https://community.jboss.org/docs/DOC-16604
--------------------------------------------------------------
**
#Environment_Setup Environment Setup
***
#Prerequisistes Prerequisistes
***
#Maven_and_Java Maven and Java
***
#Maven_settings Maven settings
**
#About_Target_Platform_and_related_profiles About Target Platform and related profiles
***
#Getting_a_local_copy_of_the_Target_Platform_Recommanded Getting a local copy of the
Target Platform (Recommanded)
****
#Set_up Set up
*****
#_Download_TP_as_a_zip_and_install_it_by_yourself Download TP as a zip and install it by
yourself
*****
#OR_use_MavenAnt_to_get_it OR, use Maven+Ant to get it
****
#Use Use
***
#Or_resolving_remotely_with_the_Unified_Target_Platform Or resolving remotely with the
Unified Target Platform
**
#Optional_Build_parent_and_target_platform (Optional) Build parent and target platform
**
#Building_Everything_In_One_Build_Locally_Via_Commandline Building Everything In One
Build Locally Via Commandline
**
#Building_Individual_Components_Locally_Via_Commandline Building Individual Components
Locally Via Commandline
***
#Build_a_component_resolving_to_a_recent_aggregation_build_for_other_JBT_dependencies_Recommanded
Build a component resolving to a recent aggregation build for other JBT dependencies
(Recommanded)
***
#Build_a_component_resolving_to_the_latest_CI_builds_for_other_JBT_dependencies Build a
component resolving to the latest CI builds for other JBT dependencies
***
#Build_a_component_along_with_all_its_dependencies_from_sources_bootstrap_build Build a
component along with all its dependencies from sources ("bootstrap" build)
**
#Building_Locally_In_Eclipse Building Locally In Eclipse
**
#Tips_and_tricks_for_making_BOTH_PDE_UI_and_headless_Maven_builds_happy Tips and tricks
for making BOTH PDE UI and headless Maven builds happy
***
#Check_your_buildproperties Check your build.properties
***
#Check_your_manifestmf_dependencies Check your manifest.mf dependencies
***
#Check_your_buildproperties_557327 Check your build.properties
+*This article is a replacement for its precursor,
https://community.jboss.org/docs/DOC-15513 How to Build JBoss Tools 3.2 with Maven 3.*+
+*Note that this article only discusses building from trunk. If you need to build from a
branch, or switch between branches and/or trunk, see*
https://community.jboss.org/docs/DOC-17497 How to Build JBoss Tools With Maven3 - Working
With Branches+.
h2. Environment Setup
h3. Prerequisistes
1. Java 1.6 SDK
2. Maven 3.0.3
3. About 6 GB of free disk space if you want to run all integration tests for (JBoss AS,
Seam and Web Services Tools) - *requires VPN access*
4. subversion client 1.6.X (should work with lower version as well, but newer versions
may not work as expected)
h3. Maven and Java
Make sure your maven 3 is available by default and Java 1.6 is used.
mvn -version
should print out something like
*pache Maven 3.0.3* (r1075438; 2011-02-28 12:31:09-0500)
*Java version: 1.6.0_25*, vendor: Sun Microsystems Inc.
*Java home: /usr/java/jdk1.6.0_25/jre*
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "2.6.42.3-2.fc15.x86_64", arch:
"amd64", family: "unix"
h3. Maven settings
Follow
https://community.jboss.org/docs/DOC-15170 these instructions to add reference to
JBoss Repositories into your settings.xml. You'll also probably need access to the
SNAPSHOT repository. So here is what you should see in your ~/.m2/settings.xml
{code:xml} ...
jboss-public-repository-group JBoss Public Repository
Group
http://repository.jboss.org/nexus/content/groups/public/
http://repository.jboss.org/nexus/content/groups/public/ ...
jboss-snapshots-repository JBoss Snapshots
Repository
https://repository.jboss.org/nexus/content/repositories/snapshots/
https://repository.jboss.org/nexus/content/repositories/snapshots/ ...
jboss-public-repository-group JBoss Public Repository
Group
http://repository.jboss.org/nexus/content/groups/public/
http://repository.jboss.org/nexus/content/groups/public/ ...
jboss-snapshots-repository JBoss Snapshots
Repository
https://repository.jboss.org/nexus/content/repositories/snapshots/
https://repository.jboss.org/nexus/content/repositories/snapshots/ ...
... {code}
h2. About Target Platform and related profiles
The target platform (TP) lists all dependencies (coming from Eclipse.or and other
3rd-party update sites) that are used by JBoss Tools. This target platform is materialized
as an Eclipse p2 repository (formerly update-site) that is used during build to resolve
dependencies. Target Platform is managed by JBoss Tools people, and only dependencies from
this TP are allowed to be used in code.
If you need a new dependency in the TP, feel free to
https://issues.jboss.org/secure/CreateIssueDetails!init.jspa?pid=10020&am...
open a ticket to request it.
Here are several ways to build locally using this target platform. It's up to you to
choose the one that match your needs:
h3. Getting a local copy of the Target Platform (Recommanded)
* Pros: Speed +++
* Cons: Step to be repeated whenever
https://source.jboss.org/browse/JBossTools/trunk/build/target-platform/un...
target platform changes
h4. Set up
h5. Download TP as a zip and install it by yourself
You can either download the TP as a zip [5] and unpack it into some folder on your disk.
For convenience, the easiest is to unzip into jbosstools/build/target-platform/REPO/,
since that's where the Maven or Ant process will by default operate.
You can do that with any browser or on a command line with curl or similar:
curl -C - -O
http://download.jboss.org/jbosstools/updates/target-platform_3.3.indigo.S...
...
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 606M 100 606M 0 0 164k 0 1:02:54 1:02:54 --:--:-- 172k
and then unzip it here (the default path for -Dlocal.site, which means you can call maven
with +*-Plocal.site*+ and not need to pass in
+*-Dlocal.site=file:///path/to/some/other/folder/*+ as well):
mkdir -p ~/.m2/jbosstools-target-platform_3.3.indigo.SR2/
unzip *.target.zip -d ~/.m2/jbosstools-target-platform_3.3.indigo.SR2/
*(Note that the default path used for <local.site> will change every time a new
target platform is released which is a significant change over the previous (eg., SR1,
SR2), so if this breaks because the default not points at an empty folder, it's time
to get a new TP! Hurray for build-time notification you're using an old target
platform!)*
h5. OR, use Maven+Ant to get it
In that case, you also need Ant 1.8.2 or later*.*
cd jbosstools/build/target-platform
mvn clean install -Pget.local.target
The get.local.target profile will resolve the target platform file, multiple.target, as a
p2 repository on your local disk in ~/trunk/build/target-platform/REPO/. It may take a
while, so you're better off from a speed point-of-view simply fetching the latest zip
[5]. However, if you want to see what actually happens to create the TP (as done in
Hudson) this is the approach to take.
Since the Maven profile is simply a wrapper call to Ant, you can also use Ant 1.8 or later
directly:
cd jbosstools/build/target-platform
ant help # show usage instructions
h4. Use
Just add -*P local.site -Dlocal.site=file:///path/to/target/repository/*
*NOTE:* You must specify a path starting with *file:///* (three or more slashes) to avoid
errors such as "+p2.core.ProvisionException URI has an authority component+".
Examples
*LINUX / MAC USERS*
cd build
mvn clean install -U -B -fae -e -*P local.site
-Dlocal.site=file:///${HOME}/trunk/build/target-platform/REPO/*| tee build.all.log.txt
*WINDOWS USERS*
cd c:\trunk\build
mvn3 clean install -U -B -fae -e -Plocal.site
*-Dlocal.site=file:///C:/trunk/build/target-platform/REPO/* > build.all.log.txt
#
h3. Or resolving remotely with the Unified Target Platform
unified.target refers to the dependency as published in the Target Platfrom repository.
* Pros: No additional thing to do than invoking Maven
* Cons: Speed ---
Consume it by adding* +-Punified.target+* to you Maven invocation command-line
h2. (Optional) Build parent and target platform
This step is only useful if you are actually working on the parent or the target platform
and want to test it locally. Otherwise, Maven will simply retrieve parent and TP from
*https://repository.jboss.org/nexus/content/repositories/snapshots/org/jboss/tools/ JBoss
Nexus* to perform your build.
This is only necessary when the TP change, prior to 3.3.Beta3
svn co
http://svn.jboss.org/repos/jbosstools/trunk jbosstools
cd jbosstools/build/parent
mvn clean install
...
[INFO] Reactor Summary:
[INFO]
[INFO] JBoss Tools Target Platform Definition ............ SUCCESS [0.724s]
[INFO] JBoss Tools Parent ................................ SUCCESS [0.461s]
...
*NOTE: You need not fetch the entire JBoss Tools tree from SVN (or Git
(
http://divby0.blogspot.com/2011/01/howto-partially-clone-svn-repo-to-git....
*Instead, you can just fetch the build/ folder and one or more component folders, then as
before,*
*build the parent pom. After that, go into the component folder and run maven there
(#runmavenpercomponent).*
mkdir jbosstools
cd jbosstools
svn co
http://svn.jboss.org/repos/jbosstools/trunk/
http://svn.jboss.org/repos/jbosstools/trunk/build
svn co
http://svn.jboss.org/repos/jbosstools/trunk/
http://svn.jboss.org/repos/jbosstools/trunk/jmx
cd jbosstools/build/parent
mvn clean install
...
[INFO] Reactor Summary:
[INFO]
[INFO] JBoss Tools Target Platform Definition ............ SUCCESS [0.724s]
[INFO] JBoss Tools Parent ................................ SUCCESS [0.461s]
...
#
h2.
h2. Building Everything In One Build Locally Via Commandline
Assuming you have a local copy of the target platform in
${HOME}/trunk/build/target-platform/REPO/ (as explained previously:
*LINUX / MAC USERS*
cd build
mvn clean install -P local.site
-Dlocal.site=file:///${HOME}/trunk/build/target-platform/REPO/ | tee build.all.log.txt
(tee is a program that pipes console output to BOTH console and a file so you can watch
the build AND keep a log.)
*WINDOWS USERS*
cd c:\trunk\build
mvn3 clean install -P local.site
-Dlocal.site=file:///C:/trunk/build/target-platform/REPO/
or
mvn3 clean install -Plocal.site -Dlocal.site=file:///C:/trunk/build/target-platform/REPO/
> build.all.log.txt
If you downloaded the zip and unpacked is somewhere else, use -Dlocal.site=file:///.../ to
point at that folder instead.
#
h2. Building Individual Components Locally Via Commandline
h3. Build a component resolving to a recent aggregation build for other JBT dependencies
(Recommanded)
* Pros:* You build only your component
* You only need source for your component
* Speed to resolve deps: +
* You get generally the latest build for you component
* Cons:* Takes some time to resolve dependencies on other component
* Can sometimes be out of sync if no build occured recently for a component you rely on
and had some important change. More risk to get out of sync than with the staging site.
Tracked by
https://issues.jboss.org/browse/JBIDE-11516
https://issues.jboss.org/browse/JBIDE-11516
*cd jmx*
mvn clean install -P local.site
-Dlocal.site=file:///${HOME}/trunk/build/target-platform/REPO/
*-Pjbosstools-staging-aggregate*
h3. Build a component resolving to the latest CI builds for other JBT dependencies
* Pros:* You build only your component
* You only need source for your component
* You get generally the latest build for you component
* Cons* Takes some time to resolve dependencies on other component
* Can sometimes be out of sync if no build occured recently for a component you rely on
and had some important change
* Speed to resolve deps: -
This profile is the one use for CI builds on Hudson.
*cd jmx*
mvn clean install -P local.site
-Dlocal.site=file:///${HOME}/trunk/build/target-platform/REPO/
*-Pjbosstools-nightly-staging-composite*
h3. Build a component along with all its dependencies from sources ("bootstrap"
build)
This will build exactly what you have locally
* Pros:* You are sure of the version of sources that is used for your JBT dependencies
* You don't loose time in resolving your JBT deps
* Cons:* You need sources for your dependencies too
* You often build more stuff that what you really want to test
cd ~/trunk/build
mvn clean install -P local.site,*jmx-bootstrap*
-Dlocal.site=file:///${HOME}/trunk/build/target-platform/REPO/ | tee build.jmx.log.txt
#
h2. Building Locally In Eclipse
First, you must have installed m2eclipse into your Eclipse (or JBDS). You can install the
currently supported version from this update site:
http://download.jboss.org/jbosstools/updates/indigo/
http://download.jboss.org/jbosstools/updates/indigo/
Next, start up Eclipse or JBDS and do *File > Import* to import the project(s) you
already checked out from SVN above into your workspace.
https://community.jboss.org/servlet/JiveServlet/showImage/102-16604-38-13...
https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16604-3...
Browse to where you have the project(s) checked out, and select a folder to import pom
projects. In this case, I'm importing the parent pom (which refers to the target
platform pom). Optionally, you can add these new projects to a working set to collect them
in your Package Explorer view.
https://community.jboss.org/servlet/JiveServlet/showImage/102-16604-38-13...
https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16604-3...
Once the project(s) are imported, you'll want to build them. You can either do
*CTRL-SHIFT-X,M (Run Maven Build),* or right-click the project and select *Run As >
Maven Build*. The following screenshots show how to configure a build job.
First, on the *Main* tab, set a *Name*, *Goals*, *Profile*(s), and add a *Parameter*. Or,
if you prefer, put everything in the *Goals* field for simplicity:
+clean install -U -B -fae -e -Plocal.site
-Dlocal.site=file://home/nboldt/tmp/JBT_REPO_Indigo/+
Be sure to check *Resolve Workspace artifacts*, and, if you have a newer version of Maven
installed, point your build at that *Maven Runtime* instead of the bundled one that ships
with m2eclipse.
https://community.jboss.org/servlet/JiveServlet/showImage/102-16604-38-13...
https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16604-3...
On the *JRE* tab, make sure you're using a 6.0 JDK.
https://community.jboss.org/servlet/JiveServlet/showImage/102-16604-38-13...
https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16604-3...
On the *Refresh* tab, define which workspace resources you want to refresh when the
build's done.
https://community.jboss.org/servlet/JiveServlet/showImage/102-16604-38-13...
https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16604-3...
On the *Common* tab, you can store the output of the build in a log file in case it's
particularly long and you need to refer back to it.
https://community.jboss.org/servlet/JiveServlet/showImage/102-16604-38-13...
https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16604-3...
Click *Run* to run the build.
https://community.jboss.org/servlet/JiveServlet/showImage/102-16604-38-13...
https://community.jboss.org/servlet/JiveServlet/downloadImage/102-16604-3...
Now you can repeat the above step to build any other component or plugin or feature or
update site from the JBoss Tools repo. Simply import the project(s) and build them as
above.
h2. Tips and tricks for making BOTH PDE UI and headless Maven builds happy
It's fairly common to have plugins compiling in eclipse while tycho would not work.
Basically you could say that tycho is far more picky compared to Eclipse PDE.
h3.
Check your build.properties
Check build.properties in your plugin. If it has warnings in Eclipse, you'll most
likely end with tycho failing to compile your sources. You'll have to make sure that
you correct all warnings.
Especially check your build.properties to have entries for *source..* and *output..*
*
*
source.. = src/
output.. = bin/
h3. Check your manifest.mf dependencies
A new issue when building against juno shows that all compilation dependencies MUST be
EXPLICITLY mentioned in your manifest.mf list of dependencies. A recent example of how
this can cause compilation errors is the archives module, which failed to build due to the
org.eclipse.ui.views plugin, and its IPropertySheetPage interface, not being found during
the build. After investigation, it was discovered that the archives.ui plugin did not
explicitly declare a dependency on org.eclipse.ui.views.
Inside eclipse and during indigo builds, however, the depencency was found and there were
no compilation errors. This was because a plugin archives.ui explicitly dependend on
(org.eclipse.ui.ide) had an explicit dependency on org.eclipse.ui.views. The IDE was able
to see that archives.ui dependended on org.eclipse.ui.ide, and org.eclipse.ui.ide depended
on org.eclipse.ui.views.
Resolving nested dependencies no longer seems to be guaranteed, and so anything you have a
compilation dependency on must now be explicitly declared in your manifest.mf.
h3. Check your build.properties
--------------------------------------------------------------
Comment by going to Community
[
https://community.jboss.org/docs/DOC-16604]
Create a new document in JBoss Tools Development at Community
[
https://community.jboss.org/choose-container!input.jspa?contentType=102&a...]