11.3. Starten von PDFUnit-XML

Prinzip

Die Ausführung der Tests mit PDFUnit-XML wird über das ANT-Skript PDFUNITXML_HOME/build.xml gestartet. Das Skript benötigt ein installiertes ANT und Java. Alle für die Ausführung der PDFUnit-Tests notwendigen Konfigurationen sind in der Datei bereits vorgenommen.

Falls Sie die Datei build.xml ändern möchten, achten Sie darauf, dass der Classpath das Verzeichnis PDFUNITJAVA_HOME enthält, weil dort die benötigte Datei config.properties liegt. Sie wird zur Ausführungszeit von PDFUnit-Java im Classpath gesucht.

PDFUnit-XML von der Konsole starten

Öffnen Sie eine Shell, je nach Betriebssystem auch Command Prompt, DOS-Box, Eingabeaufforderung oder Kommandozeile genannt. Wechseln Sie in das Projektverzeichnis PROJECT_HOME und geben Sie dort den Befehl:

ant all

oder:

runPDFUnit.bat

ein. Die Skripte runPDFUnit.bat bzw. runPDFUnit.sh kapseln den ANT-Aufruf und bieten die Möglichkeit, Pfade zu Ihren Java- und ANT-Installationen zu setzen.

Vorausgesetzt, Java und ANT sind auf Ihrem Rechner installiert und im Pfad des Betriebssystem eingetragen, begleitet ein umfangreicher Report die Abarbeitung der Testfälle:

Buildfile: C:\pdfunit-xml_demo\build.xml

clean:
     [delete] Deleting directory C:\pdfunit-xml_demo\build_ant

00_resolveDTD:
     [echo] start resolving DTD entities ...
     [mkdir] Created dir: C:\pdfunit-xml_demo\build_ant\xml
     [xslt] Loading stylesheet C:\pdfunit-xml_demo\lib\pdfunit-xml-2015.10\xslt\...
     [xslt] Processing C:\pdfunit-xml_demo\src\test\xml\CompareTestDemo.xml 
      ...
     [echo] ... finished
     
     ...
     ...

01_verifyXML:
     [echo] start validating PDFUnit test files (xml) ...
     [copy] Copying 1 file to C:\pdfunit-xml_demo\build_ant\xsd
     [echo] ... finished

02_generateJavaSourcesFromXML:
     [echo] start transforming PDFUnit test files (xml) into Java code ...
     [mkdir] Created dir: C:\pdfunit-xml_demo\build_ant\java\org\pdfunit\xml
     [xslt] Loading stylesheet C:\pdfunit-xml_demo\lib\pdfunit-xml-2015.10\xslt\...
     [xslt] Processing C:\pdfunit-xml_demo\src\test\xml\CompareTestDemo.xml 
      ...
     [echo] ... finished
     
     ...
     ...

03_compileGeneratedSources:
     [echo] start compiling generated sources ...
     [mkdir] Created dir: C:\pdfunit-xml_demo\build_ant\classes
     [javac] Compiling 9 source files to C:\pdfunit-xml_demo\build_ant\classes
     [echo] ... finished

04_runUnittest:
     [echo] start running unit tests from compiled sources ...
     [mkdir] Created dir: C:\pdfunit-xml_demo\build_ant\junit\data
     [junit] Running org.pdfunit.xml.ContentTestDemo
     [junit] Tests run: 6, Failures: 0, Errors: 0, Time elapsed: 1.054 sec
      ...
     [echo] ... finished

-testreport:
     [echo] start creating HTML report from unit test result ...
     [mkdir] Created dir: C:\pdfunit-xml_demo\build_ant\junit\html
     [junitreport] Processing C:\pdfunit-xml_demo\build_ant\junit\html\...
     [junitreport] Loading stylesheet JAR:file:/C:/environment/share32/tools/...
     [junitreport] Transform time: 890ms
     [junitreport] Deleting: c:\Temp\null1904905169
     [echo] ... finished
     [echo] Please look for index.html in subfolder build_ant/junit/html

all:

BUILD SUCCESSFUL

Danach steht ein ausführlicher HTML-Report für alle Tests im Verzeichnis PROJECT_HOME/build_ant/junit/html/index.html zur Verfügung. Hier ein Blick auf den Report des mitgelieferten Demo-Projektes:

Übersichtsseite des Testreports

Sollten Sie vergessen haben, die Bibliotheken von PDFUnit-Java in das Verzeichnis PROJECT_HOME/lib/pdfunit-java_VERSION zu kopieren, erscheint folgende Fehlermeldung:

[javac]   ... error: cannot find symbol
[javac]     AssertThat.document(filename)
[javac]     ^
[javac]   symbol:   variable AssertThat

PDFUnit-XML in Entwicklungsumgebungen nutzen

Sie möchten PDFUnit-XML lieber aus Ihrer Entwicklungsumgebung aus starten, als von der Konsole? Das geht, sofern die Entwicklungsumgebung Skripte starten kann, denn der Weg ist, das vorhandene ANT-Skript PROJECT_HOME/build.xml aus der IDE heraus zu starten. Falls Sie Hilfe benötigen, schreiben Sie an support[at]pdfunit.com.