PDF-Erstellung unter iOS – Eine Tutorial

Grundlagen der PDF-Erstellung in iOS

Das PDF-Format (Portable Document Format) ist ein universelles Dateiformat, das plattformübergreifend verwendet wird, um Dokumente originalgetreu darzustellen. Unter iOS bietet das System verschiedene APIs, um PDFs zu erstellen, zu bearbeiten und darzustellen. Die PDF-Erstellung erfolgt meist im Kontext von Zeichnen auf einer Grafikoberfläche oder über speziell dafür angebotene Frameworks. Die zentrale Rolle spielt dabei die Quartz 2D Grafikbibliothek und das UIKit Framework.

Methoden zur PDF-Erstellung auf iOS

Apple stellt mehrere Möglichkeiten bereit, um PDFs zu generieren. Einige Entwickler nutzen Core Graphics direkt, um Seiten zu definieren und Inhalte per Zeichnen zu erzeugen. Andere verwenden die UIKit-Funktionalitäten, beispielsweise mit UIGraphicsPDFRenderer, die seit iOS 10 existiert und das Erstellen von PDFs wesentlich vereinfacht und besser an das UIKit angepasst ist.

Alternativ können auch externe Bibliotheken verwendet werden, um umfangreichere Funktionalitäten abzudecken, beispielsweise wenn dynamische PDFs mit komplexen Inhalten oder Formularen benötigt werden.

Erstellen eines einfachen PDFs mit UIGraphicsPDFRenderer

Die Klasse UIGraphicsPDFRenderer ist der bevorzugte Weg zur PDF-Erzeugung mit UIKit. Sie bietet eine einfache API, um grafische Inhalte auf PDF-Seiten zu zeichnen. Man definiert einen Renderer mit Seitengröße, erstellt dann ein PDF-Dokument und zeichnet die Inhalte innerhalb von Zeichenblöcken.

Ein Beispielcode zeigt, wie mit swift ein einfaches PDF mit Text generiert werden kann:

import UIKitlet pdfRenderer = UIGraphicsPDFRenderer(bounds: CGRect(x: 0, y: 0, width: 595, height: 842)) // A4-Größe in Punktenlet data = pdfRenderer.pdfData { context in context.beginPage() let text = "Hallo, dies ist ein Beispieltext für ein PDF-Dokument unter iOS." let attributes:   =   text.draw(at: CGPoint(x: 20, y: 20), withAttributes: attributes)}// Das resultierende PDF-Datenobjekt kann nun z.B. gespeichert oder geteilt werden

Dieses Beispiel erzeugt ein PDF mit einer A4-Seite und schreibt einfachen Text an eine bestimmte Position. Mehrere Seiten können durch mehrfache Aufrufe von context.beginPage() erstellt werden.

Speicherung und Weiterverwendung des PDFs

Die PDF-Daten, die im vorherigen Beispiel als Data zurückgegeben wurden, können in eine Datei geschrieben werden, um dauerhaft gespeichert zu werden. Typischerweise nutzt man dazu das iOS-Dateisystem, z.B. den Dokumente-Ordner der App, oder man übergibt die Daten an anderen Systemkomponenten zum Teilen oder Drucken.

Zum Speichern in eine Datei kann folgender Swift-Code verwendet werden:

let documentDirectories = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)if let documentDirectory = documentDirectories.first { let pdfURL = documentDirectory.appendingPathComponent("beispiel.pdf") do { try data.write(to: pdfURL) print("PDF-Datei erfolgreich gespeichert unter", pdfURL) } catch { print("Fehler beim Speichern der PDF Datei:", error) }}

Danach kann die Datei z.B. per UIDocumentInteractionController angezeigt oder über die iOS-Share-Sheet-Funktion geteilt werden.

Weiterführende Features und Tipps

Das Zeichnen auf Seiten kann beliebige Inhalte umfassen, nicht nur Text. Bilder, Formen, Linien und komplexe Layouts lassen sich mit der vollen Core Graphics API implementieren. Zudem ist es möglich, vorhandene PDF-Dokumente zu laden und zu bearbeiten.

Wenn dynamische und professionellere PDFs mit interaktiven Formularfeldern oder umfangreichen Layouts benötigt werden, lohnt es sich, weitere Frameworks wie PDFKit einzusetzen. PDFKit bietet umfassende Werkzeuge, um PDFs zu rendern, durchsuchen, kommentieren und bearbeiten.

Zusammenfassend bietet iOS mit UIKit und Core Graphics ein flexibles und leistungsfähiges System zur eigenen PDF-Erstellung, das für viele Anwendungsfälle vollkommen ausreichend ist.

Stand: Juni 2024