Installation

Releases and Builds
A release is a version of Eclipse that the Eclipse Foundation deems stable and suitable for production use. A build can come in a variety of flavors such as stream, integration, or nightly. Details on what each of those mean can be found at http://download.eclipse.org/downloads/build_types.html. If you are unsure about which version to download, download the latest release.

Once you've decided which version of Eclipse you want, you may be presented with a rather long list of things that you can download. Depending on which download mirror you are using, this list will vary in length, but you should always have an option to download at least the Eclipse SDK. CFE will work with either the Eclipse SDK or the Platform Runtime Binary. The SDK includes support for Java projects and a number of other things, while the Platform Runtime Binary provides a minimal set of base functionality. If you don't intend to do any Java development, the Platform Runtime Binary is probably the best option as you can download the rest of the tools that come with the SDK download separately. At the time of this writing, the latest release is 3.01 so the rest of this article will be working on the assumption that you have downloaded the Platform Runtime Binary for that version. You can download the necessary files at http://eclipse.org/downloads/index.php.

Once you have downloaded the appropriate version of Eclipse, you can extract it to any location on your hard drive. Once it is extracted you can run Eclipse by navigating to the folder you extracted it to and double-clicking on the Eclipse executable. The file extension of the executable depends on which operating system you are using, but it should be the only file called eclipse in that directory.

When Eclipse starts up for the first time, you will be asked to specify a location for the workspace. The workspace is what Eclipse uses in the same way as a lot of Windows applications use the user profile directory. That is, it is where a lot of the configuration and metadata about your plug-ins will be stored. It may also be where you keep your project files, but that is certainly not a requirement and probably not recommended. If in doubt, accept the default location for the workspace. You will probably also want to tick the check box telling Eclipse to always use that location. If you do, you can change that setting at any time by going to: Window > Preferences > Workbench > Startup and Shutdown.

Once you have specified the workspace location you should be presented with the welcome screen. It's probably a good idea to explore the information provided in this page as once you start using Eclipse, you will probably forget about learning the bigger picture and want to answer specific questions. It will help you enormously in the long run if you invest the time up front as many of the concepts in Eclipse are quite different from other IDEs and editors.

Once you're satisfied that you know enough to begin, you'll probably want to download CFEclipse. Eclipse has a very convenient mechanism for doing this called update sites. Plug-in authors can create a site that has a particular structure and set of files that Eclipse can use to determine if it has the most up-to-date version of that plug-in. You can configure Eclipse to download and install a plug-in from one of these sites by going to: Help > Software Updates > Find and Install.

On the dialog box that appears, check the radio button labeled "Search for new features to install," then click Next.

On the next screen, click the button labeled "New Remote Site". In the dialog box that appears, type CFEclipse or something similar for the name, and http://cfeclipse.tigris.org/ as the URL, then click OK to close the dialog.

Check the check box beside the CFEclipse update site you just added and click Next. You should be presented with a list of CFEclipse releases. You only need to check the check box beside the most recent release and click Next.

You should be presented with the CFEclipse license agreement, which you'll probably agree to, and then click Next.

Eclipse now has enough information to install the CFEclipse plug-in, so click the finish button.

During the install you may be presented with a warning that you are installing an unsigned Feature. This is normal, and as long as you trust us, you can continue and install the feature anyhow.

Once the installation completes you should be prompted to restart Eclipse. We recommend that you do restart because otherwise some features such as preference pages may not appear correctly.

If you managed to follow all the steps above and have restarted Eclipse, you should be ready to start using CFEclipse.