[jboss-dev-forums] [JBoss Tools Development] - How To Build JBoss Tools 4.1 FAQ

Nick Boldt [https://community.jboss.org/people/nickboldt] modified the document: "How To Build JBoss Tools 4.1 FAQ" To view the document, visit: https://community.jboss.org/docs/DOC-48358 -------------------------------------------------------------- https://community.jboss.org/4.5.6/images/tiny_mce3/plugins/jiveemoticons/... https://community.jboss.org/4.5.6/images/tiny_mce3/plugins/jiveemoticons/... *Frequently Asked Questions: How Do I Build JBoss Tools 4.1?* * * *+How do I configure my settings.xml?+* * 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 <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"   ....     <profiles        ....         <profile            <id>jboss-default</id            <repositories                <!-- To resolve parent artifact --                <repository                    <id>jboss-public-repository-group</id                    <name>JBoss Public Repository Group</name                    <url>http://repository.jboss.org/nexus/content/groups/public/</url                </repository                <repository                    <id>jboss-snapshots-repository</id                    <name>JBoss Snapshots Repository</name                    <url>https://repository.jboss.org/nexus/content/repositories/snapshots/...                </repository            </repositories             <pluginRepositories                        <!-- To resolve parent artifact --                        <pluginRepository                                <id>jboss-public-repository-group</id                                <name>JBoss Public Repository Group</name                                <url>http://repository.jboss.org/nexus/content/groups/public/</url                        </pluginRepository                        <pluginRepository                                <id>jboss-snapshots-repository</id                                <name>JBoss Snapshots Repository</name                                <url>https://repository.jboss.org/nexus/content/repositories/snapshots/...                        </pluginRepository                </pluginRepositories        </profile    </profiles     <activeProfiles        <activeProfile>jboss-default</activeProfile        ...     </activeProfiles</settings +*My build is failing due to OutOfMemory or PermGen issues! How do I give Maven more memory?*+ +* *+ * To configure the amount of memory used by Maven, you can define MVN_OPTS as follows, either in the mvn / mvn.bat script you use to run Maven, or set as global environment variables. Here's how to do so for http://forums.fedoraforum.org/showthread.php?t=262465 Fedora, https://help.ubuntu.com/community/EnvironmentVariables Ubuntu, http://forums.techarena.in/windows-xp-support/1152405.htm Windows, http://www.digitaledgesw.com/node/31 OSX. set MAVEN_OPTS=-Xms512m -Xmx1024m -XX:PermSize=128m -XX:MaxPermSize=256m +*How do I build via commandline?*+ 1. Fetch code from github 2. Run maven 3. Repeat for other projects cd ~/jbosstools git clone https://github.com/jbosstools/jbosstools-base cd ~/jbosstools/jbosstools-base mvn verify +*How do I build in Eclipse (with m2e)?*+ * With m2e installed, you can either do *CTRL-SHIFT-X,M (Run Maven Build),* or right-click the project and select *Run As > Maven Build*. See https://community.jboss.org/docs/DOC-47936#Building_Locally_In_Eclipse How To Build JBoss Tools 4 - Building Locally In Eclipse +*How do I build a single project?*+ * Generally, you need only fetch the sources, and run `mvn verify`. See 'How do I build via commandline?' or 'How do I build in Eclipse (with m2e)?' above. +* *+ +*How do I build a series of projects (eg., Base, Server, Webservices) ?*+ * Assuming your goal is to change sources in *multiple* projects, then build them all to verify everything still compiles, you will need to fetch sources, then build the projects in dependency order. * This workflow is useful when you're looking to change framework code in an upstream project like Base on which Webservices or Server depends, and verify that API changes don't break the downstream project's code. * Rather than using `mvn verify`, you must use `*mvn install*` so that the downstream build will use YOUR locally-built content in your ~/.m2, rather than looking to the internet for the last published upstream dependencies. cd ~/jbosstools git clone https://github.com/jbosstools/jbosstools-base git clone https://github.com/jbosstools/jbosstools-server git clone https://github.com/jbosstools/jbosstools-webservices cd ~/jbosstools/jbosstools-base; mvn install cd ~/jbosstools/jbosstools-server; mvn install cd ~/jbosstools/jbosstools-webservices; mvn verify +*Which is better - `mvn clean install` or `mvn verify` ?*+ * Use `*install*` to create artifacts in your ~/.m2 folder which will be checked when building anything which depends on those artifacts (in addition to checking the internet). Also useful for doing subsequent offline builds with the `*-o*` or `*--offline*` flag. * Use `*verify*` to build, but NOT install anything into your ~/.m2 folder. +*How do I clean out artifacts I might have installed to my ~/.m2/repo ?*+ +*What if I've already built something locally, but I want to build against the server version instead of my local repo?*+ * There are http://wiki.eclipse.org/Tycho/Target_Platform#Locally_built_artifacts two approaches that work here: 0.1. override temporarily when building, using *-Dtycho.localArtifacts=ignore*, or 0.2. delete *~/.m2/repository/.meta/p2-local-metadata.properties* +*How do I build a target platform?*+ * Currently, you should not need to build a target platform locally if you're building w/ maven via commandline. But if you'd like to materialize a target platform for use in Eclipse, you can do so like this: 1. Fetch target platforms project from github 2. Switch to the correct branch 3. Run maven 4. Results will be in jbosstools/multiple/target/jbosstools-multiple.target.repo/ or jbdevstudio/multiple/target/jbdevstudio-multiple.target.repo/ cd ~/jbosstools git clone https://github.com/jbosstools/jbosstools-target-platforms cd ~/jbosstools/jbosstools-target-platforms git checkout 4.3.0 mvn install cd ~/jbosstools/jbosstools-target-platforms/jbosstools/multiple/target/jbosstools-multiple.target.repo/ +* *+ +*Why is there more than one target platform?*+ * Every time we make changes to the target platform, either to add/remove something, or to change the included version, we release a new version. * In order to verify we can build against the oldest version of a target platform (eg., one based on Eclipse 4.2.0, or "minimum" target platform) but also run tests against the latest for that stream (eg., based on Eclipse 4.2.2, or "maximum" target platform), we need to maintain multiple versions. * By default, your build will use the default "minimum" target platform specified in the JBoss Tools parent pom. To easily build against the default "maximum", use *-Pmaximum*. See also 'What profiles do I need to build? What Maven properties are useful when building?' +*How do I specify which target platform to use when building?*+ * See 'What profiles do I need to build? What Maven properties are useful when building?' +*How to I skip running  tests? How do I make tests not fail? Or only fail after ALL tests run? *+ +* *+ * To skip running tests, you can use these Maven flags:* *-Dmaven.test.skip=true* * *-DskipTests* * If your reason for skipping tests is to see if everything can run without being stuck on the first test failure, you might also like these flags:* *-fae*, *--fail-at-end* : Fail at end of build only * *-fn*, *--fail-never* : Never fail the build regardless of result * You can also cause test failures to result in JUnit output without failing the build using these flags:* *-Dmaven.test.error.ignore=true* * *-Dmaven.test.failure.ignore=true* +*How can I debug tests in Eclipse when run from Tycho (with Surefire)?*+ * See http://www.jboss.org/tools/docs/testing.html http://www.jboss.org/tools/docs/testing.html +*How do I build docs?*+ * See https://community.jboss.org/docs/DOC-13341 Building JBoss Tools Documentation. +*What profiles do I need to build? What Maven properties are useful when building? *+ * Most of the time, you don't need any profiles or -D properties. Here are some profiles and properties you might want to use in special cases. ** *-Pmaximum* : selects the default maximum target platform version instead of the default minimum one. Useful when running tests to verify that your code works against a newer target platform (eg., Eclipse 4.2.2 instead of 4.2.0) ** *-DTARGET_PLATFORM_VERSION* : allows you to pick a specific target platform version from those available in Nexus. * See also 'How to I skip running  tests? How do I make tests not fail? Or only fail after ALL tests run?' above for test-related properties. +*How do I see what's happening on a remote slave running Xvfb? *+ * Look in the build log for 2 lines like these:* Building remotely on ${SLAVE_NAME} in workspace /mnt/hudson/workspace/${JOB_NAME} * Xvfb starting$ Xvfb :1 -screen 0 1024x768x24 -fbdir ${FBDIR} * Get the Xvfb_screen0 file:* rsync -Pzrlt --rsh=ssh --protocol=28 ${USER}@${SLAVE_NAME}:${FBDIR}/Xvfb_screen0 /tmp/ * View the screen w/ xwud:* xwud /tmp/Xvfb_screen0 +* *++*Anything else?*+ * See also this FAQ: https://community.jboss.org/docs/DOC-10796 https://community.jboss.org/wiki/JBossToolsFAQ +* *+ -------------------------------------------------------------- Comment by going to Community [https://community.jboss.org/docs/DOC-48358] Create a new document in JBoss Tools Development at Community [https://community.jboss.org/choose-container!input.jspa?contentType=102&a...]