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 "Papyrus-RT/User/User Guide/Early Adopter"

(Feedback: typos)
(Installing Papyrus-RT: Updating for Papyrus-RT v0.8.0)
Line 12: Line 12:
  
 
=Installing Papyrus-RT=
 
=Installing Papyrus-RT=
There are currently two ways for early adopters to experience Papyrus-RT:
+
There are currently three ways for early adopters to experience Papyrus-RT:
* User installation (you came from there)
+
* Tester installation
+
  
==User Installation==
+
# [[#Eclipse Papyrus-RT RCP | An eclipse RCP]]
Installation instructions found are found in the User Guide: [[Papyrus-RT/User Guide/Eclipse Installer | Installing Papyrus for Real Time]]
+
# [[#Papyrus-RT Installer | The Papyrus-RT Installer ]]
 +
# [[#Eclipse Installer and update sites | The Eclipse Installer and update sites]]
  
This installation procedure provides access to the formal releases, the latest of which is, at the time of this page creation, v0.7.2 from December 2015. This may not provide you with the best view of what is currently available. There have been many major changes since then. However, it does provide you with a stable release that will not change.
+
Each of these methods have their pros and cons and are typically target to a different user profile. The first and second installation methods are designed to be easy to use by users new to Eclipse, while providing slight differences in capabilities.
 +
The third installation method is for the experienced Eclipse user.
  
==Tester Installation==
+
The pros and cons of each installation method are described below.
  
