Skip to main content

Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "CDO Source Installation (CVS, deprecated)"

Line 1: Line 1:
−
'''(Includes Net4j Source installation)'''<br>
+
== Introduction ==
−
<br>
+
This tutorial describes how to install the CDO workspace using Buckminster. It replaces the old tutorial which can be found here.
−
<br>
+
−
__TOC__
+
  
−
<br>
+
== Prepare the IDE ==
−
==Introduction==
+
Download and install Eclipse 3.6 from http://download.eclipse.org/eclipse/downloads
−
This page explains how to install an Eclipse workspace that is ready to be used to develop and build [[CDO]] and [[Net4j]] (subsequently subsumed as ''CDO workspace'').
+
  
−
The CDO workspace will be configured with a dedicated [[#Java Development Kit|JDK]], connected with a dedicated [[#Target Platform|target platform]] to be built against and associated with a dedicated [[#API Baseline|API Baseline]] to be checked for API compliance against.
+
Then open a fresh development workspace.
  
−
As a consequence of the usage of a dedicated target platform you're free to choose any version of Eclipse as your IDE, recent versions preferred. We are using latest I-builds of Eclipse and some tools like [http://www.eclipse.org/mylyn Mylyn].
+
[[Image:Cdo_install1.png]]
  
−
Further we are using a common development folder <tt>C:\develop</tt> on the local file system which is the parent folder of the IDE installation/extensions, the workspaces folder and the downloads folder. It looks like:<br>[[Image:DevelopFolder.png]]
 
  
−
With this new version of the setup instructions most of the complicated steps like downloading needed prerequisites, unzipping and copying them are automated by an Ant script (which is described in the [[#Bootstrap|bootstrap chapter]]. There are still the [[CDO Source Installation (deprecated)|deprecated manual CDO Source Installation]] instructions available for archive purposes.
+
Add the following plug-ins from the Helios p2 repository (http://download.eclipse.org/releases/helios)
  
−
The following instructions are based on these assumptions:
+
Install the following:
−
* You want to work on the HEAD development stream. You would have to adjust the bootstrap steps to switch to another stream or version.
+
* EMF 2.6 SDK
−
* You have basic knowledge about [[JDT]] and [[PDE]].
+
* Buckminster 3.6 Core
−
* You are working on a plain old Windows box.
+
* Buckminster 3.6 CVS Support
 +
* Buckminster 3.6 PDE Support
  
−
<br>
 
  
−
== Bootstrap ==
+
[[Image:Cdo_install2.png]]
  
−
*Create the host workspace folder <tt>C:\develop\ws\cdo</tt> in the file system
+
[[Image:Cdo_install3.png]]
−
*Start your Eclipse IDE with <tt>C:\develop\bin\eclipse\eclipse.exe -data C:\develop\ws\cdo</tt>
+
 
−
*Switch to the ''Plug-in Development'' perspective
+
Now you have prepared your IDE with the required tools.
−
*Import your existing preferences (optional)
+
 
−
*Configure a JDK 1.5 of your choice on the ''Installed JREs'' preference page
+
== Create the Target Platform ==
−
*Set the ''Compiler compliance level'' to 1.5 on the ''Java Compiler'' preference page
+
 
−
*Choose one of the ''bootstrap Team PSFs'' and store it somewhere in your file system (we use <tt>C:\develop\ws\cdo\bootstrap.psf</tt>):
+
For the target platfrom first create an empty project called "_target".
−
**[http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/develop/setup/psf/pserver/.bootstrap.psf?root=Modeling_Project&view=co For anonymous users] (pserver)
+
 
−
**[http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/develop/setup/psf/extssh/.bootstrap.psf?root=Modeling_Project&view=co For committers] (extssh)
+
[[Image:Cdo_install4.png]]
−
*Committers: Don't forget to setup a maintenance workspace by switching the <tt>develop.setup</tt> project to the maintenance branch, currently <tt>R2_0_maintenance</tt>!
+
 
−
*Import the downloaded bootstrap Team PSF (ignoring potential warnings about "partial repository" bla bla):<br>[[Image:Bootstrap1.png]]<br><br>
+
 
−
*Now your CDO workspace should look like this:<br>[[Image:Bootstrapped.png]]<br><br>
+
Now create an empty target definition that Buckminster later can fill with the needed plug-ins (Windows->Preferences->Plugin Development->Target Platform)
−
*Consult and potentially adjust <tt>urls-baseline.txt</tt> and <tt>urls-target.txt</tt>.
+
 
 +
 
 +
[[Image:Cdo_install5.png]]
 +
 
 +
 
 +
Insert the name for the target platform.
 +
 
 +
[[Image:Cdo_install6.png]]
  
−
'''in order to have it working on linux:'''
 
 
   
 
   
−
adjust url-target.txt and url.baseline.txt:
+
 
 +
Click 'Add'.
 +
 
 +
[[Image:Cdo_install7.png]]
 +
 
 +
 
 +
 
 +
Add the directory location ${workspace_loc}/_target.
 +
 
 +
[[Image:Cdo_install8.png]]
 +
 
 +
 
 +
Activate the platform.
 +
 
 +
[[Image:Cdo_install9.png]]
 +
 
 +
== Bootstrap the Releng Project ==
 +
 
 +
Now you need to bootstrap the releng project.
 +
 
 +
http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/releng/org.eclipse.emf.cdo.releng/psf/pserver/_bootstrap.psf?root=Modeling_Project&view=co
 +
 
 +
Committers use:
 +
http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/releng/org.eclipse.emf.cdo.releng/psf/extssh/_bootstrap.psf?root=Modeling_Project&view=co
 +
 
 +
Right click the Package Explorer and choose Imort->Team Project Set. Select the downloaded _bootstrap.psf
 +
 
 +
[[Image:Cdo_install10.png]]
 +
 
 +
[[Image:Cdo_install11.png]]
 +
 
 +
[[Image:Cdo_install12.png]]
 
   
 
   
−
replace http://download.eclipse.org/eclipse/downloads/drops/R-3.5-200906111540/eclipse-SDK-3.5-win32.zip by
 
−
 
 
−
http://download.eclipse.org/eclipse/downloads/drops/R-3.5-200906111540/eclipse-SDK-3.5-linux-gtk.tar.gz '''OR'''
 
−
http://download.eclipse.org/eclipse/downloads/drops/R-3.5-200906111540/eclipse-SDK-3.5-linux-gtk-x86_64.tar.gz
 
  
−
*Start the ''Setup-Workspace'' Java launch config (''Run'' | ''Run Configurations...'' | ''Java Applications'' | ''Setup-Workspace'')
 
−
*Watch the ''Console'' view while <tt>Setup.java</tt> is running.
 
−
*Behind the scenes all the files necessary for the API baseline and the target platform of the workspace have been downloaded and installed
 
  
−
<br>
+
Note, if you want to work on CDO 2.0 switch the branch with Team|Switch to "R2_0_maintenance" branch (not tag!)
  
−
==Target Platform==
+
== Materialize the Sources and the Target Platform ==
−
* In your Eclipse IDE open the ''Preferences'' dialog via the ''Window'' menu and go to the ''Target Platforms'' page
+
−
* Enter the new ''Location'' of the target platform (<tt>C:\develop\ws\cdo\.target\eclipse</tt>):<br><br>
+
−
[[Image:TargetPlatform1.png]]<br><br>
+
−
[[Image:TargetPlatform2.png]]<br><br>
+
−
[[Image:TargetPlatform3.png]]<br><br>
+
−
[[Image:TargetPlatform4.png]]<br><br>
+
−
[[Image:TargetPlatform5.png]]<br><br>
+
−
[[Image:TargetPlatform6.png]]<br><br>
+
−
[[Image:TargetPlatform7.png]]<br><br>
+
−
[[Image:TargetPlatform8.png]]<br><br>
+
  
−
<br>
+
To materialize the sources right-click the local.mspec, select Buckminster|Import...
  
−
==API Baseline==
+
[[Image:Cdo_install15.png]]
−
* In your Eclipse IDE open the ''Preferences'' dialog via the ''Window'' menu and go to the page ''API Baselines'' and press the ''Add Baseline...'' button
+
−
* Enter the ''Name'' (<tt>Eclipse 3.5</tt>) and ''Location'' (<tt>C:\develop\ws\cdo\.baseline\eclipse\plugins)</tt>:<br><br>
+
−
[[Image:Baseline1.png]]<br><br>
+
−
[[Image:Baseline2.png]]<br><br>
+
−
[[Image:Baseline3.png]]<br><br>
+
−
* Leave the ''Preferences'' dialog by pressing the ''Ok'' button
+
  
−
<br>
+
While the following dialog is running go and fetch a coffee, or two, or three...
  
−
==Source Checkout==
 
−
* Right-click the workspace file <tt>/develop.setup/psf/pserver/All.psf</tt> and select ''Import Project Set...'' and go fetch a coffee
 
−
* When the checkout process is finished set the ''Top Level Elements'' of the ''Package Explorer'' view to ''Working Sets'' (local pulldown menu)
 
−
* Select ''Configure Working Sets...'' (local pulldown menu):<br>[[Image:WorkingSets.png]]<br><br>
 
  
 +
[[Image:Cdo_install16.png]]
  
−
You're finished! Now you should have a complete CDO workspace:<br>[[Image:CheckoutResult.png]]<br><br>
+
Finally hit the 'Finish' button
  
−
<br>
+
[[Image:Cdo_install14.png]]
−
----
+
−
Wikis: [[CDO]] | [[Net4j]] | [[EMF]] | [[Eclipse]]
+

Revision as of 09:39, 19 March 2010

Introduction

This tutorial describes how to install the CDO workspace using Buckminster. It replaces the old tutorial which can be found here.

Prepare the IDE

Download and install Eclipse 3.6 from http://download.eclipse.org/eclipse/downloads

Then open a fresh development workspace.

Cdo install1.png


Add the following plug-ins from the Helios p2 repository (http://download.eclipse.org/releases/helios)

Install the following:

  • EMF 2.6 SDK
  • Buckminster 3.6 Core
  • Buckminster 3.6 CVS Support
  • Buckminster 3.6 PDE Support


Cdo install2.png

Cdo install3.png

Now you have prepared your IDE with the required tools.

Create the Target Platform

For the target platfrom first create an empty project called "_target".

Cdo install4.png


Now create an empty target definition that Buckminster later can fill with the needed plug-ins (Windows->Preferences->Plugin Development->Target Platform)


Cdo install5.png


Insert the name for the target platform.

Cdo install6.png


Click 'Add'.

Cdo install7.png


Add the directory location ${workspace_loc}/_target.

Cdo install8.png


Activate the platform.

Cdo install9.png

Bootstrap the Releng Project

Now you need to bootstrap the releng project.

http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/releng/org.eclipse.emf.cdo.releng/psf/pserver/_bootstrap.psf?root=Modeling_Project&view=co

Committers use: http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.emf/org.eclipse.emf.cdo/releng/org.eclipse.emf.cdo.releng/psf/extssh/_bootstrap.psf?root=Modeling_Project&view=co

Right click the Package Explorer and choose Imort->Team Project Set. Select the downloaded _bootstrap.psf

Cdo install10.png

Cdo install11.png

Cdo install12.png


Note, if you want to work on CDO 2.0 switch the branch with Team|Switch to "R2_0_maintenance" branch (not tag!)

Materialize the Sources and the Target Platform

To materialize the sources right-click the local.mspec, select Buckminster|Import...

Cdo install15.png

While the following dialog is running go and fetch a coffee, or two, or three...


Cdo install16.png

Finally hit the 'Finish' button

Cdo install14.png

Retrieved from "https://wiki.eclipse.org/index.php?title=CDO_Source_Installation_(CVS,_deprecated)&oldid=193382"

Back to the top