CIS 120: Programming Languages and Techniques I
Fall 2017

CIS 120 Tools Setup

Code editors / Development Environments

NOTE: As of Fall 2017, CIS 120 has adopted Codio as the editing platform for OCaml code. See our instructions for using Codio. Codio greatly simplifies the installation and configuration process.

If you opt not to use Codio, we recommend one of the following options:

  • Emacs, Vim, or another standalone editor. Follow these instructions for setting up your environment from Real World OCaml (in particular, merlin tool)
  • Or, follow the steps on this page to set up Eclipse + OcaIDE

Eclipse + OcaIDE

Deprecated as of Fall 2017

Step 0: (Mac Users Only) Install X11 Libraries

These are needed for the OCaml graphics libraries to work:

  1. Install Apple's XQuartz version, which is available here:
  2. Before moving on to the next step, make sure you LOG OUT of your user account so that the X11 install can complete.
  3. Check to see that the directory /usr/X11/lib exists and that it contains the file libX11.6.dylib (this should have been created when you installed XQuartz). If this isn't the case, see the instructions below.

    Here are some steps to follow to resolve this sort of issue with the X11 dynamic libraries. If you encounter trouble with one of these steps, please post a question on Piazza, or come to TA office hours.

    1. Open the terminal on your computer. It's located in /Applications/Utilities/ You should see a terminal prompt which looks something like this:
      YourComputerName:~ YourName$
      The $ is called a prompt, and you can type commands after it, then press return to execute them.
    2. Verify that the X11 libraries exist by running the following command in Terminal. Type or copy-paste the first line (not including the dollar sign), and verify that after you press return, the terminal prints out the second line.
      $ find /opt -name libX11.6.dylib
      If something goes wrong here, make sure you installed XQuartz properly and restarted your computer.
    3. Now, make a new directory named lib in your home folder, and move into that directory, by running the following commands (press return after each, and don't include the dollar signs).
      $ cd
      $ mkdir lib
      $ cd lib
    4. Create a symbolic link to the dynamic library in ~/lib.
      $ ln -s /opt/X11/lib/libX11.6.dylib libX11.6.dylib
    5. Verify that the symbolic link was created in that directory by running the command in the first line below. You should see output which looks similar to this.
      $ ls -la $HOME/lib
      total 8
      drwxr-xr-x   3 YourName  staff   102 Jan 29 01:35 .
      drwxr-xr-x+ 36 YourName  staff  1224 Jan 29 01:35 ..
      lrwxr-xr-x   1 YourName  staff    27 Jan 29 01:35 libX11.6.dylib -> /opt/X11/lib/libX11.6.dylib
    6. Save any open files, and restart your computer.

Step 1: Java Development Kit (JDK) 7

  1. To run Eclipse, a Java Runtime Environment (JRE) must be installed. You verify that you have the JDK 7 installed by running the java -version command (from the Command prompt in Windows or the terminal on Mac):
    $ java -version
    java version "1.7.0_71"
    Java(TM) SE Runtime Environment (build 1.7.0_71-b14)
    Java HotSpot(TM) 64-Bit Server VM (build 24.71-b01, mixed mode)

    You should see output similar to lines 2-4 above. Any higher version of Java will also work for this class.

  2. If you do not have the JDK 7 installed, you can download it from this site (after accepting the terms & conditions). Select the version for your OS from the table titled "Java SE Development Kit 7u79."
Note: Make sure you do this step before installing Eclipse or OCaIDE.

Step 2: Install OCaml Version 4.01 or 4.02

We recommend:

  • Mac Users: Install the OS X version ocaml-4.01.0-intel.dmg.
    • This distribution works with OS X 10.7.5 and later. If you have an earlier version, contact the course staff for help.

Step 3: Install Eclipse

We recommend using the Eclipse "Mars" release version 4.5, but earlier versions should work too. Make sure you have completed Step 1 before installing eclipse.

  1. Visit the Eclipse download page.
  2. Click on the link for your platform on the right side of the screen and install it by simply unpacking the downloaded file onto your desktop.
    • Note: The 64-bit Windows version of Eclipse may not be able to locate Java installations. If this happens, use the 32-bit Windows version instead.
  3. Launch Eclipse.
  4. The first time you run Eclipse, you need to choose a workspace (a folder that stores your projects).
    Note: We recommend creating two fresh workspaces for CIS 120 projects. The first workspace you should use for the OCaml part of the course; the second you should use for the Java part of the course. You can create the second workspace at any time.

Step 4: Install OcaIDE

OcaIDE is an Eclipse plugin for working with OCaml code.

  1. In Eclipse, click Help » Install New Software...
  2. In Work with, enter then click Add, OK.
  3. Check OcaIDE and click Next, Next, I accept, Finish to accept the license and install the software. Eclipse will prompt you to accept unsigned code.
  4. Click Restart Now. After Eclipse restarts, close the Welcome tab and click Window » Open Perspective » Other... » OCaml.
  5. Go to Window » Preferences (Mac OS X users, go to Eclipse » Preferences). Click on "+" or "▶" next to OcaIDE to expand the tree and then click on Paths. If all the paths in this panel (except for possibly make and omake) are already filled in, then continue to the next step. Otherwise, click Browse next to OCaml Binaries Directory and choose the "bin" directory inside your OCaml installation directory (for example, C:\Program Files\ObjectiveCaml\bin or C:\Ocaml\bin). Then press Apply. Eclipse should fill in additional path values for you (ocaml, ocamlc, etc).
    • Under Other tools » OCaml lib path, click Browse and choose the "lib" directory inside your ObjectiveCaml installation directory. Press OK to close the dialog.
  6. Near the top right of Eclipse, you should see an OCaml button and Java button, with the Ocaml button selected. If you only see the Java button, click the button to the left which looks like a window with a yellow "+" sign, and then double click on "OCaml". Now you are in OCaml mode.
  7. Click the "Ocaml Toplevel" tab at the bottom of the workspace. You should see the OCaml output display:
    	OCaml version 4.01.0
    Type into the prompt (do not type next to the #; the prompt box is at the bottom of the tab):
    print_endline "hello world";;
    You should see the output:
    hello world
    	- : unit = ()
    If this doesn't work, ask a TA for help.

Step 5: Test the OCaml Graphics setup

You will now create a new Eclipse project and test that graphics are working.
  1. Follow the graphics setup instructions.
  2. Once your computer shows the camel picture, you have completed setup! Show your recitation TA.

Step 6: Project setup

Read the instructions for creating a new Eclipse project.