Step 1: Get Java
Check the system requirements. Make sure you have an appropriate version of Java installed.
Step 2: Download the installation package
Latest official release:
Note: If your browser tries to display the file, instead of downloading it, then use "Save link as.." which you get when you right-click or shift-click the link.
Once you have loaded the file, go to the Installation Instructions.
Step 3: Installation
Double-click the install file (bluejsetup-221.exe).
This will run a standard installation. Follow the instructions on screen. The installer will install the executable bluej.exe. Execute this to run BlueJ.
If you have more than one Java version installed, BlueJ will let you select your preferred version the first time it is executed. This can be changed later by running the "vmselect" program, which will be installed into the same directory as BlueJ.
Note: BlueJ requires Java 2 or later, and thus runs only on MacOS X. Updating to the latest Java version (via the Software Update feature) is recommended.
Download and expand the install file (BlueJ-221.zip). Move the resulting folder to your preferred location (for example Applications).
Make sure you have a suitable JDK or J2SDK. The Sun JDK/J2SDK is recommended as it is the most well tested. Currently the "gij" (GNU java interpreter) cannot be used.
Run the installer by executing (from the command shell)
/path/to/jdk/bin/java -jar bluej-221.jar
... where "/path/to/jdk" should be replaced by the actual path to the JDK.
Note: if you have a suitable java binary in a directory listed in your PATH environment variable, you may be able to omit the "/path/to/jdk" above. Be careful that this does not run an incompatible java implementation (such as "gij") however! You can check if a Java implementation is in your path by runng "java -version".
In the installer, select an installation directory and your JDK directory and install. By default, the installer will install into a directory called "bluej" inside the directory from which you launch it, and it will pick up the JDK location automatically (if it is run correctly according to the instructions above).
In the directory where BlueJ was installed, you will find a file named bluej. This is the launcher script. Execute this script to start BlueJ. For example: cd bluej # change into installation directory
./bluej # execute the "bluej" launcher script
Note: This installer can be executed on any system with Java 2 installed (including Windows and MacOS), but Windows/MacOS specific icons and configurations will not be present.
Optional: Remove the Installer
If you do not want to make further installations, you can now delete the installer file.
Step 4: Opening a project
After starting BlueJ, open a project by selecting "Open" from the Project menu. You can find some examples in the "examples" directory. After the project has been opened, right-clicking (Mac: control-clicking) a class lets you select a constructor from a pop-up menu to construct an object.
Optional: Subscribe to mailing list
If you want to be notified of new releases, go to bluej-announce and subscribe.
If you are interested in general discussion of BlueJ-related questions, read or subscribe to bluej-discuss. There is also an archive of past messages that you can read without subscribing.
Where to from here?