Zurück |  | Weiter

## 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:

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.

Zurück | Nach oben | Weiter
11.2. Installation | Zum Anfang | 11.4. Einstellungen in der config.properties