Konvertieren Sie AAB online in APK: Was dieses Tool tatsächlich macht
Das Android App Bundle (.aab) ist das Format, das Google Play von Entwicklern zum Hochladen auffordert. Es ist jedoch nicht etwas, das Sie auf einem Telefon installieren können. Wenn Sie eine .aab-Datei von einem Build-Server, einer CI-Pipeline oder einem Kollegen haben, müssen Sie diese zunächst in eine installierbare .apk-Datei umwandeln. Diese Seite bietet Ihnen für diesen Job zwei Dinge: einen interaktiven AAB-zu-APK-Befehlsersteller, der den genauen Bundletool-Befehl für Ihr Betriebssystem schreibt, und einen AAB-Datei-Explorer, der das Bundle in Ihrem Browser öffnet, damit Sie sehen können, was darin enthalten ist, bevor Sie es konvertieren.
Die Konvertierung selbst läuft über das offizielle Google-Programm bundletool, ein Java-Programm. Da bundletool die Java-Laufzeitumgebung und Zugriff auf Ihren Keystore benötigt, erfolgt der eigentliche Build-Schritt auf Ihrem eigenen Computer und nicht auf unseren Servern. Ihre .aab-Datei wird niemals irgendwohin hochgeladen. Der Builder beseitigt einfach das Rätselraten, sodass Sie einen korrekten, ausführungsbereiten Befehl kopieren können, anstatt sich Flag-Namen zu merken.
AAB vs. APK: Warum Sie die Datei nicht einfach umbenennen können
Viele Leute suchen nach einer Möglichkeit, AAB durch Umbenennen der Erweiterung in APK zu ändern, aber es funktioniert nie. Eine .apk ist ein einzelnes, eigenständiges Paket, das Android direkt installieren kann. Eine .aab-Datei ist ein Veröffentlichungscontainer: Sie enthält Ihren kompilierten Code und Ihre in Module aufgeteilten Ressourcen und erwartet, dass Google Play oder bundletool daraus die endgültigen, geräteoptimierten APKs generiert. Durch das Umbenennen der Datei werden diese Module weder entpackt noch signiert, sodass Android die Installation verweigert. Die einzige zuverlässige Möglichkeit, ein Android App Bundle zu APK zu konvertieren, besteht darin, Bundletool das APK-Set für Sie erstellen zu lassen.
So konvertieren Sie AAB in APK unter Windows, Mac und Linux
Die Schritte sind auf jeder Plattform gleich und nur der Dateipfadstil ändert sich, weshalb der obige Befehlsgenerator über einen Windows-, macOS- und Linux-Schalter verfügt. Hier ist der vollständige Ablauf von Anfang bis Ende:
- Installieren Sie Java JDK 8 oder neuer. Führen Sie java -version in einem Terminal aus, um zu bestätigen, dass sich Java in Ihrem PATH befindet.
- Bundletool herunterladen. Holen Sie sich das neueste bundletool-all.jar von Googles offizieller GitHub-Veröffentlichungsseite.
- Erstellen Sie das APK-Set. Zeigen Sie bundletool auf Ihr Bundle und lassen Sie es ein .apks-Archiv erstellen: java -jar bundletool-all.jar build-apks --bundle=app.aab --output=app.apks --mode=universal
- Öffnen Sie das APK-Archiv. Es handelt sich lediglich um eine ZIP-Datei. Extrahieren Sie sie. Dort finden Sie universal.apk.
- Auf Ihrem Gerät installieren. Kopieren Sie die APK auf Ihr Telefon und laden Sie sie von der Seite oder verwenden Sie bundletool install-apks mit einem über USB angeschlossenen Gerät.
Universelle APK vs. Split-APKs: Welche sollten Sie erstellen?
Wenn Sie möchten, dass eine Datei auf jedem Telefon installiert wird, verwenden Sie --mode=universal. Dadurch entsteht ein einziger universelle APK von Ihrem AAB, der alle CPU-Architektur, Bildschirmdichte und Sprache in einem Paket bündelt. Es ist größer, aber die einfachste Option zum Testen, Archivieren oder Teilen eines Builds außerhalb des Play Store. Wenn Sie den Modus auslassen, erzeugt Bundletool stattdessen geteilte APKs, die auf ein bestimmtes Gerät zugeschnitten sind, sodass sie kleiner heruntergeladen werden, Sie aber den passenden Satz zusammen installieren müssen. Für die meisten Leute, die nur eine .aab-Datei für eine schnelle Installation konvertieren müssen, ist die universelle APK die richtige Wahl.
Signieren der APK, die Sie von einem AAB erhalten
Android installiert ein APK nur, wenn es signiert ist. Zu Testzwecken kann bundletool automatisch mit einem Debug-Schlüssel signieren, was genau das ist, was die Option „Debug-Keystore verwenden“ im Builder bewirkt. Wenn Sie einen Release-Build vorbereiten, um ihn beispielsweise auf Ihrer eigenen Website zu verteilen, signieren Sie ihn mit Ihrem eigenen Keystore, indem Sie die Felder Keystore-Pfad, Keystore-Passwort, Schlüsselalias und Schlüsselpasswort ausfüllen. Der Builder fügt dann die Flags --ks, --ks-pass, --ks-key-alias und --key-pass hinzu, sodass das APK, das Sie erhalten, Ihre echte Produktionssignatur anstelle einer wegwerfbaren Debug-Signatur trägt.
Häufige Bundletool-Fehler und wie man sie behebt
Zwei Probleme tauchen immer wieder auf. Die Meldung „bundletool: Befehl nicht gefunden“ bedeutet, dass Sie versucht haben, bundletool so auszuführen, als wäre es ein integrierter Befehl. Da es sich um eine JAR-Datei handelt, rufen Sie sie immer mit java -jar bundletool-all.jar auf. Der Fehler „Kein Schlüssel/Zertifikat“ bedeutet, dass Signaturdetails fehlen: Fügen Sie entweder --mode=universal für einen nicht signierten Testbuild hinzu oder geben Sie Ihre Keystore-Flags wie oben beschrieben an. Die Registerkarte „Fehlerbehebung“ weiter oben auf der Seite deckt weitere davon ab, und mit dem AAB Explorer können Sie überprüfen, ob Ihr Bundle wirklich die Module enthält, die Sie erwarten, bevor Sie Zeit mit dem Debuggen eines Befehls verbringen.
Wann müsste ein AAB tatsächlich konvertiert werden?
Die üblichen Gründe sind das Testen eines Release-Builds auf einem echten Gerät vor der Veröffentlichung, die Übergabe eines Builds an einen Tester, der Google Play nicht verwendet, das Aufbewahren einer installierbaren Kopie Ihrer eigenen App für Ihre Unterlagen oder die Durchführung einer Qualitätssicherung auf Hardware, die von internen Tests im Play Store nicht erreicht wird. Was auch immer der Grund sein mag: Konvertieren Sie nur App-Bundles, zu deren Nutzung Sie berechtigt sind, z. B. Ihre eigenen Builds oder Bundles, mit denen Sie eindeutig arbeiten dürfen.