CIS 120: Programming Languages and Techniques I
Fall 2015

OCaml, Eclipse and OcaIDE Setup

You may skip "Install OCaml" and "Install Eclipse" if working on SEAS lab machines.

  1. Mac Users Only Install X11 libraries (needed for the OCaml graphics libraries to work):
    • Install Apple's XQuartz version, which is available here:
    • Before moving on to the next step, make sure you LOG OUT of your user account so that the X11 install can complete.
    • 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, try reinstalling XQuartz and then contact the course staff for help.
    • Next, install the Java Development Kit (JDK) 7. You can download it from this this site (after accepting the terms & conditions). Make sure you do this step before installing Eclipse or OCaIDE.
  2. Install OCaml version 4.01. We recommend:
  3. Install Eclipse
    • To run Eclipse, a Java Runtime Environment (JRE) must be installed. This will already be the case on most modern machines, but you can use this link to check if Java is installed on your machine.
    • Visit the Eclipse download page.
    • 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.
    • Launch Eclipse. The first time you run Eclipse, you need to choose a workspace (a folder that stores your projects). Use the default location that Eclipse suggests, or choose your own location.
  4. Install OcaIDE
    • In Eclipse, click Help » Install New Software...
    • In Work with, enter then click Add, OK.
    • 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.
    • Click Restart Now. After Eclipse restarts, close the Welcome tab and click Window » Open Perspective » Other... » OCaml.
    • 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). 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.
    • 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.
    • 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.