Updating the Force.com IDE
(Redirected from Force.com IDE Installation and Updating)
Updating the Force.com IDE is easy! Using Eclipse’s built-in update capabilities, you can quickly install new versions of the IDE as they become available. The instructions on this page will guide you through the process step-by-step.
If you are using a version of the IDE older than the Winter '09 Generally Available release, there is no direct upgrade path to the current release. First uninstall the previous version, then install the latest release.
More information about this product is available at the Force.com IDE main page.
Contents |
Updating the Force.com IDE to the Latest Version
Before you begin, you may want to review the release notes.
- Launch Eclipse, click on Help > Software Updates > Find and Install.
- Click on "Search for new features to install" and click "Next".
- At the “Update sites to visit" step, check the "Force.com IDE" update site from your previous installation. It should point to http://www.adnsandbox.com/tools/ide/install/. Also make sure “Automatically select mirrors” is checked. This is important. Click "Finish" to proceed.
- All of the required dependencies were probably installed into Eclipse when you first installed the IDE, but it will not hurt to check the "Europa Discovery Site" (or in Eclipse 3.2.x, the "Callisto Discovery Site").
- In the Search Results, select "Force.com IDE". If Force.com IDE does not appear in the results, it most likely means you already have the latest version installed. If you are certain there is a more recent version, make sure your Force.com IDE update site has the correct URL. Otherwise see the troubleshooting section below.
- Because this is an update and you already have the dependencies, you shouldn't need to install anything else. If there is an error, you may need to go back, check the Europa (or Callisto) site, and then at this step click the "Select Required" button in the dialog.
- Click "Next", accept the terms and click "Next" again. Click finish and presto, you’ve got the IDE installed.
- You may be prompted to restart Eclipse. It is recommended to restart at this point, prompted or not.
- After Eclipse restarts, close and then reopen the Force.com Perspective to repopulate your existing projects. Note that it is advisable to create a new workspace unless you have a specific reason to keep the old workspace. As discussed in the Release Notes, the recommended procedure is to start a fresh workspace and new projects.
Troubleshooting
- If you notice that you can't use your existing projects after this upgrade, you may have installed over an unsupported Developer Preview version. There is no direct upgrade path from a Developer Preview release to GA or later, as described in the Release Notes. You will need to uninstall or disable the older Force.com IDE plug-in, and delete and recreate your Force.com projects.
For more information, visit the Force.com IDE home and the FAQ.