Jump to: navigation, search

Difference between revisions of "Libra/Getting Started"

m
Line 4: Line 4:
  
 
== Installation and Use  ==
 
== Installation and Use  ==
Currently Libra supports only Eclipse Indigo. As a prerequisite you need to install[http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/indigo/M5/eclipse-java-indigo-M5-win32.zip/ Eclipse IDE for Java EE Developers] and Libra from this [https://hudson.eclipse.org/hudson/view/WTP/job/libra/ws/development/org.eclipse.libra.repository/target/site/ update site]
+
Currently Libra supports only Eclipse Indigo. As a prerequisite you need to install[http://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/indigo/M5/eclipse-java-indigo-M5-win32.zip/ Eclipse IDE for Java EE Developers] and Libra from this [https://hudson.eclipse.org/hudson/view/WTP/job/libra/ws/development/org.eclipse.libra.repository/target/site/ update site]
  
 
The update site contains:
 
The update site contains:
Line 20: Line 20:
  
 
* '''WAR Products Core Feature which provides''' [http://wiki.eclipse.org/RAP/Equinox_WAR_products WAR deployment for Equinox based applications]<br/>
 
* '''WAR Products Core Feature which provides''' [http://wiki.eclipse.org/RAP/Equinox_WAR_products WAR deployment for Equinox based applications]<br/>
SCREENSHOT
+
'''SCREENSHOT'''
 
= Obtaining Sources =
 
= Obtaining Sources =
 
You can find the sources available in [http://git.eclipse.org/c/libra/org.eclipse.libra.git/ Git repository]
 
You can find the sources available in [http://git.eclipse.org/c/libra/org.eclipse.libra.git/ Git repository]
 
<br>In order to synchronize them locally, you may use [http://www.eclipse.org/egit/ EGit]
 
<br>In order to synchronize them locally, you may use [http://www.eclipse.org/egit/ EGit]
 
+
step-by-step procedure
 +
'''Screenshot'''
 
= Builds =
 
= Builds =
Libra build runs on build.eclipse.org via Hudson using:
+
The build is based on [http://maven.apache.org/download.html/ Maven](at least 3.0.0) and Tycho, executed on [https://hudson.eclipse.org/hudson/job/libra/ Hudson] server, hosted at Eclipse Foundation.  
* [http://maven.apache.org/download.html at least Maven 3.0.0]
+
* Tycho
+
 
+
Hudson: [https://hudson.eclipse.org/hudson/job/libra/ Libra@hudson.eclipse.org]
+
  
 
== Maven Build Sequence ==
 
== Maven Build Sequence ==
Line 37: Line 34:
 
[~/org.eclipse.libra/development/org.eclipse.libra.releng] $ mvn clean install
 
[~/org.eclipse.libra/development/org.eclipse.libra.releng] $ mvn clean install
 
</pre>
 
</pre>
 +
<pre> Note that you may need to configure your proxy settings </pre>
  
 
= How to propose and how to commit a patch =
 
= How to propose and how to commit a patch =

Revision as of 08:52, 25 February 2011

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 and Use

Currently Libra supports only Eclipse Indigo. As a prerequisite you need to installEclipse IDE for Java EE Developers and Libra from this update site

The update site contains:

  • OSGi Facet Feature that 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.

SCREENSHOT

Obtaining Sources

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

Builds

The build is based on Maven(at least 3.0.0) and Tycho, executed on Hudson server, hosted at Eclipse Foundation.

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
 Note that you may need to configure your proxy settings 

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.

Send us feedback

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