Android, PDF Erstellung mit iText
21Die Bibliothek iText gibt es in verschiedenen Versionen und für verschiedene Programmiersprachen (zbsp. C#, Java).
Für dieses Beispiel wird die Version itextpdf-5.3.3.jar benötigt.
Inhaltsverzeichnis
Einbinden der iText Bibliothek
Da ich meine Android Projekte mit Gradle und dem Android Studio 1.5 (stand 17.12.2015) erstelle hier nun die Einbindung in das Gradle Build Script.
Anlegen eines „libs“ Verzeichnisses
Im Hauptverzeichnis „app“ wird der Ordner „libs“ angelegt.
In dieses Verzeichnis wird nun die Datei „itextpdf-5.3.3.jar“ abgelegt.
Einbinden des „libs“ Verzeichnisses im Gradle Build Script
Damit das Verzeichnis beim Build Prozess eingebunden wird, muss dieses im wie folgt im Build Scriipt deklariert werden.
1 2 3 | dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) } |
Warte Dialog für lange Operationen
Da das generieren eines PDF Dokuments etwas Rechenzeit benötigt ist es sinnvoll dieses in einem Thread oder einem AsynTask auszulagern.
Wie man dieses macht habe ich im Tutorial ProgressDialog für lange Operationen beschrieben.
Erstellen eines einfachen PDF Dokumentes
Benötigte rechte zum schreiben
Zum schreiben der PDF Dokument wird das recht zum schreiben auf dem externen Speicher benötigt. Der externe Speicher ist hier nicht die evtl. vorhandene SD Karte sondern auch der interne Speicher des Mobilenendgerätes.
1 | <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> |
Erstellen des Dokumentes
Als erstes muss das Dokument erstellt und geöffnet werden.
In diesem Beispiel erstelle ich ein PDF Dokument im A4 Format.
1 2 3 4 5 | String root = getExternalDirectory(); String fileName = root + "/auswertung_" + getTimestampSuffix() + ".pdf"; this.document = new Document(PageSize.A4); PdfWriter.getInstance(document, new FileOutputStream(fileName)); this.document.open(); |
Erzeugen von MetaInformationen
Einem PDF Dokument können verschiedene MetaInformationen hinterlegt werden welche dem späteren Betrachter als Informationenzum Dokument dienen können.
Folgende MetaInformationen können hinterlegt werden:
- Titel,
- Betreff,
- Schlüsselwörter,
- Author,
- Ersteller
1 2 3 4 5 6 7 | private void addMetaData() { this.document.addTitle("Cardiologger by Stefan Draeger Software"); this.document.addSubject("Auswertung vom 18.12.2015"); this.document.addKeywords(""); this.document.addAuthor("Stefan Draeger Software"); this.document.addCreator("Stefan Draeger Software"); } |
Einbinden von Grafiken
Grafiken werden im Android Projekt als Resource hinterlegt und sind in der Regel über „R.drawable.<<Name der Datei>>“ erreichbar.
Konvertieren von Drawable Objekten
Dieses Drawable Objekt muss zuvor in ein Bitmap Objekt konvertiert werden, von diesem Bitmap ist es nun einfach die Bytes als Array zurückzuliefern.
1 2 3 4 5 6 7 | private byte[] getBytesFromDrawable(int id) { Drawable d = this.ctx.getResources().getDrawable(id); Bitmap bitmap = ((BitmapDrawable) d).getBitmap(); ByteArrayOutputStream stream = new ByteArrayOutputStream(); bitmap.compress(Bitmap.CompressFormat.JPEG, 100, stream); return stream.toByteArray(); } |
Einbinden einer Grafik in ein Dokument
Ein Grafik Objekt in iText ist das Image, dieses kann nicht direkt mit „new“ erzeugt werden, sondern muss mit „Image.getInstance“ erzeugt werden.
1 2 | Image logoImg = Image.getInstance(getBytesFromDrawable(R.drawable.logo)); this.document.add(logoImg); |
Schließen des Dokumentes
Wenn alle arbeiten an dem PDF Dokument abgeschlossen sind. (Quasi der gesamte Inhalt ist geschrieben.) Muss das Dokument geschlossen werden und kann durch die im Android Betriebssystem enthaltene „Share“ Funktion geteilt werden.
1 | this.document.close(); |
Teilen des Dokumentes
Um das nun erstellte Dokument zu Teilen gibt es eine Activity „Intent.ACTION_SEND“ mit dieser Activity kann man eine Datei verteilen zbsp. E-Mail, Bluethoot, Whatsapp, Facebook usw.
Es ist jedoch auf den MimeTyp zu achten damit die Datei im richtigen Format verteilt wird. Dieses ist besonders beim verteilen über E-Mail wichtig.
1 2 3 4 5 6 | Intent intent = new Intent(); intent.setAction(Intent.ACTION_SEND); intent.setType("text/plain"); intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); intent.putExtra(Intent.EXTRA_STREAM, Uri.fromFile(file)); ctx.startActivity(intent); |