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 "Triquetrum/Building From Sources"

(Updating instructions for Neon)
(Building: Added link to Triquetrum/Target Platform Definition.)
Line 39: Line 39:
 
4. You should have a workspace without errors now.
 
4. You should have a workspace without errors now.
  
<!-- Uncomment this section once https://github.com/eclipse/triquetrum/issues/92 is complete
+
Note that org.eclipse.triquetrum.target.platform/org.eclipse.triquetrum.target.platform.\
 
+
target is created from the org.eclipse.triquetrum.target.platform.tpd file. The first time Triquetrum is built it is typically not necessary to update the .target or .tpd files.  However, if you later want to update the .target file, see [[Triquetrum/Target Platform Definition | Target Platform Definition]].
'''Target File Management'''
+
 
+
The Target file is managed with the [https://github.com/mbarbero/fr.obeo.releng.targetplatform Target Platform Definition DSL and Generator]. To generate or edit the target file:
+
 
+
1. Install the editor from the update site http://mbarbero.github.io/fr.obeo.releng.targetplatform/p2/latest/.
+
 
+
2. Open the org.eclipse.triquetrum.target.platform.tpd file
+
 
+
3. Make edits, if required
+
 
+
4. Right-click on the file or in the editor and choose "Create Target Definition File"
+
 
+
5. Then follow the steps above to set the target platform. Alternatively, select "Set as Target Platform" from the context menu to create the .target file and set as target platform in one step.
+
-->
+
  
 
== Running ==
 
== Running ==

Revision as of 18:04, 29 August 2016

There are at least two ways to get started with Triquetrum:

  1. Building from sources, which is for people who will collaborate on Triquetrum by recompiling and submitting changes.
  2. Downloads, which is for people who want to use Triquetrum without recompiling.

This page is discusses how to build from sources.

Check Out the Repo

Use Eclipse to check out the repo.

  1. Install Eclipse for RCP and RAP Developers. Other versions may work. These instructions were tested using Mars June 2015 under Mac OS X.
  2. Start Eclipse. Create a new workspace. You may need to close the Welcome tab by clicking on the X.
  3. Window -> Show View -> Other -> Git -> Git Repositories
  4. Click on "Clone a Git repository"
  5. Click on "Clone URI", then Next
  6. Enter the URI https://github.com/eclipse/triquetrum/
  7. In the Branch Selection window, keep the defaults that include the Master branch and other branches, then click Next.
  8. In the Local Destination window, select Finish.

Importing Projects

In the Git Repositories tab, expand the triquetrum tab, right click on Working Tree and select Import Projects.

1. Keep "Import existing Eclipse projects" selected, click Next.

2. Then click Finish.

Building

The build will show lots of errors. Don't panic.

1. Expand org.eclipse.triquetrum.target.platform and double click on "org.eclipse.triquetrum.target.platform"

TriquetrumGettingStartedTriqTarget.png

2. The target will build. See the bottom right for the status. It may take a minute or two to build.

3. In org.eclipse.triquetrum.target.platform tab, Target Definition pane, click on Set as Target Platform.

TriquetrumGettingStartedSetTargetAsPlatform.png

4. You should have a workspace without errors now.

Note that org.eclipse.triquetrum.target.platform/org.eclipse.triquetrum.target.platform.\ target is created from the org.eclipse.triquetrum.target.platform.tpd file. The first time Triquetrum is built it is typically not necessary to update the .target or .tpd files. However, if you later want to update the .target file, see Target Platform Definition.

Running

1. Under org.eclipse.triquetrum.repository, open Triquetrum.product in the Product Configuration Editor

Triquetrum RunFromProduct.JPG

2. In the Overview tab, under Testing or at the top right mini-toolbar, click on Launch an Eclipse Application.

Triquetrum RunFromProduct2.JPG

The application should start up.

3. See Triquetrum/Getting Started for how to use Triquetrum.

Back to the top