/jbdevstudio-product

Eclipse Product and Installer builds for JBoss Developer Studio

Primary LanguageJavaOtherNOASSERTION

Red Hat JBoss Developer Studio - Product Build

Summary

Red Hat JBoss Developer Studio is the productization project for JBoss Tools, which includes an update site, izPack installers, sources, and some generated HTML pages.

Upstream projects

Red Hat JBoss Developer Studio uses a parent pom, target platform, and Central Discovery plugin which are not part of this project’s sources. Also upstream are multiple JBoss Tools projects. Sources can be found here:

Download an installer jar or update site zip

Red Hat JBoss Developer Studio is the productization project for JBoss Tools. It can be downloaded in binary form from here:

Build Red Hat JBoss Developer Studio

Building Red Hat JBoss Developer Studio requires Java 8 and Maven 3.

See JBoss Tools Build FAQ for Maven configuration and other tips.

To build product features, site, and installers:

cd jbdevstudio-product; mvn clean verify -DBUILD_ALIAS=GA

To build an RPM, you can then do:

cd jbdevstudio-product/rpm; ./build.sh -clean -mo "--update" \
  -u "https://devstudio.redhat.com/10.0/stable/updates/"

Or, to include the update site your built in the above step, try this:

    cd jbdevstudio-product/rpm; ./build.sh -clean \
      -u "https://devstudio.jboss.com/targetplatforms/jbdevstudiotarget/4.60.1.Final/,\
https://devstudio.jboss.com/targetplatforms/jbtcentraltarget/4.60.1.Final-SNAPSHOT/,\
https://devstudio.jboss.com/10.0/snapshots/builds/jbosstools-discovery.central_master/latest/all/repo/,\
file:///path/to/locally/built/jbdevstudio-product/site/target/repository"

Install Red Hat JBoss Developer Studio

After a successful build, two or more artifacts are produced:

  • installer jar(s)

  • update site (also known as a p2 repository)

Installer jar(s) will be produced in installer/target/ and can be installed with:

java -jar devstudio-*.jar

An unpacked update site, which can be used to perform an initial install or to install updates to a previous installation, can be found in site/target/repository/.

The installer jar can be used as an archived update site. Launch Eclipse or Red Hat JBoss Developer Studio, then select:

Help > Install New Software... > Add... > Archive... >
  Browse for the Red Hat JBoss Developer Studio installer jar > OK >
    Work with: jar:file:/path/to/devstudio-*-installer-*.jar!/ >
      Install the Red Hat JBoss Developer Studio feature(s) >
        Restart when prompted.

Or, to install the "Bring Your Own Eclipse" category or "Core Features" feature into Eclipse (not as an update to an existing Red Hat JBoss Developer Studio install):

  • Help > Install from the generated site in site/target/repository/ (or the installer jar, as noted above

  • Select the ‘Red Hat JBoss Developer Studio (Core Features)’ feature

Update Red Hat JBoss Developer Studio

To update from one version of Red Hat JBoss Developer Studio on the same stream to another (eg., from Red Hat JBoss Developer Studio 10.0 to 10.1):

  • Help > Install from the generated site in site/target/repository/ (or the installer jar, as noted above)

  • Uncheck the box for ‘Group items by category’

  • Select the ‘Red Hat JBoss Developer Studio (Branded Product)’ feature

Contribute fixes and features

Red Hat JBoss Developer Studio is open source, and we welcome anybody that wants to participate and contribute!

If you want to fix a bug or make any changes, please log an issue in the Red Hat JBoss Developer Studio JIRA or the JBoss Tools JIRA describing the bug or new feature.

After you are happy with your changes and a full build runs successfully, attach a patch to the JIRA.

License

Red Hat, Inc. licenses these features and plugins to you under certain open source licenses (or aggregations of such licenses), which in a particular case may include the Eclipse Public License, the GNU Lesser General Public License, and/or certain other open source licenses. For precise licensing details, consult the corresponding source code, or contact Red Hat, Attn: General Counsel, 100 East Davie St., Raleigh NC 27601 USA.