Jump to: navigation, search

Difference between revisions of "Eclipse b3/contributing/Setting Up Development Environment"

(Running It)
(Running It)
Line 86: Line 86:
 
* the file should open in an editor supporting syntax highlighting
 
* the file should open in an editor supporting syntax highlighting
 
* there should be an outline view with a root node of ''BeeModel''
 
* there should be an outline view with a root node of ''BeeModel''
* right click the ''BeeModel'' node in the outline view a select the ''Run Main Function'' option<pre>
+
* right click the ''BeeModel'' node in the outline view a select the ''Run Main Function'' option
* a console window with the following content should show up:
+
* a console window with the following content should show up:<pre>
 
Running the main function...
 
Running the main function...
 
Result = true</pre>
 
Result = true</pre>
 
<br />
 
<br />

Revision as of 10:33, 31 December 2009

If you intend to hack b3, here is how to get started.

Installing Prerequisites

In order to work on b3 you'll need to install prerequisites described in the following paragraphs. (In the same order they are listed in this document.)

Eclipse

The first thing you'll need is the Eclipse 3.5.1 IDE for your platform. Here is a pointer (if you don't get it by heart yet) to the download page: http://www.eclipse.org/downloads/
Grab the Classic version at the very bottom and unpack the archive into a convenient path.

Subversion support

Subversion support is needed simply because the b3 sources are kept in an SVN repository. There are two projects providing the needed support:


If you already use one of these then stick with it, otherwise follow these steps to install subclipse:

  • run your freshly installed Eclipse
  • open the Help / Install New Software wizard
  • browse the subclipse 1.6.x repository: http://subclipse.tigris.org/update_1.6.x
  • select the following components:
    • Core SVNKit Library / SVNKit Library
    • Optional JNA Library (recommended) / JNA Library
    • Subclipse / Subclipse (Required)
    • Subclipse / SVNKit Client Adapter (Not required)
  • click through the other pages of the install wizard to finish the installation (you will need to acknowledge installation of unsigned software as the subclipse components are not signed)


You may want to skip the otherwise recommended restart of the workbench at this point as there will be more installations and after each of them a restart will be recommended, so it will save you some time if you restart only after the very last installation.
(But don't blame me if anything goes wrong - the restart was recommended after all!)

EMF

EMF is the first of dependencies of b3, to install it follow these instructions:

  • open the Help / Install New Software wizard
  • browse the EMF releases repository: http://download.eclipse.org/modeling/emf/updates/releases
  • expand the EMF SDK 2.5.0 (EMF + XSD) category (you may experiment with later releases if available)
  • select all entries in the expanded category which names start with EMF, except EMF/XSD All-In-One SDK (you may also omit Examples)
  • click through the other pages of the install wizard to finish the installation


Again you may want to skip the recommended workbench restart.

Ecore Tools

B3 would work without this, but the tools include, among others, graphical editors for certain b3 language definitions which would otherwise have to be edited in plain text, which would be a pain. Installation instructions follow:

  • open the Help / Install New Software wizard
  • browse the EMFT releases repository: http://download.eclipse.org/modeling/emft/updates/releases
  • expand the EMFT ECORETOOLS SDK (Incubation) 0.9.0 category (you may experiment with later releases if available)
  • select all entries in the expanded category, except Ecore Tools All-In-One Feature (Incubation) (you may also omit Examples)
  • click through the other pages of the install wizard to finish the installation


Again you may want to skip the recommended workbench restart.

Xtext

Xtext is the next dependency of b3. Installation instructions follow:

  • open the Help / Install New Software wizard
  • browse the Xtext milestones repository (latest release won't do as of writing of this document): http://download.itemis.com/updates/milestones
  • select entire following categories:
    • tmf-xtext 0.8.0M4 S200912151450 (you may experiment with later milestones if available)
    • xtext-antlr 0.8.0M4 S200912152232 (you may experiment with later milestones if available)
  • click through the other pages of the install wizard to finish the installation (you will need to acknowledge installation of unsigned software as some of the installed components are not signed)


The Xtext completes the installations so please restart the workbench as recommended this time!

Getting The Source Code

B3 source code is kept in the Eclipse SVN repository. There are two ways to access the repository:


choose whichever is appropriate for you.

To get the b3 sources, follow these instructions:

  • run Eclipse, open the SVN Repository Exploring perspective
  • add the chosen repository to the the list of SVN repositories (which should be empty at this time)
  • expand the repository node, then expand the trunk node
  • checkout all subdirectories from trunk as projects into your workspace


Done!

Running It

Once you have all the projects in the your workspace you are ready to launch a b3 enabled Workbench. You do it like this:

  • bring up the Run / Run Configurations... dialog
  • create a new Eclipse Applications configuration
  • rename it to something suitable, like B3
  • launch it


A new workbench should start, perform the following actions in the new workbench:

  • checkout the following project: http://dev.eclipse.org/svnroot/modeling/org.eclipse.emft.b3/trunk/org.eclipse.b3.beelang.tests
  • switch to the Package Explorer view and open the /src-b3/smoketestFunctionArithmetic.b3 file in the checked out project
  • the file should open in an editor supporting syntax highlighting
  • there should be an outline view with a root node of BeeModel
  • right click the BeeModel node in the outline view a select the Run Main Function option
  • a console window with the following content should show up:
Running the main function... Result = true