Installing to an existing Eclipse instance

This chapter describes the steps that are needed to install YAKINDU Statechart Tools to an existing Eclipse instance. Let’s assume you already have Eclipse up and running and now you want to install YAKINDU Statechart Tools as an additional software item (plugin).

Please note: On macOS, this only works if your .app file is located in your Applications folder.

In the the Help menu, select the Install New Software menu item:

Selecting "Help → Install New Software" in the main menu

Selecting Help → Install New Software in the main menu

The Install wizard opens:

The "Install" wizard

The Install wizard

Click on the Add... button near the upper right corner of the wizard.

A dialog opens, asking you to specify the update repository you want to install the new software from.

Please note: Update site URLs are available online via the YAKINDU Statechart Tools download page.

Adding a software repository

Adding a software repository

After entering name and location of the update repository, click OK.

Eclipse establishes a network connection to the update repository, asks it for available software items and shows them in the install wizard:

Selecting YAKINDU Statechart Tools software items

Selecting YAKINDU Statechart Tools software items

Please check at least Xtext Integration Utilities and – no surprise – YAKINDU SCT. (You can also install the respective source code items. However, unless you want to have a look at that source code or even want to modify it, you don’t need them.)

Click Next >.

Eclipse tries to integrate the new software with the software that is already installed. If it detects any mismatches between requirements and provisions, Eclipse will try to find a solution in order to mitigate this problem. The screenshot below shows such a case:

Install remediation page

Install remediation page

Select the most appropriate solution, then click Next >.

The wizard shows the software to be installed and gives you the opportunity to review the changes:

Reviewing the items to be installed

Reviewing the items to be installed

Click Next >.

The wizard asks you to review and accept the terms of the new software’s license agreements.

Accepting the new software's license agreements

Accepting the new software’s license agreements

Select the radio button labelled I accept the terms of the license agreements (if you do), then click Finish.

Eclipse starts to download the software and installs it on your computer. This may take some time.

Installing software in progress ...

Installing software in progress ...

If the installation was completed successfully, Eclipse needs a restart in order to have the changes take effect. A dialog asks whether you want to restart Eclipse right now or later:

Restarting Eclipse after software installation

Restarting Eclipse after software installation

After the restart, Eclipse displays its Welcome window, now also featuring YAKINDU Statechart Tools:

Eclipse presenting the "Welcome" window

Eclipse presenting the Welcome window