thanks quarks and anchnk for addressing these problems and finding solutions, i will make updates accordingly.
my previous post had a quick fix for the javadoc issue on windows (modifying the system PATH), this is not recommended, see quarks post above.
Below is a detailed walkthrough for using the processingLibraryTemplate_20100507 on windows, just in case, its a long list, and i hope i didnt leave anything out, but it covers the setup on windows in detail and solves previously mentioned issues.
my setup:
- Windows XP
- eclipse Helios
- jdk1.6.0_24 (installed inside C:\Program Files\Java)
- processingLibraryTemplate_20100507.zip
Setup walkthrough windows (others please use the howTo on the library template wiki)
1) after downloading the libraryTemplate zip file, run eclipse.
2) under menu item Windows, choose Preferences and navigate to Java->Installed JREs. Here you will see a list of installed JREs, by default jre6 is installed on my machine. now click add and choose Standard VM, a window pops up
2.1) for JRE Home, select directory jdk1.6.0_24 and click Finish
2.2) now tick jdk1.6.0_24
2.3) confirm preferences with OK
3) now create a new java project
3.1) select Use a project specific JRE (jdk1.6.0_24 should be selected from the pulldown menu) or
Use default JRE, it should say jdk1.6.0_24 if not, choose Configure JREs and select jdk1.6.0_24
3.2) click Finish
4) right click onto the newly create project and select Import … a window pops up
4.1) select General->Archive File and click Next
4.2) browse to and select the processingLibraryTemplate_20100507.zip file, then click Finish
5) clicking the + icon of your java project inside the Package Explorer on the left will reveal folders src, data, examples, etc. The src folder is highlighted with a small red icon with a white cross inside
5.1) right click your project folder and select Properties
5.2) under Java Build Path select Tab Libraries. here you should find 1 item, the JRE System Library [jdk1.6.0_24]
5.3) now you need to add processing's core.jar library (and others if necessary)
5.4) click Add External JARs and navigate to the core.jar file (i have mine inside my eclipse workspace in a sub-folder libs)
5.5) confirm the properties for your library with OK
5.6) the red icon with the white cross should disappear
6) click the + icon of the resources folder
6.1) double click file build.properties and make changes to (1) and (2) according to the comments for each step (in case a GUI window pops up instead of a text based editor window, click button 'build.properties' at the bottom of that window to switch to text-editor mode, it should look like this)
6.2) now save the build.properties file
6.3) right click the build.xml file and select Run-As->External Tools Configurations … (or alternatively from the Menubar: Run->External Tools->External Tools Configuration... which also gives you an overview of all available custom ant files)
6.4) A window will pop up. Double click Ant Build, then click the 'yourProjectNameHere' build.xml item under the Ant Build branch in the navigation tree on the left
6.5) select tab JRE and tick Separate JRE and select jdk1.6.0_24 confirm with Apply then click Close
6.6) right click on the build.xml file and select Run As -> Ant Build
6.7) You should see Build Successful in the console output
in case you get an error message, see Known Error Messages below
7) if you scroll up the console output after a successful build you might see:
versionSourcefile:
[echo] C
[replaceeregxp] The following file is missing: ...
7.1) to fix this warning, open the build.xml file. on line 160 replace delimiter=":" with delimiter=";"
8) Another mini fix, which did not bother the compiler in my case, but see quarks post above:
inside the build.xml file line 177 add $ after the ; so that {project.bin} will read as ${project.bin}
What do i get after a successful build?
a distribution folder will be create inside your library project folder including
1) a download folder with a .zip file containing your library and the necessary folder structure
2) a folder with examples, an index.html and stylesheet.css file using the default libraries html template (you are welcome to modify the html template and to make changes to colors, images, layout, etc.)
3) a reference folder with the javadoc.
An additional copy will be placed into the libraries folder of your sketchbook so that after each new build you can test your library immediately from within processing (note: you only need to restart processing after the first install so that processing recognizes your library).
Known Error Messages
1) C:\Documents and Settings\you\Documents\workspace\libs not found
what to do: follow steps 6 - 6.7
2) C:\Documents and Settings\you\My Documents\Processing\libraries not found
what to do: create a folder libraries inside your Processing sketchbook folder
3) Cannot run program "javadoc.exe": CreateProcess error=2, The system cannot find the file specified
what to do: follow steps 6.3 to 6.7