Develop RCPTT UI tests with remote execution

Configuration and documentation for developing and running RCPTT UI tests in Eclipse

Supported Eclipse Target Platforms

Eclipse 4.x (built on E4)

• Oxygen (4.6)
• Neon (4.5)
• Mars (4.4)

Eclipse 3.x (legacy RCP)

• Indigo (3.7)

Feel free to create pull requests for other platform versions. This mainly requires a new Repository list in the Targlet definition.

RCPTT remote runner setup

The following is an overview of the steps detailed in the following sections:

1. Install RCPTT IDE ( https://eclipse.org/rcptt/download/ )
2. Import the Oomph project to your development Eclipse (see Get RCPTT into your Target Platform)
3. Create a Run Configuration in the development Eclipse with the given changes to run the tested application (see Run Configuration)
4. Create Run Configuration to connect to a Remote AUT in the RCPTT IDE (see RCPTT IDE)
5. Start the Runtime Eclipse from the development Eclipse
6. Execute the tests from the RCPTT IDE

Eclipse IDE

Get RCPTT into your Target Platform

1. In the Eclipse IDE where you want to add RCPTT runtime to your Target, click File -> Import... -> Oomph/Projects into Workspace
2. Click on the Add user projects button (green plus + sign on the upper right) and select Github projects and paste https://raw.githubusercontent.com/IncQueryLabs/rcptt-remote-configuration/master/com.incquerylabs.rcptt.remote.setup/RemoteRCPTTConfiguration.setup
3. Check Github Projects/<User>/Remote RCPTT Configuration and select the stream depending on your target platform (3.x or 4.x)
4. Variables page: select the required Eclipse Target Platform version
5. Run the setup tasks (you may have to restart Eclipse to install Oomph task specific features from P2 and rerun the Setup tasks)

Run Configuration

1. Create or reuse an Eclipse Application
2. Add to VM Arguments: -DteslaPort=7930 -DeclPort=5380 -Dosgi.framework.extensions=org.eclipse.equinox.weaving.hook
   • If you use bundle pools and get java.lang.NoClassDefFoundError: org/eclipse/osgi/internal/hookregistry/HookConfigurator errors, you may have to add also the following: -Dosgi.frameworkClassPath=.,file:<pool-location>/plugins/org.eclipse.equinox.weaving.hook_<version-in-target-platform>.jar This is needed the default value for osgi.frameworkClassPath may use a different version (not in your target platform)
3. Plug-ins:
   • Launch with: plug-ins selected below only, make sure to have all aspectj, equinox.weaving and rcptt plugins enabled
   • Set auto-start to true on: org.eclipse.equinox.weaving.aspectj

RCPTT IDE

• Create new Remote Application Under Test Run Configuration
  • Host: localhost
  • ECL port: 5380
  • Tesla port: 7930

Note that the ports can be set to any chosen value, just make sure the VM arguments match the Run Configuration. This is useful if you want to run multiple Remote AUTs at the same time.