Drucken aus einer Android-App: Druckdokument, Systemdialog und Papier sind verschiedene Schritte

Wenn Beschäftigte einen Auftrag direkt aus Ihrer Android-App drucken sollen, beauftragen Sie mehr als einen Knopf mit Druckersymbol. Legen Sie fest, welches Dokument entsteht, wie es auf geänderte Druckeinstellungen reagiert und welche Rückmeldung die App tatsächlich geben darf. Eine erzeugte Datei ist noch kein Nachweis, dass das richtige Blatt beim richtigen Menschen angekommen ist.

Dieser Leitfaden behandelt individuell erzeugte Druckdokumente in einer nativen Android-App. Eine Browserseite mit Druckformatierung, das Speichern einer Datei über die Dateiauswahl und das Teilen eines PDFs sind andere Aufträge. Für eine einfache Bild- oder HTML-Ausgabe kann ein anderer Druckweg genügen; eine vollständig eigene Seitengestaltung sollte einen konkreten Bedarf haben.

Erst das Druckergebnis beschreiben

Die Android-Dokumentation zu eigenen Druckdokumenten beschreibt diesen Weg für Anwendungen, die genaue Kontrolle über Schriften, Textfluss, Seitenumbrüche, Kopf- und Fußzeilen oder grafische Elemente benötigen. Sie weist ausdrücklich auf den zusätzlichen Programmieraufwand hin: Die App muss mit dem Drucksystem zusammenarbeiten, Einstellungen berücksichtigen und mehrseitige Inhalte verwalten.

Für einen betrieblichen Auftrag heißt das: Schreiben Sie auf, welche Angaben die gedruckte Fassung enthalten soll. Beispielsweise könnte ein Monteur eine freigegebene Arbeitsbeschreibung benötigen, aber keine internen Kalkulationsnotizen. Diese Auswahl ist eine fachliche und berechtigungsbezogene Projektentscheidung. Ein weißes Rechteck über einer vertraulichen Angabe ist kein sinnvoller Ersatz dafür, sie gar nicht erst in das freigegebene Dokument aufzunehmen.

Klären Sie auch den Zeitpunkt der Datenübernahme. Soll der Druck eine bewusst gewählte Fassung des Auftrags festhalten, oder muss vor dem Start ein aktueller Stand geladen werden? Ein sichtbarer Bezug auf Auftragskennung und Dokumentfassung kann spätere Verwechslungen vermeiden. Das sind vorgeschlagene Anforderungen, keine von Android automatisch gelieferten Nachweise.

Der Nutzer wählt Einstellungen, die das Dokument verändern

Android beschreibt einen Ablauf, in dem Nutzer Drucker und Druckoptionen auswählen, bevor das endgültige Dokument erzeugt wird. Unterschiedliche Papiergrößen, Ausrichtungen und Druckerfähigkeiten können die Ausgabe beeinflussen. Der Druckadapter der App berechnet das Layout entsprechend neu.

Deshalb reicht eine einmal erzeugte Vorschau im ursprünglich gewählten Hochformat nicht als Abnahme. Lassen Sie mindestens die tatsächlich benötigten Papiergrößen und Ausrichtungen benennen. Prüfen Sie lange Positionstexte und einen Auftrag, der mehrere Seiten benötigt. Nach einem Einstellungswechsel müssen Seitenzahl und Inhalt wieder zusammenpassen.

Die technische Dokumentation nennt dafür den Layout-Schritt onLayout(). Er wird aufgerufen, wenn eine für die Ausgabe relevante Einstellung geändert wird, und muss unter anderem die erwartete Seitenzahl liefern. Sie müssen diese Schnittstelle nicht selbst programmieren. Sie sollten aber verlangen, dass die App eine neue Auswahl nicht nur im Dialog anzeigt, während sie weiterhin ein unpassendes altes Dokument ausgibt.

Angeforderte Seiten müssen zu den geschriebenen Seiten passen

Im Schreibschritt onWrite() erhält die App laut Android die angeforderten Seiten und das Ausgabeziel. Sie muss die angeforderten Inhalte als mehrseitiges PDF schreiben. Der Schreibschritt kann nach einem Layout-Aufruf mehrfach stattfinden.

Für Ihr Briefing bedeutet das: Besprechen Sie, ob Nutzer nur bestimmte Seiten ausgeben dürfen und wie Sie das Ergebnis prüfen. Eine Seitenauswahl darf nicht versehentlich immer den gesamten Auftrag ausgeben. Ebenso darf ein zweiter interner Schreibaufruf nicht als zweiter fachlicher Auftrag behandelt werden.

Ich empfehle, die Dokumenterzeugung von Änderungen am Geschäftsvorgang zu trennen. Das erneute Berechnen einer Vorschau sollte beispielsweise keine Ware erneut abbuchen und keine Kundennachricht versenden. Falls der Betrieb zusätzlich einen Status wie „Unterlagen vorbereitet“ benötigt, definieren Sie dafür eine eigene Bedeutung und einen bewussten Auslöser. Der Druckadapter ist nicht von sich aus eine Buchungs- oder Versandbestätigung.

