Android App Bundles

Ein Android App Bundle ist ein Veröffentlichungsformat, das den gesamten kompilierten Code und die Ressourcen Ihrer App enthält. Die APK-Generierung und -Signierung wird dabei an Google Play übertragen.

Google Play verwendet Ihr App-Bundle, um optimierte APKs für jede Gerätekonfiguration zu generieren und bereitzustellen. So werden nur der Code und die Ressourcen heruntergeladen, die für ein bestimmtes Gerät erforderlich sind, um Ihre App auszuführen. Sie müssen nicht mehr mehrere APKs erstellen, signieren und verwalten, um die Unterstützung für verschiedene Geräte zu optimieren, und Nutzer erhalten kleinere, optimierte Downloads.

Bei den meisten App-Projekten ist nur ein minimaler Aufwand erforderlich, um App-Bundles zu erstellen, die die Bereitstellung optimierter APKs unterstützen. Die optimierte APK-Bereitstellung wird automatisch aktiviert, wenn du bereits die folgenden Best Practices befolgst:

Wenn du deine App im App-Bundle-Format veröffentlichst, kannst du optional auch Play Feature Delivery nutzen, um deinem App-Projekt Funktionsmodule hinzuzufügen. Diese Module enthalten Funktionen und Ressourcen, die nur unter von Ihnen festgelegten Bedingungen in Ihre App aufgenommen werden oder später zur Laufzeit über die Play Core-Bibliothek heruntergeladen werden können.

Spieleentwickler, die ihre Apps mit App-Bundles veröffentlichen, können Play Asset Delivery verwenden. Das ist die Lösung von Google Play für die Bereitstellung großer Mengen von Spiel-Assets, die Entwicklern flexible Bereitstellungsmethoden und hohe Leistung bietet.

Im folgenden Video erfahren Sie, warum Sie Ihre App mit Android App Bundles veröffentlichen sollten.

Beschränkung der komprimierten Downloadgröße

Wenn Sie Ihre App mit Android App Bundles veröffentlichen, können Nutzer sie mit möglichst kleinen Downloads installieren. Außerdem wird die Größe des komprimierten Downloads erhöht. Das bedeutet, dass die Gesamtgröße der komprimierten APKs, die für die Installation Ihrer App erforderlich sind (z. B. Basis-APK + Konfigurations-APKs), beim Herunterladen durch einen Nutzer nicht mehr als 4 GB betragen darf. Alle nachfolgenden Downloads, z. B. das Herunterladen eines Funktionsmoduls (und der zugehörigen Konfigurations-APKs) bei Bedarf, müssen ebenfalls dieser Einschränkung für die komprimierte Downloadgröße entsprechen. Asset-Packs werden nicht auf dieses Größenlimit angerechnet, unterliegen aber anderen Größenbeschränkungen.

Wenn die Play Console feststellt, dass einer der möglichen Downloads Ihrer App oder ihrer On-Demand-Funktionen die maximalen Größenbeschränkungen überschreitet, wird ein Fehler angezeigt.

Beachte, dass Android App Bundles keine APK-Erweiterungsdateien (*.obb) unterstützen. Wenn dieser Fehler beim Veröffentlichen Ihres App-Bundles auftritt, können Sie eine der folgenden Ressourcen verwenden, um die Downloadgröße komprimierter APKs zu reduzieren:

  • Achte darauf, dass du alle Konfigurations-APKs aktivierst, indem du für jeden Konfigurations-APK-Typ enableSplit = true festlegst. So wird sichergestellt, dass Nutzer nur den Code und die Ressourcen herunterladen, die sie zum Ausführen der App auf ihrem Gerät benötigen.
  • Verkleinern Sie Ihre App, indem Sie nicht verwendeten Code und nicht verwendete Ressourcen entfernen.
  • Folgen Sie den Best Practices, um die App-Größe weiter zu reduzieren.
  • Funktionen, die nur von einigen Nutzern verwendet werden, können in Funktionsmodule umgewandelt werden, die Ihre App später bei Bedarf herunterladen kann. Beachten Sie, dass dies möglicherweise eine Refaktorierung Ihrer App erfordert. Probieren Sie daher zuerst die anderen beschriebenen Vorschläge aus.

Außerdem zu beachten

Die folgenden Probleme sind bekannt, wenn Sie Ihre App mit Android App Bundles erstellen oder bereitstellen. Wenn Probleme auftreten, die hier nicht beschrieben sind, melden Sie den Fehler bitte hier.

  • Teilinstallationen von per Sideloading installierten Apps, d. h. Apps, die nicht über den Google Play Store installiert werden und bei denen ein oder mehrere erforderliche unterteilte APKs fehlen, schlagen auf allen von Google zertifizierten Geräten und Geräten mit Android 10 (API-Level 29) oder höher fehl. Wenn Sie Ihre App über den Google Play Store herunterladen, sorgt Google dafür, dass alle erforderlichen Komponenten der App installiert werden.
  • Wenn du Tools verwendest, die Ressourcentabellen dynamisch ändern, kann es bei APKs, die aus App-Bundles generiert wurden, zu unerwartetem Verhalten kommen. Daher wird empfohlen, solche Tools beim Erstellen eines App-Bundles zu deaktivieren.

  • Es ist möglich, in der Build-Konfiguration eines Funktionsmoduls Attribute zu konfigurieren, die mit denen der Basismodule (oder anderer Module) in Konflikt stehen. Sie können beispielsweise buildTypes.release.debuggable = true im Basismodul und false in einem Funktionsmodul festlegen. Solche Konflikte können zu Build- und Laufzeitproblemen führen. Beachten Sie, dass Funktionsmodule standardmäßig einige Build-Konfigurationen vom Basismodul übernehmen. Achten Sie also darauf, dass Sie wissen, welche Konfigurationen Sie in der Build-Konfiguration des Funktionsmoduls beibehalten und welche Sie weglassen sollten.

Zusätzliche Ressourcen

Weitere Informationen zu Android App Bundles finden Sie in den folgenden Ressourcen.

Blogposts

Videos