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.
Difference between revisions of "Papyrus-RT/Developer/Developer Guide/DevEnv"
| Line 27: | Line 27: | ||
*# Decompress the downloaded archive to a folder such as "'''~/Apps/EclipseInstaller/'''" ''(folder name and location will vary depending on operating system)'' | *# Decompress the downloaded archive to a folder such as "'''~/Apps/EclipseInstaller/'''" ''(folder name and location will vary depending on operating system)'' | ||
| − | * | + | * An Eclipse account. This is needed to access Bugzilla and Gerrit queries in MyLyn, as well as to contribute changes to the source code via Gerrit. |
| − | + | *# If you do not have an Eclipse account, go to [https://dev.eclipse.org/site_login/ https://dev.eclipse.org/site_login/] and fill out the form. | |
| − | *# | + | |
| − | + | ||
{{Note | Operating System | The instructions in this tutorial are illustrated using screen captures from multiple operating systems. Steps and images may differ slightly if the installation is done on a different operating system (both Windows and Mac OS are supported for developing models). Some of these differences have been indicated when known, but some may also be missing.}} | {{Note | Operating System | The instructions in this tutorial are illustrated using screen captures from multiple operating systems. Steps and images may differ slightly if the installation is done on a different operating system (both Windows and Mac OS are supported for developing models). Some of these differences have been indicated when known, but some may also be missing.}} | ||
| Line 90: | Line 89: | ||
=== Add the setup project file to the installer === | === Add the setup project file to the installer === | ||
| − | 10. | + | 10. Click on the '''<User>''' folder. |
| + | |||
| + | 11. Click on the '''[+]''' button on the top-right of the window. | ||
| + | |||
| + | 12. Enter the following URL in the '''Resource URIs''' field: | ||
| + | |||
| + | :[https://www.eclipse.org/papyrus-rt/content/setup/papyrus-rt-developer.setup https://www.eclipse.org/papyrus-rt/content/setup/papyrus-rt-developer.setup] | ||
:<div class="figure">[[Image:papyrus-rt-dev-env-install-5-1.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-5-1.png]]</div> | ||
| + | |||
| + | 13. Click '''[OK]'''. | ||
| + | |||
| + | :<div class="figure">[[Image:papyrus-rt-dev-env-install-5-2.png]]</div> | ||
| + | |||
=== Select the components to install === | === Select the components to install === | ||
| − | + | 14. Unfold '''Papyrus-RT''' and check all the boxes on the left. | |
| + | |||
| + | :<div class="figure">[[Image:papyrus-rt-dev-env-install-5-3.png]]</div> | ||
| + | |||
| + | 15. In the bottom of the dialog make sure that the ''Stream'' field in each entry is set to '''master (Neon/1.0)''' (You may need to click on each and select the appropriate stream). | ||
| + | |||
| + | :<div class="figure">[[Image:papyrus-rt-dev-env-install-5-4.png]]</div> | ||
| − | + | 16. Click '''[Next]'''. | |
| − | :<div class="figure">[[Image:papyrus-rt-dev-env-install- | + | :<div class="figure">[[Image:papyrus-rt-dev-env-install-7-0.png]]</div> |
| − | + | {{Note |Variables | It has been reported that sometimes some variables are not displayed. In particular the "Codegen Builds" variable is sometimes missing. This is not a problem as it can be shown by selecting "Show all variables.}} | |
| − | + | 17. Enter your Eclipse password under '''Eclipse password for Bugzilla/Hudson'''. | |
=== Configure your installation === | === Configure your installation === | ||
| − | + | 18. Choose your installation and workspace folders and enter your Eclipse password. You may customize these values and more by checking on '''Show all variables''' at the bottom. | |
:<div class="figure">[[Image:papyrus-rt-dev-env-install-7-1.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-7-1.png]]</div> | ||
| Line 114: | Line 130: | ||
This will give your options about the location of the workbench, the workspace, the git repository, the target platform, the JVM location and the repository used for the code-generator builds (Continuous Integration or Scheduled Nightly). | This will give your options about the location of the workbench, the workspace, the git repository, the target platform, the JVM location and the repository used for the code-generator builds (Continuous Integration or Scheduled Nightly). | ||
| − | + | 19. Click '''[Next]'''. | |
:<div class="figure">[[Image:papyrus-rt-dev-env-install-8.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-8.png]]</div> | ||
| Line 120: | Line 136: | ||
This shows the first set of tasks of the installation. The second set will be executed when Eclipse launches automatically. | This shows the first set of tasks of the installation. The second set will be executed when Eclipse launches automatically. | ||
| − | + | 20. Click '''[Finish]'''. | |
:<div class="figure">[[Image:papyrus-rt-dev-env-install-9.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-9.png]]</div> | ||
| − | + | 21. Click '''[Finish]'''. | |
=== Restarting === | === Restarting === | ||
| Line 140: | Line 156: | ||
:<div class="figure">[[Image:papyrus-rt-dev-env-install-12.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-12.png]]</div> | ||
| − | + | 22. If asked for '''Gerrit Code Review Repository Authentication''' enter your Eclipse user ID and password. | |
:<div class="figure">[[Image:papyrus-rt-dev-env-install-13.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-13.png]]</div> | ||
| Line 150: | Line 166: | ||
These will setup and synchronize the various MyLyn queries for Bugzilla and Gerrit. | These will setup and synchronize the various MyLyn queries for Bugzilla and Gerrit. | ||
| − | + | 23. Once it's finished you can click '''[Finish]''' to close the setup dialog. | |
| − | + | 24. Click on '''Workbench''' in the Eclipse Welcome page. You should see something like this: | |
:<div class="figure">[[Image:papyrus-rt-dev-env-install-15-1.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-15-1.png]]</div> | ||
| Line 160: | Line 176: | ||
=== Generate code for EMF projects === | === Generate code for EMF projects === | ||
| − | + | 25. For each of the following projects (found under the '''Papyrus XtUML-RT''' working set), perform the steps below: | |
* <code>org.eclipse.papyrusrt.xtumlrt.common.model</code> | * <code>org.eclipse.papyrusrt.xtumlrt.common.model</code> | ||
| Line 181: | Line 197: | ||
=== Generate code for the Xtext project === | === Generate code for the Xtext project === | ||
| − | + | 26. Generate Xtext Artifacts: | |
# Locate the <code>org.eclipse.papyrusrt.xtumlrt.xtext</code> project (under the '''Papyrus XtUML-RT''' working set), and then | # Locate the <code>org.eclipse.papyrusrt.xtumlrt.xtext</code> project (under the '''Papyrus XtUML-RT''' working set), and then | ||
| Line 197: | Line 213: | ||
:<div class="figure">[[Image:papyrus-rt-dev-env-install-15-7.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-15-7.png]]</div> | ||
| − | + | 27. Click '''[Proceed]''' | |
In the console view at the bottom, a message <span style="color: red"> *ATTENTION*</span> will appear and it will ask you if it can download the ANTLR 3 parser generator. | In the console view at the bottom, a message <span style="color: red"> *ATTENTION*</span> will appear and it will ask you if it can download the ANTLR 3 parser generator. | ||
| Line 203: | Line 219: | ||
:<div class="figure">[[Image:papyrus-rt-dev-env-install-15-8.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-15-8.png]]</div> | ||
| − | + | 28. Put the cursor in the console after the question and type '''y[Enter]'''. | |
When it finishes generating the Xtext code it should look like this: | When it finishes generating the Xtext code it should look like this: | ||
| Line 220: | Line 236: | ||
There will still be a few errors in the workspace. To get rid of them | There will still be a few errors in the workspace. To get rid of them | ||
| − | + | 29. Click on '''Project → Clean...'''on the main menu. | |
:<div class="figure">[[Image:papyrus-rt-dev-env-install-15-10.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-15-10.png]]</div> | ||
| − | + | 30. Select '''Clean all projects''' | |
:<div class="figure">[[Image:papyrus-rt-dev-env-install-15-11.png]]</div> | :<div class="figure">[[Image:papyrus-rt-dev-env-install-15-11.png]]</div> | ||
| − | + | 31. Click '''[OK]''' | |
After if finishes, the workspace should have no errors and it should look like this: | After if finishes, the workspace should have no errors and it should look like this: | ||
Revision as of 13:14, 18 April 2016
Contents
- 1 Introduction
- 2 Requirements
- 3 Install the development environment for Papyrus for Real Time
- 3.1 Start the Eclipse Installer
- 3.2 Switch the the Advanced Mode
- 3.3 Select a base Eclipse Package
- 3.4 Add the setup project file to the installer
- 3.5 Select the components to install
- 3.6 Configure your installation
- 3.7 Restarting
- 3.8 Generate code for EMF projects
- 3.9 Generate code for the Xtext project
- 3.10 Clean all
Introduction
This tutorial will show you how to setup the development environment for Papyrus for Real Time using the Oomph-based Eclipse Installer.
The installer will automatically perform several actions, including:
- Download and install a base Eclipse workbench for your platform
- Add the required update sites
- Download and install all required development tools (Eclipse features and plugins, such as the PDE, the JDT, EGit, MyLyn, etc.)
- Download and install all required dependencies (Eclipse features and plugins, such as UML2, Papyrus, Xtext, etc.)
- Clone the PapyrusRT git repository
- Import all the PapyrusRT projects into the workspace
- Create working sets in the workspace organizing the projects
- Install Bugzilla and Gerrit MyLyn connectors and synchronize queries for these connectors
- Configure the workbench (e.g. set the JVM and Java compiler compliance, set character encodings, code formatting and other user preferences)
Requirements
To install the developer environment you need only three things:
- Java 8.
- Older versions may not work. You can obtain the JDK 1.8 here: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
- The Eclipse Installer
- Go to http://wiki.eclipse.org/Eclipse_Installer
- Download the "Eclipse Installer" package for your operating system
- Decompress the downloaded archive to a folder such as "~/Apps/EclipseInstaller/" (folder name and location will vary depending on operating system)
- An Eclipse account. This is needed to access Bugzilla and Gerrit queries in MyLyn, as well as to contribute changes to the source code via Gerrit.
- If you do not have an Eclipse account, go to https://dev.eclipse.org/site_login/ and fill out the form.
The instructions in this tutorial are illustrated using screen captures from multiple operating systems. Steps and images may differ slightly if the installation is done on a different operating system (both Windows and Mac OS are supported for developing models). Some of these differences have been indicated when known, but some may also be missing.
Install the development environment for Papyrus for Real Time
Now that the installer and project file are available, you can install the development environment.
Start the Eclipse Installer
1. Open the eclipse-installer folder and double-click on the eclipse-inst application.
You should see this:
Switch the the Advanced Mode
You have now started the Eclipse Installer. Now you will need to add the Papyrus-RT developer setup project file to the Installer.
However, the Papyrus-RT developer setup project is not available in the list of projects presented to you. You will have to manually add it to the list by using the "Advanced Mode" of the installer.
2. Click on the icon at the top right.
3. Select "Advanced Mode..."
This has for effect to restart the Eclipse Installer in the "Advanced Mode", which will allow you to specify an external setup file.
Select a base Eclipse Package
4. Select Eclipse.org from the list.
5. Click on the [>] left of Eclipse.org to unfold.
6. Select Eclipse IDE for Eclipse Committers.
You can choose a different base package, but this is the simplest way to get started.
7. In the bottom, under Product Version select Latest (Neon).
8. Under Java VM choose the appropriate Java 1.8 JVM (you may need to navigate through the file system to find the one you need).
9. Click [Next]
Add the setup project file to the installer
10. Click on the <User> folder.
11. Click on the [+] button on the top-right of the window.
12. Enter the following URL in the Resource URIs field:
13. Click [OK].
Select the components to install
14. Unfold Papyrus-RT and check all the boxes on the left.
15. In the bottom of the dialog make sure that the Stream field in each entry is set to master (Neon/1.0) (You may need to click on each and select the appropriate stream).
16. Click [Next].
It has been reported that sometimes some variables are not displayed. In particular the "Codegen Builds" variable is sometimes missing. This is not a problem as it can be shown by selecting "Show all variables.
17. Enter your Eclipse password under Eclipse password for Bugzilla/Hudson.
Configure your installation
18. Choose your installation and workspace folders and enter your Eclipse password. You may customize these values and more by checking on Show all variables at the bottom.
This will give your options about the location of the workbench, the workspace, the git repository, the target platform, the JVM location and the repository used for the code-generator builds (Continuous Integration or Scheduled Nightly).
19. Click [Next].
This shows the first set of tasks of the installation. The second set will be executed when Eclipse launches automatically.
20. Click [Finish].
21. Click [Finish].
Restarting
Eclipse will relaunch automatically and present you with a welcome screen:
On the bottom right it says Executing startup tasks. You can leave it alone, but it will take a few minutes to complete. If you'd like to see the progress, you can click on the icon to the left of this message (two circling arrows)
When it finishes it will look like this:
22. If asked for Gerrit Code Review Repository Authentication enter your Eclipse user ID and password.
During setup, a few dialogs like the following will pop up:
These will setup and synchronize the various MyLyn queries for Bugzilla and Gerrit.
23. Once it's finished you can click [Finish] to close the setup dialog.
24. Click on Workbench in the Eclipse Welcome page. You should see something like this:
At this point you will have errors in several projects (and in the Error Log view). To clean up all the errors, a few additional steps are necessary.
Generate code for EMF projects
25. For each of the following projects (found under the Papyrus XtUML-RT working set), perform the steps below:
-
org.eclipse.papyrusrt.xtumlrt.common.model -
org.eclipse.papyrusrt.xtumlrt.statemach.model -
org.eclipse.papyrusrt.xtumlrt.statemach.ext.model -
org.eclipse.papyrusrt.xtumlrt.umlrt.model
Steps:
- Unfold the project
- Unfold the model folder
- Open the XXX
.genmodelfile (by double-clicking it), where XXX is the name of the model. - In the opened EMF editor, right-click the root element (named XXX)
- Select Generate Model Code
- Do the same for each of the projects mentioned above.
Generate code for the Xtext project
26. Generate Xtext Artifacts:
- Locate the
org.eclipse.papyrusrt.xtumlrt.xtextproject (under the Papyrus XtUML-RT working set), and then - Unfold the project
- Unfold the src folder
- Unfold the org.eclipse.papyrusrt.xtumlrt.xtext folder
- Right-click on the Tumlrt.xtext file
- Select Run As
- Select Generate Xtext Artifacts
It will then say that there are errors and ask you is you want to proceed.
27. Click [Proceed]
In the console view at the bottom, a message *ATTENTION* will appear and it will ask you if it can download the ANTLR 3 parser generator.
28. Put the cursor in the console after the question and type y[Enter].
When it finishes generating the Xtext code it should look like this:
It has been reported that some people have trouble with downloading the ANTLR generator. In that case you should do the following:
- Download http://download.itemis.com/antlr-generator-3.2.0-patch.jar
- Rename it into .antlr-generator-3.2.0-patch.jar
- Place it in the root of
org.eclipse.papyrusrt.xtumlrt.xtext.ide - Regenerate the Xtext Artifacts as described above.
Clean all
There will still be a few errors in the workspace. To get rid of them
29. Click on Project → Clean...on the main menu.
30. Select Clean all projects
31. Click [OK]
After if finishes, the workspace should have no errors and it should look like this:
Done!