diff --git a/build/howto.txt b/build/howto.txt index 7622499ff..2bf56d364 100755 --- a/build/howto.txt +++ b/build/howto.txt @@ -1,166 +1,4 @@ -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. +As part of a grand plan for Casey and I to rid ourselves of as much of +the duct tape and chewing gum that's holding together processing.org, +this document has been moved to Google Code: +http://code.google.com/p/processing/wiki/BuildInstructions