Installation instructions found are found in the [[Papyrus-RT/Tester_Guide#Papyrus-RT Development versions | Tester installation of Papyrus for Real Time]]
+
==Eclipse Papyrus-RT RCP==
 +
The RCP is an all-inclusive self-contained archive (zip) of Papyrus-RT
 +
* Pro: simple three-step: download, extract, start working with Papyrus-RT!
 +
* Con: larger file to download
  
This installation procedure provides testers with the latest development build of the tool, and it is not unusual to have many such builds during the day. This is required for our tester to quickly validate new functionality in order to move forward.
+
To install using this approach, simply download your platforms's RCP archive from [https://eclipse.org/papyrus-rt/content/download.php], unzip and use!
 +
 
 +
==Papyrus-RT Installer==
 +
The Papyrus-RT installer is a Papyrus-RT-specific standalone installer powered by Oomph, the same technology used by the Eclipse Installer.
 +
* Pro: Support for all the goodies provided by Oomph, e.g., bundle pooling, managed workspaces, and automatic updates, in a single package.
 +
* Con: You have to answers a few simple questions.
 +
 
 +
To install Papyrus-RT using this method, follow the instructions at [[Papyrus-RT/User_Guide/Papyrus-RT-Installer | Installing Papyrus for Real Time Using the Papyrus-RT Installer]]
 +
 
 +
 
 +
==Eclipse Installer and update sites==
 +
This approach is for the Eclipse veterans who are not afraid of the Eclipse Installer, understand what we mean a "p2", and need to install Papyrus-RT with other Eclipse projects!
 +
* Pros: Complete control of what will be part of the installation, including other Eclipse projects!
 +
* Cons: Increased complexity in the installation process with boxes to check and more, more difficult questions to answer.
 +
 
 +
To install Papyrus-RT using this method, follow the instructions at [[Papyrus-RT/User Guide/Eclipse Installer | Installing Papyrus for Real Time Using the Eclipse Installer]]
 +
 
 +
 
 +
===Eclipse Installer - Tester Installation===
 +
 
 +
This installation procedure provides testers with the latest development build of the tool, and it is not unusual to have more than one such builds during the day. This is required for our testers to quickly validate new functionality in order to move forward.
  
 
Once installed, the tool will not change unless you explicitly update it.
 
Once installed, the tool will not change unless you explicitly update it.
  
Because of this approach and the inherent potential instability, there cannot be any warranties as to the stability of these builds nor that any particular feature is fully implemented. As such, use at your own risk! This warning appears as part of the installation instructions for this version.
 
  
In the context of your evaluation, we will try to keep you informed of the quality of the builds.
+
Installation instructions are found in the [[Papyrus-RT/Tester_Guide#Papyrus-RT Development versions | Tester installation of Papyrus for Real Time]]
 +
 
 +
{{Note | Warning | Because of the complexity of this approach and its inherent potential instability, there cannot be any warranties as to the stability of these builds nor that any particular feature being fully implemented (or even working!). As such, <big>'''use at your own risk'''!</big>}}
  
 
=Current State=
 
=Current State=

Revision as of 15:22, 25 October 2016

PapyrusForRealTime-Logo-Icon.png




Early Adopter


General Considerations

Papyrus-RT is a work in progress and continually evolving in an agile way, where improvements can occur frequently.

Papyrus-RT also relies on the Papyrus platform which may require changes to improve its capabilities.

Our approach is to use this agile way of working to our advantage to continually drive to a definition for a minimal viable product. In order for this to work, we rely on all interested parties to provide feedback on the tool. This feedback is what drives us forward while continually improving and innovating in a way to meet our users’ needs, expectations, and goals.

Installing Papyrus-RT

There are currently three ways for early adopters to experience Papyrus-RT:

  1. An eclipse RCP
  2. The Papyrus-RT Installer
  3. The Eclipse Installer and update sites

Each of these methods have their pros and cons and are typically target to a different user profile. The first and second installation methods are designed to be easy to use by users new to Eclipse, while providing slight differences in capabilities. The third installation method is for the experienced Eclipse user.

The pros and cons of each installation method are described below.

Eclipse Papyrus-RT RCP

The RCP is an all-inclusive self-contained archive (zip) of Papyrus-RT

  • Pro: simple three-step: download, extract, start working with Papyrus-RT!
  • Con: larger file to download

To install using this approach, simply download your platforms's RCP archive from [1], unzip and use!

Papyrus-RT Installer

The Papyrus-RT installer is a Papyrus-RT-specific standalone installer powered by Oomph, the same technology used by the Eclipse Installer.

  • Pro: Support for all the goodies provided by Oomph, e.g., bundle pooling, managed workspaces, and automatic updates, in a single package.
  • Con: You have to answers a few simple questions.

To install Papyrus-RT using this method, follow the instructions at Installing Papyrus for Real Time Using the Papyrus-RT Installer


Eclipse Installer and update sites

This approach is for the Eclipse veterans who are not afraid of the Eclipse Installer, understand what we mean a "p2", and need to install Papyrus-RT with other Eclipse projects!

  • Pros: Complete control of what will be part of the installation, including other Eclipse projects!
  • Cons: Increased complexity in the installation process with boxes to check and more, more difficult questions to answer.

To install Papyrus-RT using this method, follow the instructions at Installing Papyrus for Real Time Using the Eclipse Installer


Eclipse Installer - Tester Installation

This installation procedure provides testers with the latest development build of the tool, and it is not unusual to have more than one such builds during the day. This is required for our testers to quickly validate new functionality in order to move forward.

Once installed, the tool will not change unless you explicitly update it.


Installation instructions are found in the Tester installation of Papyrus for Real Time

Note.png
Warning
Because of the complexity of this approach and its inherent potential instability, there cannot be any warranties as to the stability of these builds nor that any particular feature being fully implemented (or even working!). As such, use at your own risk!


Current State

2016-06-03

We consider the following as being the state of the tool:

Structure modeling is at a satisfactory point. This means that the user experience is good and that you can accomplish all tasks related to capsule structure and protocol definition. You may encounter a few isolated usability issues, which we encourage you to report. Note that we do not yet have an implementation of capsule or protocol inheritance.

State machine modeling is probably still at an “expert-friendly” level in many areas. However, this is currently a focus for part of the development team and there will be big improvements in the upcoming weeks. There are also still usability issues and some state machine diagram artefact rendering issues (e.g., with external self-transition after a restart of the tool).

Hierarchical state machines are not currently supported, but you can use sub-states in state machines to achieve similar capabilities (with obvious limitations).

Code generation and the accompanying runtime is currently working well. If a problem is encountered in this area, doing a “make clean” in the CDT project where the code is generated and a “regenerate” is likely to solve any lingering issues.

All other capabilities, e.g., sequence diagrams and activities, are still at the Papyrus UML level and have not yet been adapted to UML-RT.

Feedback

If you have any further questions, please do not hesitate to contact us directly. Evaluating a new, complex tool like Papyrus-RT can be a difficult exercise and we would like to help you getting through it.

Thank you for your interest in this technology.

Back to the top