Build Instructions (Updated)

Build Instructions

Disclaimer : This is an unofficial wiki I've made and not yet verified!

So are you ready to build Processing in its raw form? Dive in!

You require the following components (latest versions obviously):

• JDK 6
• Apache Ant
• git (Windows/Mac users may install GitHub for Windows/Mac)

Setup Environment Variables

The process of setting up environment variables is different for each platform. ###Windows

• Windows XP, right-click My Computer → Properties → Advanced → Environment Variables
• Windows 7, Start → Search "Environment Variables", and click "Edit the system environment variables".
• Windows 8: Control Panel → Click More Settings on the left →Search "Environment Variables" in Control Panel, and click "Edit the system environment variables".

We need to set two environment variables.

Set JAVA_HOME

Under user variables, click New.

Set Name as: JAVA_HOME

Set value as location to the JDK 6 installation folder. For ex, on our system the value is C:\Program Files\Java\jdk1.6.0_41

Set Path

Double click on Path variable. If a variable named Path doesn’t exist, create a new one and set its name as Path. Set its value as location of JDK 6’s bin folder. Insert a semi-colon separator too, if multiple paths already exist in the value field. For ex, Add this to the end of value: ;C:\Program Files\Java\jdk1.6.0_41\bin

Log out and log back in for changes to take effect.

###Mac OS X Set JAVA_HOME

To set JAVA_HOME, open Terminal and type:

open /Applications/TextEdit.app/ ~/.bash_profile

Add the following line:

export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home

Save the file, log out and log back in for changes to take effect.

###Linux Set JAVA_HOME

To set JAVA_HOME, open Terminal and type:

sudo gedit ~/.bashrc

Add the following line:

export JAVA_HOME='<path to your jdk installation directory>'

Save the file, log out and log back in for changes to take effect.

Cloning Time!

To grab a copy of the Processing source code to your system, go to Processing GitHub repo. If you see the Clone in Windows/Mac button, click that. If you want to clone via the terminal (git shell for Windows users), type:

git clone https://github.com/processing/processing.git

The repo is kinda big, nearly 1.5 GB. So go take a break while it downloads. Also remember that git's cloning process can’t be paused. If the download gets interrupted midway, you’ll have to clone the full thing again.

##Build It

Now it’s time to build the beast! Open Terminal(git shell for Windows users), from the processing folder, type:

cd build

ant run

It can take a few minutes if you’re building for the first time. If you did everything correctly, the Processing window should greet you. Cheers!

##Updating to the latest version

The main Processing repo gets updated regularly as the team continues development. To add the latest changes to your clone, cd to processing folder and type:

git pull

git update

If you’re getting build errors after updating, from processing/build folder, type:

ant clean

Try building again. You shouldn't see any more errors.