How do I provide v2 and v3 versions of a library?

Floritude

I've successfully recompiled my AULib library using the new Version 3 Eclipse template. I'd like to continue to offer the previous build for Version 2 users, which is explicitly supported (https://github.com/processing/processing/wiki/Changes-in-3.0). I'd like to know how to make that happen.

Right now on my server I have a file called AULib.zip and a companion AULib.txt, which together have been used by the Version 2 library manager. The Library Guidelines at https://github.com/processing/processing/wiki/Library-Guidelines don't seem to tell me how to make a new release that can sit alongside the old.

Specifically,

1. What should the new release be called? AULib.zip again?
2. What other files are needed (corresponding to the old AULib.txt) and what's in them?
3. If the old and new zip have the same names, should I put them into different directories (e.g., v2/ and v3/ ?)
4. If #3 is yes, how do I communicate to the V2 Library Manager that my V2 zip file has moved?
5. How do I alert the new Contributions Manager that a V3 version of my library is available, and where it's located?

prisonerjohn

Hi Andrew,

Indeed, you can make two versions of your library available, for Processing 2 and 3.

You can call the new release anything you want, but it's probably a good idea to keep the same name. You need to make two separate packages, hosted at two different URLs. Your idea of using two different directories would work, so in your case you could have:

• http://www.imaginary-institute.com/resources/AULibrary/v2/AULib.txt
• http://www.imaginary-institute.com/resources/AULibrary/v2/AULib.zip

and

• http://www.imaginary-institute.com/resources/AULibrary/v3/AULib.txt
• http://www.imaginary-institute.com/resources/AULibrary/v3/AULib.zip

The most important step is to correctly set the "minRevision" and "maxRevision" fields in your properties files.

If v2 supports Processing up to 2.2.1, you should use:

• minRevision = 0
• maxRevision = 227

If v3 supports Processing 3.0b1 and up, you should use:

• minRevision = 239
• maxRevision = 0

Notify me if any URLs change or get added, and I'll get them in the contributions list as soon as possible.

Hope this helps, let me know if you have any other questions!

GoToLoop

If v2 supports Processing up to 2.2.1, you should use:

Processing versions up to 3.0a5 still extends Java's Applet class.
Therefore maxRevision should be 232 instead of 227. :-B

quark

Personally I would stick with 227 since the alpha release a5 will not be a publically available download.