Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Libra/Getting Started"

m (Proposing and Committing a Patch)
m
Line 21: Line 21:
 
* '''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]
Line 26: Line 28:
 
step-by-step procedure
 
step-by-step procedure
 
'''Screenshot'''
 
'''Screenshot'''
 +
 +
 +
==Updating/Installing EGit==
 +
 +
*Start your '''Eclipse IDE''' and navigate to '''Help-&gt;Install New Software-&gt;Add...'''
 +
*Enter the software site [http://download.eclipse.org/egit/updates-nightly
 +
*Select the '''Eclipse EGit (Incubation)''' and '''Eclipse JGit (Incubation)''' and press '''Next>''' to finish the installation.
 +
During the installation you will be asked to accept the License Agreements.
 +
 +
 +
'''screenshot'''
 +
 +
==Identifying yourself==
 +
To identify yourself read these instructions [http://wiki.eclipse.org/EGit/User_Guide#Identifying_yourself/ these instructions]
 +
 +
==Setting up the Home Directory on Windows==
 +
To set up the '''HOME''' directory read [http://wiki.eclipse.org/EGit/User_Guide#Setting_up_the_Home_Directory_on_Windows/ these instructions]
 +
 +
==Configuring SSH in Eclipse==
 +
To configure ssh read [http://wiki.eclipse.org/EGit/User_Guide#Eclipse_SSH_Configuration/ these instructions]
 +
 +
==Clone Git Repository==
 +
 +
* Open the '''Git Repository Exploring''' perspektive and in the '''Git Repositories''' view press the '''Clone a Git Repository''' toolbar button
 +
* In the '''URI''' field of the opened '''Clone Git Repository''' wizard enter the URI of the libra git repository: [git://git.eclipse.org/gitroot/libra/org.eclipse.libra.git] and press '''Next'''
 +
 +
'''Screenshot'''
 +
 +
* Select the added repository and from its context menu choose '''Import Projects...'''
 +
* Expand the repository tree to '''Remote Tracking''' level, select the remote branch '''origin/master''' and from its context menu choose '''Create Branch...''' to create a new local branch
 +
 +
==Updating Sources==
 +
To keep the sources up to date you have to [http://wiki.eclipse.org/EGit/User_Guide#Pulling_New_Changes_from_Upstream_Branch/ pull the new changes from the upstream branch]
 +
 +
 +
 
= Builds =
 
= Builds =
 
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.  
 
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.  
Line 69: Line 107:
 
== Forum ==
 
== Forum ==
 
[http://www.eclipse.org/forums/eclipse.libra http://www.eclipse.org/forums/eclipse.libra]
 
[http://www.eclipse.org/forums/eclipse.libra http://www.eclipse.org/forums/eclipse.libra]
 +
'''Bold text'''

Revision as of 12:02, 28 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


Updating/Installing EGit

  • Start your Eclipse IDE and navigate to Help->Install New Software->Add...
  • Enter the software site [http://download.eclipse.org/egit/updates-nightly
  • Select the Eclipse EGit (Incubation) and Eclipse JGit (Incubation) and press Next> to finish the installation.

During the installation you will be asked to accept the License Agreements.


screenshot

Identifying yourself

To identify yourself read these instructions these instructions

Setting up the Home Directory on Windows

To set up the HOME directory read these instructions

Configuring SSH in Eclipse

To configure ssh read these instructions

Clone Git Repository

  • Open the Git Repository Exploring perspektive and in the Git Repositories view press the Clone a Git Repository toolbar button
  • In the URI field of the opened Clone Git Repository wizard enter the URI of the libra git repository: [1] and press Next

Screenshot

  • Select the added repository and from its context menu choose Import Projects...
  • Expand the repository tree to Remote Tracking level, select the remote branch origin/master and from its context menu choose Create Branch... to create a new local branch

Updating Sources

To keep the sources up to date you have to pull the new changes from the upstream branch


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 

Proposing and Committing a Patch

The patch file contains a description of changes of a set of resources which can be automatically applied to another eclipse workspace or git repository. If you want to propose or commit a patch you need to know that the Eclipse update hook will examine the Committer's entries of an incoming push. All the committer's entries have to be made by the committer performing the push, otherwise the push will fail. Furthermore, your committer ID, or the committer e-mail address registered with your committer account at the Eclipse Foundation must be present in the Committer Email record. For more information on that restriction see: this page.

Proposing a Patch

If you want commit a change on a local feature or bugfix branch and then to export this change into a patch file, follow the steps below:

  1. Open a bug
    • Specify the bug component (General; OSGi Facet or WAR)
    • Complete the fields about the product version, bug severity, type of your hardware, operating systems and write a summary and description of the patch
  2. Open the History view of your Eclipse IDE and choose Create Patch... (The patch file will contain the difference between the commit and its parent in the history view. Note that the filter of the history view applies also for patch creation.)
  3. Start the Patch Wizard, select the location of the patch and choose Next (The name of the patch file is created from the first line of the commit message.)
  4. Change the patch format, if necessary.
  5. Attach the patch created to the bug
  6. Submit the bug

Committing a Patch

To commit a patch, proceed as follows:

  1. Apply the proposed patch using the Patch Wizard
  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 and see its change number in order to be able to inspect it

Reproducing a Build to a Certain Change List

Fetch to the specific change and build with Maven as described 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 Bold text

Back to the top