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.
Triquetrum/Building From Sources
There are at least two ways to get started with Triquetrum:
- Building from sources, which is for people who will collaborate on Triquetrum by recompiling and submitting changes.
- 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.
- Install Eclipse for RCP and RAP Developers. Other versions may work. These instructions were tested using Mars June 2015 under Mac OS X.
- Start Eclipse. Create a new workspace. You may need to close the Welcome tab by clicking on the X.
- Window -> Show View -> Other -> Git -> Git Repositories
- Click on "Clone a Git repository"
- Click on "Clone URI", then Next
- Enter the URI
https://github.com/eclipse/triquetrum/
- In the Branch Selection window, keep the defaults that include the Master branch and other branches, then click Next.
- 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.target"
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.target tab, Target Definition pane, click on Set as Target Platform.
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
2. In the Overview tab, under Testing or at the top right mini-toolbar, click on Launch an Eclipse Application.
The application should start up.
3. See Triquetrum/Getting Started for how to use Triquetrum.