 |
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.
|