11.7.  Update PDFUnit-Java

PDFUnit-XML needs PDFUnit-Java to be installed before it can run. The version of PDFUnit-XML must be compatible with your version of PDFUnit-Java.

If the version numbers of PDFUnit-XML and PDFUnit-Java are the same, the versions will always match. If they not equal, you can find more information about compatibility here: http://www.pdfunit.com/en/download/index.html.

Getting the New Release

If you use PDFUnit with a license, you will receive a new release and a license file by mail.

Otherwise, download the new ZIP file from: http://www.pdfunit.com/en/download/index.html.

First Steps for all Development Environments

Before you start installing the new release, run all existing unit tests with the old release. They should be green. Save your project.

Install the Update

Unzip the new release into a new folder which is refered to in the following text as PDFUNITJAVA_NEW. The project folder with the old release is refered to as PROJECT_HOME.

Delete the folder PROJECT_HOME/lib/pdfunit-OLD-VERSION.

Copy the folder PDFUNITJAVA_NEW to PROJECT_HOME/lib/pdfunit-NEW-VERSION.

If you used the file config.properties with individual settings, transfer the changes to the config.properties of the new release.

If you use PDFUnit with a license, copy the new license file license-key_pdfunit-java.lic to the folder containing the old release's *.lic file. Remove the old license file.

Make sure that the new version of PDFUnit-Java is compatible with the existing version of PDFUnit-XML. You may also install a new version of PDFUnit-XML as described in the previous chapter.

Last Step

Run your existing tests with the new release. If there are no documented incompatibilities between the old and new releases, your tests should be run. Otherwise read the release information.