CS 1705  Home  Syllabus    Lab Times  Office Hours  Topic Calendar Contact Us      Discussion Forum Course Materials  Course Notes  BlueJ  cs1705 Package API  Test Case API  Java API  Java SDK  Java Tutorial Assignments  Homework  Labs  Lab Grading  Programs  Program Grading  Web-CAT Grader  Choose Lab Section			BlueJ Version Used in Class Latest BlueJ Version: 1.3.0 Latest VT-CS Installer: bluejsetup-130-vt-custom-1_6.exe (v1.6) CS 1705 Package: cs1705.jar (v1.6 11/12/2003) Official Home: BlueJ Home Page A new release of cs1705.jar was posted on 11/12/03. See the section below on upgrading your installation for instructions on installing it. Contents: Installing BlueJ Upgrading Your Installation to the Latest Release Installing on Mac OS X Common Problems Useful Links If you have difficulties during installation, check the section on common problems first. Installing BlueJ Download the Java SDK Download the Windows Installation of Java J2SE 1.4.2 SDK from java.sun.com. (Do not download the NetBeans version or the JRE distribution.) Be prepared for a long wait if you are using a modem. The "Windows Installation" SDK link will allow you to download a network installer that is about 365K, but which must be run with an internet connection available. When run, it will download a total of approximately 44MB to complete the installation. If that will take too long for you, go to the undergraduate laboratory and bring a blank CD-R. Pick a machine in McBryde 118, download the Windows Offline Installation (about 44MB), then burn it to your CD-R yourself (don't just drop off a disk with the lab consultants). All of the lab machines in McBryde 118 have CD-RW drives for student use, although the ones in McBryde 116 do not (AFAIK). Install the Java SDK on your machine Execute the downloaded Windows network installer file for Java J2SE 1.4.2 SDK (j2sdk-1_4_2-windows-i586-iftw.exe for the network install, or j2sdk-1_4_2-windows-i586.exe for the offline install). (The network installer file will download and install the required Java files.) Download the VT-CS BlueJ IDE Note that we are not using the standard BlueJ version distributed from the BlueJ home page. We also are not using the BlueJ version distributed on CD with the text book. Instead, we have a custom installer just for this course. In addition to the materials in the standard distribution, the custom installer also includes the support classes used in class projects for this course, a local copy of The BlueJ Tutorial for your machine, a local copy of Unit Testing in BlueJ, and a few course-specific customization settings that are not part of the standard installer distributed from BlueJ's home. So be sure to use the course-specific installer. Download the VT-CS custom installer for the BlueJ 1.3.0 integrated development environment. Install the VT-CS BlueJ IDE Execute the downloaded VT-CS BlueJ 1.3.0 installer. Follow the instructions on screen. The installer will install the executable bluej.exe at the location you specify. Execute this to run BlueJ. A Start Menu shortcut and (optionally) a desktop shortcut for this program will also be added. 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. For this course, we are using the J2SE SDK v1.4.2. Upgrading Your Installation to the Latest Release As the result of changes in the cs1705 package over time, new versions of the library file cs1705.jar may be posted on this web site. You can update your BlueJ installation to the latest version easily using these instructions. As the result of changes in the cs1705 package over time, new versions of the library file cs1705.jar may be posted on this web site. You can update your BlueJ installation to the latest version easily using these instructions. Download the latest version of the cs1705.jar file. locate your BlueJ\lib folder and copy the cs1705.jar file into it, overwriting the previous version. If you installed BlueJ in the default location, this folder will be at C:\BlueJ\lib; otherwise, locate it at the custom location where you installed BlueJ. If you are unsure which version of cs1705.jar you have installed, use the following command in a command line window (adjust the path name if your BlueJ installation is at a location other than the default). C:\> java -cp C:/BlueJ/lib/cs1705.jar cs1705.Version cs705.Version: package cs1705, v1.3 2003-09-27 Installing on Mac OS X Unfortunately, Apple machines do not meet the computer requirement for the Department of Computer Science. We do not have the resources to provide a custom installer for Macs, but if you want to pursue it on your own, these instructions may help you. Install the Java SDK v1.4.2. Download the Mac version of the BlueJ installer. There is a .sit file for OS X, and a general-purpose jar version for other platforms (including earlier versions of Mac OS). Download the submission.defs file and place it where BlueJ can find it: Either control click or right click on the BlueJ application icon. Choose "Show Package Contents". Open the Contents folder. Open the Resources folder. Open the Java folder. Place the submission.defs file in the Java folder. Download the latest cs1705.jar file and place it where BlueJ can find it. We suggest placing it in the same folder as submission.defs following the instructions above. Start BlueJ. Select Tools->Preferences..., then click the Libraries tab. Click "Add", then browse to the location where cs1705.jar is located and select it. It should then show up under "User Libraries" in the Libraries tab. That should be enough to get things working for you. Try writing a simple robot task like this: import cs1705.*; public class TryKarelOut implements RobotTask { VPIRobot karel = null; public void task() { World.startEmpty(); karel = new VPIRobot(); karel.move(); karel.move(); } } See if you can compile and run it successfully. If so, then your Mac installation is working. Also, be aware that this will just get you the bare minimum to get up and running on a Mac. There is a lot more to the "custom" BlueJ we are using than these two files. Basically, this Mac installation won't have any of the course-specific templates for creating new classes, or course-specific entries on the help menu, or the same color scheme as in the lab, and on and on. However, if a simple robot task compiles and runs for you, then you should still be able to do everything you need to do (you'll just have to fill in the comments yourself). If an Apple-oriented student with sufficient motivation would like to write out the steps needed to add the other course-specific features to a Mac installation, contact Dr. Edwards. If you are working on Mac OS X and find the default font a bit too light for your tastes, try these steps: Either control click or right click on the BlueJ application icon. Choose "Show Package Contents". Open the Contents folder. Open the Resources folder. Open the Java folder. Open the bluej.defs file with a text editor (such as BBEdit, for example). Look for these font settings and change them to the values below: bluej.editor.font=Courier-bold bluej.editor.fontsize=12 You could also choose to use Monaco, or any other font of your choice. Common Problems If you try to recompile your code when your program is stuck in an infinite loop, you may receive the following BlueJ error: BlueJ configuration problem: text not found for message ID compile-while-executing You can correct this error so that you get the proper message in one of two ways: Download the file dialogues and place it in your BlueJ/lib/english folder, overwriting the previous version there. Or, Reinstall BlueJ using the lastest version of the course-specific custom installer. When trying to install Sun's Java SDK 1.4.2 using the internet-based installer (the default if you choose "Windows Installation"), some students have received the following error: The installer cannot proceed with the current Internet Connection proxy settings. Please check the installation notes for more information. Sun's download/install help says: If you are behind an authenticated proxy server, you must use the Windows Offline Installer instead. Yes, that means downloading the 45MB file first, and then installing from it. Useful Links the BlueJ home page The BlueJ Tutorial Unit Testing in BlueJ API documentation for CS1705 course-specific classes The BlueJ Reference Manual (still very rudimentary, mostly covers configuration information) You can also download a local copy of the full Java documentation (about 34MB--not necessary now, but may be helpful later if you do a lot of Java programming when not connected to the network.)