|
|
| (32 intermediate revisions by 3 users not shown) |
| Line 1: |
Line 1: |
| − | == Introduction ==
| + | __TOC__<br> |
| − | This tutorial describes how to install a '''CDO workspace''' using [http://www.eclipse.org/buckminster/ Buckminster].<br>
| + | |
| − | The '''sources''' can also be browsed through [http://git.eclipse.org/c/cdo/cdo.git/tree http://git.eclipse.org/c/cdo/cdo.git/tree].<br>
| + | |
| − | '''Binaries''' can be downloaded from [http://www.eclipse.org/cdo/downloads http://www.eclipse.org/cdo/downloads].
| + | |
| | | | |
| − | == Prepare the IDE == | + | = Get the Eclipse Installer = |
| − | Download and install Eclipse 3.7 or 3.8 from [http://download.eclipse.org/eclipse/downloads/eclipse3x.php http://download.eclipse.org/eclipse/downloads/eclipse3x.php]
| + | |
| | | | |
| − | Then open a fresh development workspace.
| + | Please download and start the [[Eclipse Installer]]. |
| | | | |
| − | [[Image:Cdo_source1.png]]
| + | = Install an IDE for the CDO Model Repository = |
| | | | |
| | + | The following screenshots show what to enter on the installer pages. Depending on what other IDEs you've installed before the actual pages might look slightly different and possibly require much fewer inputs. |
| | | | |
| − | Select the [http://download.eclipse.org/releases/indigo Indigo] (for 3.7) or [http://download.eclipse.org/releases/juno Juno] (for 3.8) p2 repository and install the following features:
| + | [[Image:cdo_sources_1.png]] |
| − | * '''EMF - Eclipse Modeling Framework SDK'''
| + | |
| − | * '''Graphical Modeling Framework SDK''' (needed for CDO Dawn)
| + | |
| − | * '''Eclipse EGit''' (Team Provider)
| + | |
| | | | |
| − | Select the [http://download.eclipse.org/tools/buckminster/updates-3.7 Buckminster] p2 repository and install the following features:
| + | [[Image:cdo_sources_2.png]] |
| − | * '''Buckminster - Core'''
| + | |
| − | * '''Buckminster - Git Support'''
| + | |
| − | * '''Buckminster - PDE Support'''
| + | |
| | | | |
| − | '''Committers''': Please do not forget to install our versioning tool from [http://download.eclipse.org/modeling/emf/cdo/updates/integration http://download.eclipse.org/modeling/emf/cdo/updates/integration]:
| + | [[Image:cdo_sources_3.png]] |
| | | | |
| − | [[Image:CDO_Versioning_Tool.png]] | + | [[Image:cdo_sources_4.png]] |
| | | | |
| − | Now you have prepared your IDE with the required tools.
| + | The following (fifth) installer page will show the progress of the installation and finally launch the installed IDE. Once the installed IDE is up and running the remainder of the workspace installation will start. When that is finished all aspects of the IDE and workspace will be exactly the ones that the CDO developers use, too. |
| | | | |
| − | == Create the API Baseline == | + | = Update the IDE and the Workspace = |
| | | | |
| − | Now an API baseline will be created. Non-committers may skip this section.
| + | You can update your development workspace by pulling the latest updates into your CDO Git clone and selecting the '''Perform Setup Tasks...''' action in the '''Help''' menu. |
| − | | + | |
| − | * Download the 4.0 baseline from [https://sourceforge.net/projects/net4j/files/Baselines https://sourceforge.net/projects/net4j/files/Baselines] and extract it to your local disk.
| + | |
| − | | + | |
| − | * Add the API baseline to Eclipse: Open the <i>Preferences</i> (Window->Preferences) and open the "API Baselines" page.
| + | |
| − | | + | |
| − | [[Image:Cdo_baseline1.png]]
| + | |
| − | | + | |
| − | * Click "Add Baseline...". Give it the name ''CDO 4.0 Baseline'' and choose the path to the folder on your local disk where you've extracted the downloaded baseline to.
| + | |
| − | | + | |
| − | [[Image:Cdo_baseline2.png]]
| + | |
| − | | + | |
| − | Then the API baseline is created and set active for your workspace:
| + | |
| − | | + | |
| − | [[Image:Cdo_baseline3.png]]
| + | |
| − | | + | |
| − | == Materialize the Sources and the Target Platform ==
| + | |
| − | | + | |
| − | The materialization of the workspace contents (sources and binaries) will be performed by Buckminster with the cooperation of EGit and p2. For EGit to work properly please create the folder ${user.home}/git on your hard disk.
| + | |
| − | | + | |
| − | Then start the Buckminster import wizard:
| + | |
| − | | + | |
| − | [[Image:cdo_import1.png]]
| + | |
| − | | + | |
| − | Point it to the Buckminster MSpec of CDO: [http://git.eclipse.org/c/cdo/cdo.git/plain/plugins/org.eclipse.emf.cdo.releng/local.mspec http://git.eclipse.org/c/cdo/cdo.git/plain/plugins/org.eclipse.emf.cdo.releng/local.mspec].
| + | |
| − | | + | |
| − | For a 4.0 maintenance workspace use [http://git.eclipse.org/c/cdo/cdo.git/plain/releng/org.eclipse.emf.cdo.releng/local.mspec?h=streams/4.0-maintenance http://git.eclipse.org/c/cdo/cdo.git/plain/releng/org.eclipse.emf.cdo.releng/local.mspec?h=streams/4.0-maintenance] instead.
| + | |
| − | | + | |
| − | [[Image:cdo_import2.png]]
| + | |
| − | | + | |
| − | Press the Load button and wait until Buckminster has resolved all the dependencies (go and fetch a coffee, or two, or three).
| + | |
| − | | + | |
| − | [[Image:cdo_import3.png]]
| + | |
| − | | + | |
| − | Finally hit the 'Finish' button
| + | |
| − | | + | |
| − | [[Image:cdo_import4.png]]
| + | |
| − | | + | |
| − | == Updating the Workspace ==
| + | |
| − | | + | |
| − | You can update your development workspace by re-importing the local.mpec (right-click + Buckminster + Import...). Then the whole workspace and the target platform are updated.
| + | |
| − | | + | |
| − | Note, that re-importing does only '''add''' new source projects but doesn't update existing source projects from the Git repository. Use EGit for this purpose!
| + | |
The following screenshots show what to enter on the installer pages. Depending on what other IDEs you've installed before the actual pages might look slightly different and possibly require much fewer inputs.
The following (fifth) installer page will show the progress of the installation and finally launch the installed IDE. Once the installed IDE is up and running the remainder of the workspace installation will start. When that is finished all aspects of the IDE and workspace will be exactly the ones that the CDO developers use, too.
You can update your development workspace by pulling the latest updates into your CDO Git clone and selecting the Perform Setup Tasks... action in the Help menu.
