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.
Ö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:
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
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.