Abbruch und Fehler sind normale Ergebnisse

Die Dokumentation verlangt, dass der Adapter auf Abbruchwünsche reagiert. Für Layout und Schreiben beschreibt sie jeweils Abschluss, Abbruch oder Fehler als mögliche Ergebnisse, die an das Drucksystem gemeldet werden müssen.

Vereinbaren Sie deshalb, was Beschäftigte sehen, wenn sie den Vorgang abbrechen oder die Datei nicht erzeugt werden kann. Eine pauschale Erfolgsmeldung nach dem Antippen des Drucksymbols wäre dafür ungeeignet. Ein erneuter Versuch sollte wieder vom richtigen Auftrag ausgehen und nicht unbemerkt einen anderen inzwischen geöffneten Datensatz verwenden.

Android beschreibt außerdem einen abschließenden Aufruf onFinish() für einmalige Aufräumarbeiten am Ende des Druckprozesses. Behandeln Sie diesen Lebenszyklusabschluss nicht als eigenständigen Beleg für physisch ausgegebenes und übergebenes Papier. Die Quelle beschreibt, dass das System nach der Druckbestätigung das fertige Dokument an einen Druckanbieter zur Ausgabe weitergibt; sie zertifiziert nicht Ihren betrieblichen Übergabeprozess.

Wenn ein tatsächlicher Papiernachweis erforderlich ist, muss dessen Verfahren gesondert festgelegt und mit der eingesetzten Druckumgebung geprüft werden. Ohne diesen Umfang sollte die App nur denjenigen Zustand benennen, den sie wirklich feststellen kann.

Eine PDF-Seite ist nicht automatisch bis zum Rand bedruckbar

Android warnt im Abschnitt zur Seitenerzeugung, dass zwar Elemente am Rand einer PDF-Seite platziert werden können, viele Drucker aber nicht bis zum Rand eines physischen Blatts drucken. Die Anwendung muss den nicht bedruckbaren Bereich berücksichtigen.

Verlangen Sie deshalb neben der Dateivorschau einen Papierausdruck mit den tatsächlich vorgesehenen Druckern und Einstellungen. Prüfen Sie insbesondere Referenznummern, Tabellenenden und Unterschriftsfelder in Randnähe. Eine vollständig sichtbare PDF-Vorschau beweist noch nicht, dass der Ausdruck dieselben Informationen unbeschnitten enthält.

Welche Geräte und Druckdienste unterstützt werden sollen, gehört in den vereinbarten Testumfang. Dieser Artikel behauptet weder eine universelle Druckerkompatibilität noch eine bereits erfolgte Prüfung Ihrer Geräte.

Was Sie abnehmen sollten

Ergänzen Sie die Akzeptanzkriterien für Ihre Anwendung um konkrete Druckabläufe:

• Die richtige freigegebene Dokumentfassung und Auftragskennung erscheinen in Vorschau und Ausgabe.
• Eine Änderung der benötigten Papiergröße oder Ausrichtung führt zu einem passenden Layout und einer stimmigen Seitenzahl.
• Die vereinbarte Seitenauswahl gibt nur die angeforderten Inhalte aus.
• Wiederholte Layout- und Schreibschritte lösen keine zusätzlichen Geschäftsvorgänge aus.
• Abbruch und Erzeugungsfehler werden nicht als erfolgreicher Papierdruck gemeldet.
• Ein langer Auftrag bleibt über mehrere Seiten verständlich; auf dem vorgesehenen Drucker gehen keine Pflichtangaben am Rand verloren.
• Vertrauliche, für diese Fassung ausgeschlossene Informationen befinden sich nicht im erzeugten Dokument.

Bringen Sie ein harmloses Musterdokument und Ihre tatsächliche Druckumgebung in die Planung Ihrer mobilen App mit. So lässt sich der Umfang anhand des Arbeitsablaufs festlegen, statt eine aufwendige Eigenentwicklung allein wegen eines Drucksymbols zu bestellen.

Quelle und Grenzen

Die am 26. Oktober 2026 gelesene Android-Seite belegt den beschriebenen Druckadapter-Ablauf, einstellungsabhängiges Layout, PDF-Seitenerzeugung, Wiederholungen, Abbruch und Fehler sowie die Warnung zu physischen Druckrändern. Sie enthält auch ältere Implementierungsbeispiele; dieser Artikel übernimmt daraus keine Empfehlung für ein bestimmtes Nebenläufigkeitswerkzeug. Datenfassung, Geschäftsstatus und Abnahmeszenarien sind Projektvorschläge. Es wurde keine Android-App ausgeführt und kein Drucker getestet.