HOW TO BUILD PROCESSING ON YOUR FAVORITE PLATFORM

If you have questions about the contents of this document, 
ask questions at the discourse section of the site:
http://processing.org/discourse/yabb_beta/YaBB.cgi?board=os_core_pde


////////////////////////////////////////////////////////////////////

Update February/March 2010:

+ I'm in the midst of moving the build system over to ant, but haven't
  yet had time to update this document. For the most part, as long as you
  have a JDK installed, and Ant installed as well, you should be able to 
  cd to the build folder and type 'ant' to build, and 'ant run' to run.

+ On Windows and Linux, install ant and add c:\apache-ant-xxx/bin directory 
  to your path. On Mac OS X, you'll have ant as long as the dev tools are
  already installed.

+ On Windows and Linux, you'll need to set a JAVA_HOME environment variable
  that points to the root of a full JDK (not JRE). 

Troubleshooting:

+ An error message that reads "Unable to locate tools.jar. Expected to find 
  it in C:\Program Files\Java\jre6\lib\tools.jar" means you need to set 
  JAVA_HOME to your JDK (not JRE) installation.

+ Build errors regarding a lot of missing classes for processing.app.debug
  mean that JAVA_HOME is not set properly.

More to come...


////////////////////////////////////////////////////////////////////

//// Steps for First Time Setup 


1. INSTALL DEVELOPMENT TOOLS

1a. On Windows, install Cygwin. It's downloadable from 
    www.cygwin.com or specifically: www.cygwin.com/setup.exe

** of the packages, begin with the defaults, and add:

+ subversion - used for version control

+ make, gcc-mingw, and g++ - used to build processing.exe
  (this will also pull in gcc-core)

+ perl - use this version from cygwin, activestate or other windows 
         perl distributions have trouble

+ unzip, zip - for dealing with archives

+ included in the defaults, but make sure: coreutils, gzip, tar

+ not required but useful: 
  openssh - command line ssh client
  nano - handy/simple text editor (gnu pico ripoff)

** and be sure to leave the option selected for 'unix line endings' 

the cygwin installer is sometimes a little flakey, so it may take more 
than one try to get everything in there. in fact, it's often best to
run the installer once, and let it install all its defaults, then run 
it again, and select the items above. it's also useful to run the 
installer every few months to keep things fresh.


1b. On Mac OS X, install Apple's Developer Tools (Xcode).

    You'll also need subversion: http://subversion.tigris.org/
    Install it from Fink, Darwinports, or download as a package:
    http://metissian.com/projects/macosx/subversion/


1c. On Linux, you're pretty much on your own.. You need a pretty 
    standard development setup along with Subversion.


2. GRAB THE CODE FROM DEV.PROCESSING.ORG

As of August 12, 2005, we're no longer using CVS and have moved on to
the brave new world of Subversion. This is scary but hopefully will
alleviate some of the CVS annoyances. 

To get the code, type this from a prompt:
svn co svn://processing.org/trunk/processing

That part may take a while, especially for people outside the US or
who have a slow internet connection. (The JRE binaries are stored in 
SVN so that we can properly test on the exact platform/runtime setup
that we'll be releasing.)


3. INSTALL QUICKTIME FOR JAVA (Windows users only)

* You'll also need to install QuickTime for Java. Grab the QuickTime
  (and iTunes) installer from: http://www.apple.com/quicktime/download/
  or a version that doesn't include iTunes from here:
  http://www.apple.com/quicktime/download/standalone.html
  As of QuickTime 7 (iTunes 6), QuickTime for Java is mercifully
  included by default. 

* QuickTime 6 is no longer supported. QuickTime Alternative has 
  never been supported. Just use QuickTime 7.


4. BUILD IT

# now to build for the first time:
cd /path/to/processing/build/windows

# or if you're on linux
cd /path/to/processing/build/linux

# let's say you're into black turtlenecks and jeans
cd /path/to/processing/build/macosx

# and then..
./make.sh

# if everything went well, you'll have no errors. (feel free to make
# suggestions for things to include here for common problems)

# then to run it
./run.sh

# each time you make a change, use make to build the thing 
# and run to get it up and running. 


////////////////////////////////////////////////////////////////////

//// Updating to the Latest Version


5a. Each time you want to update to latest version:

cd /path/to/processing
svn update


5b. If you're getting strange errors when you try to build, especially
    if new folders have been added to the Processing repository, remove
    your 'work' folder and rebuild. Generally, this is a good idea to 
    do whenever a new release has been made, since that will involve
    files that may have been changed (or folders that have been moved).

# get to the processing folder
cd /path/to/processing

# remove the work directory
cd build/yourplatform
rm -rf work

# and try again
./make.sh

Unfortunately there isn't a way to know if new folders have
since been added. but if you're getting "class not found" errors
while building, then that's a good indicator that something is
missing from a subfolder.