Libra/Getting Started

From Eclipsepedia

< Libra
Revision as of 09:55, 22 February 2011 by Ani koycheva.abv.bg (Talk | contribs)

Jump to: navigation, search

Contents

Getting Started

Overview

The Libra project enables you to use tools that integrate the existing WTP tooling and PDE tooling so that OSGi Enterprise applications can be developed with both tooling at the same time. It also provides you with tools for better experience in the Server-Side Equinox scenario.

Installation

Currently Libra supports only Eclipse Indigo. As a prerequisite you need to install Eclipse IDE for Java EE Developers. After that install Libra from the update site

The site contains:

  • OSGi Facet Feature
  • WAR Products Core Feature

Usage

  • WAR Products Core Feature provides WAR deployment for Equinox based applications
  • OSGi Facet Feature introduces:
    1. A new facet "OSGi Bundle" for Dynamic Web, JPA and Utility projects.
    2. Wizard for converting WTP standard projects to OSGi Enterprise bundle projects:
      • Dynamic Web projects to Web Application Bundle projects
      • JPA projects to Persistent Bundle projects
      • Utility projects and simple Java projects to OSGi Bundle projects
Both options modify project's MANIFEST.MF in order to become a valid OSGi bundle.

The facet may be enabled during project creation or after that from Properties page of the project. The wizard is available from project's context menu Configure > Convert to OSGi Bundle Projects...

Note that you may need to adjust your target platform accordingly.

Obtaining Sources

You can find the sources available in Git repository
In order to synchronize them locally, you may use EGit

Builds

Libra build runs on build.eclipse.org via Hudson using:

Hudson: Libra@hudson.eclipse.org

Maven Build Sequence

Complete build sequence for a clean build (assuming $M2_HOME/bin is on the path and local Maven repository at ~/.m2/repository):

[~/org.eclipse.libra/development/org.eclipse.libra.releng] $ mvn clean install

How to propose and how to commit a patch

The process for proposing and committing a patch is similar to this one. For more information, see the below described procedures.

How to propose a patch

If you want to propose a patch, follow these three quick steps to do that:

  1. Open a bug
  2. Create a patch
  3. Attach the patch to the bug

How to commit a patch

To commit a patch, proceed as follows:

  1. Apply the proposed patch
  2. Test the patch
  3. Commit the patch
  4. Setup push configuration with the following push URL:
    ssh://committer_id@git.eclipse.org/gitroot/libra/org.eclipse.libra.git
  5. Push the patch

How to reproduce a build to a certain change list

Fetch to the specific change and build with Maven as specified above.

Get in touch

Mailing list

https://dev.eclipse.org/mailman/listinfo/libra-dev

Bugzilla

https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Libra

Forum

http://www.eclipse.org/forums/eclipse.libra