Downloading Specific Target Platform - quality-manager/onboarding GitHub Wiki
Sometimes you will need to download Target Platforms specific to certain builds (ie when, for some reason, the newest Target Platform was released but causes our source code to not compile). Each time a build is ran the target platform used for that build is also released.
- Open the "Team Artifacts" Tab
- Open the "Rational Quality Manager" repository connection (NOTE: not the private repository)
- Open the "Builds" folder and double-click on "RQM mainline". A new tab should have opened named "Builds"
- Click on the build you want to download the Target Platform for. Most likely this is the latest green build but can be different based on need.
- A new tab should have opened up. At the bottom click on "External Links" and Click on the "RQM
<version>
Integration -<build id>
" section. - Right click on "RQM
<version>
Integration -<build id>
: Developer offering for the build" and copy the link. - Open your Eclipse preferences window and search for "Target Platform"
- Under the "Target Platform":
- Click "Add"
- Select "Nothing: Start with an empty target definition" and click "Next"
- Click "Add"
- Select "Software Site" and click "Next"
- Click "Add"
- Paste the link copied above in the "Location" section
- Give it a meaningful name. We suggest naming it with the as the build id it was used in. Click "Ok"
- Select
RQM-<version>-Integration Prerequisites
and click "Finish"
- The Target Platform should now be downloading. This may take a while.
- After it is done downloading give it a meaningful name. Again we suggest giving it the same name as the build you are downloading the target platform from. Click "Finish".
- The Target Platform will now be in your "Target definitions" area. Select the newly added Target Platform, click Apply, then Click "Ok". This will apply the Target Platform and rebuild your entire project. This may take a while to complete.
If you have target platform issues:
- Shut down RTC.
- Terminate all the Java/Eclipse processes.
- Delete all files and directories in <workspace>/.metadata/.plugins/org.eclipse.pde.core/.bundle_pool/. Note, on Mac, click
Command + Shift + .
in Finder to display hidden files/folders. - Restart RTC.
- Reload your target platform.
- Regenerate your repository.
If loading the target platform is slow:
In Eclipse 4.7+, the target platform sometimes is slow loading since Eclipse is checking all old target platforms and going through the timeout process for those target platforms that are no longer active. Fortunately, there is a work-around. Unfortunately, the work-around has to be done on a regular basis since a new software site is added every time you download a new development target.
Work-around:
- After the target platform has loaded, edit the target platform (
Eclipse >> Preferences >> Plug-in Development >> Target Platform >> <select the target platform> >> Edit
). - Select the location (software site) of the target platform and click
Edit
. - For the software site of the target platform, click
Manage
. - Disable or remove all software sites related to old target platforms. Note: It appears that all the software sites can be safely removed when using a Target Definition (for example,
ETM-7.0.0-Integration Prerequisites
).