Difference between revisions of "ApCoCoA-1:HowTo:Install and Work with the Eclipse GUI"

From ApCoCoAWiki
Line 22: Line 22:
 
==Installation==
 
==Installation==
 
===Installing and Running Eclipse===
 
===Installing and Running Eclipse===
After you download one of the [http://www.eclipse.org/downloads/ Eclipse packages] (e.g. the ''Eclipse IDE for C/C++ Developers''), unpack the downloaded package go to the newly created folder <code>eclipse</code> and start the eclipse executable. That's all. If you start Eclipse for the  
+
After you download one of the [http://www.eclipse.org/downloads/ Eclipse packages] (e.g. the ''Eclipse IDE for C/C++ Developers''), unpack the downloaded package go to the newly created folder <code>eclipse</code> and start the eclipse executable. That's all.  
first time, you will see this welcome screen
+
After starting Eclipse, you will be asked to provide a ''workspace directory''. This is where all your projects and ApCoCoA files will be stored. If unsure, just take the suggested default value.
[[Image:Welcome-Screen.jpg]]
+
If you start Eclipse for the first time, you are presented with the welcome screen, which you just can close.
 +
[[Image:Welcome-Screen.jpg|thumb|none|150px]]
 +
If you downloaded the ''Eclipse IDE for C/C++ Developers'' you now see the ''C/C++ perspective'' (a perspective is a special collection of ) which is the starting point for this tutorial.
 +
[[Image:Eclipse_Initial.jpg]]
 +
 
  
 
===Installing the Plugin===
 
===Installing the Plugin===
* Help > Software Updates ... > Tab "Available Software"
+
One of the really nice things in Eclipse is the ease of installing and updating plugins, i.e. extensions of the Eclipse platform that add new features and functionality, as the GUI plugin does. To install the ApCoCoA GUI plugin, follow these steps.
* Add Site...
+
* In the menu bar, click <code>Help > Software Updates ... ></code> Tab ''Available Software''
* Enter location [http://www.apcocoa.org/updatesite/ http://www.apcocoa.org/updatesite/]
+
* Next, klick <code>Add Site...</code>
* Check Apcocoa GUI
+
* Enter the URL <code>http://www.apcocoa.org/updatesite/</code>
* Install...
+
[[Image:Update_Site.jpg]]
* Accept the license agreement
+
* Then check Apcocoa GUI ...
* Restart Eclipse
+
 
 +
* ... and click <code>Install...</code>
 +
* Eclipse then looks up the plugins that have to be installed and presents you with a review and confirm page. Click <code>Next</code>.
 +
[[Image:Review_and_Confirm.jpg]]
 +
* Accept the license agreement and klick <code>Finish</code>.
 +
[[Image:Accept_License.jpg]]
 +
* Next you will be asked to restart the Eclipse platform which is recommended.
 +
* Finally, you should see some new additions in the menu and tool bars.
 +
[[Image:New_Additions.jpg]]
 +
 
 +
You are now ready to set up and use ApCoCoA with Eclipse.
  
Screenshots will follow...
 
  
 
==First Steps==
 
==First Steps==
===Configure the GUI===
+
===Configure Eclipse===
 
* Window > Preferences > ApCoCoA Preferences
 
* Window > Preferences > ApCoCoA Preferences
 
* Set paths to the ApCoCoA command line executable and ApCoCoA Server or BBF Server
 
* Set paths to the ApCoCoA command line executable and ApCoCoA Server or BBF Server
 
* TBC.
 
* TBC.

Revision as of 10:17, 11 February 2009

Introduction

This HowTo shows you how to get started with the new Eclipse Graphical User Interface (GUI) for (Ap)CoCoA.

Currently, the new GUI is still in an alpha state, which means there might be annoying bugs or the look and feel will change in the near future with new releases.

If this doesn't frighten you, you are more than welcome to,

Prerequisites

  • A current Java runtime environment (Java 5 JRE recommended)
  • Eclipse If you are new to Eclipse, the variety of different packages to choose may be confusing. However, for using ApCoCoA it does not matter which package you choose and we therefore recommend to choose the smallest one (which currently is the Eclipse IDE for C/C++ Developers)
  • ApCoCoA


Installation

Installing and Running Eclipse

After you download one of the Eclipse packages (e.g. the Eclipse IDE for C/C++ Developers), unpack the downloaded package go to the newly created folder eclipse and start the eclipse executable. That's all. After starting Eclipse, you will be asked to provide a workspace directory. This is where all your projects and ApCoCoA files will be stored. If unsure, just take the suggested default value. If you start Eclipse for the first time, you are presented with the welcome screen, which you just can close.

Welcome-Screen.jpg

If you downloaded the Eclipse IDE for C/C++ Developers you now see the C/C++ perspective (a perspective is a special collection of ) which is the starting point for this tutorial. Eclipse Initial.jpg


Installing the Plugin

One of the really nice things in Eclipse is the ease of installing and updating plugins, i.e. extensions of the Eclipse platform that add new features and functionality, as the GUI plugin does. To install the ApCoCoA GUI plugin, follow these steps.

Update Site.jpg

  • Then check Apcocoa GUI ...
  • ... and click Install...
  • Eclipse then looks up the plugins that have to be installed and presents you with a review and confirm page. Click Next.

Review and Confirm.jpg

  • Accept the license agreement and klick Finish.

Accept License.jpg

  • Next you will be asked to restart the Eclipse platform which is recommended.
  • Finally, you should see some new additions in the menu and tool bars.

New Additions.jpg

You are now ready to set up and use ApCoCoA with Eclipse.


First Steps

Configure Eclipse

  • Window > Preferences > ApCoCoA Preferences
  • Set paths to the ApCoCoA command line executable and ApCoCoA Server or BBF Server
  • TBC.