Jump to: navigation, search

Equinox/p2/Update UI Users Guide

About the Equinox p2 Update UI

If we're doing our job right, we won't need a user's guide for end-users to figure out the update UI! This page is provided for the curious folks who may want to know what the UI is going to look like but don't necessarily want to play with p2 yet.

How to get the new Update UI

If you want to use the new p2 UI to actually modify a running Eclipse, you'll need to provision an Eclipse SDK using p2 and add the end user UI feature. To follow step by step instructions for downloading the RCP agent that can help you with this task, see Equinox p2 Getting Started.

If you are using the Eclipse SDK and simply want to see what the UI looks like (without actually modifying your running Eclipse environment), you can load the p2 projects in your workspace and start up a new workbench. See Equinox p2 Getting Started for Developers#Getting the code. This workbench will include the the UI, although it won't operate on your running Eclipse.

Launching the new update UI

For now, the new p2 Update UI is located in the help menu alongside the existing update UI.

   P2MenuItem.jpg

The UI shows you what you currently have installed...

   P2InstalledList.jpg

...and what is available for install.

   P2AvailableList.jpg

What is available is controlled by what sites you have connected to. Clicking on Manage sites... will let you add and remove sites. For those of you familiar with p2 concepts, a "site" is a colocated metadata and artifact repository. For those of you who aren't, a "site" is a place where you can get cool software.

   P2ManageSites.jpg

Let's look again at the install list:

P2InstalledList.jpg

If you select something in this list, you can check to see if there are updates available for it. You can also try to uninstall it. We'll look at this more shortly. At the bottom you can control whether the system should automatically look for updates to what you have installed. There is also a link to the preference page that lets you control the schedule for updating and other preferences related to updating.

P2UpdatePrefs.jpg


For more information

If you encounter bugs, or would like to enter enhancement requests for this work, please use the Equinox Incubator category in Bugzilla. You can add the prefix "[prov]" to the subject line of the bug report to help us with bug triage.