Basismodul konfigurieren

Ein App-Bundle unterscheidet sich von einem APK dadurch, dass es nicht auf einem Gerät bereitgestellt werden kann. Es ist vielmehr ein Veröffentlichungsformat, das den gesamten kompilierten Code und die Ressourcen Ihrer App in einem einzigen Build-Artefakt enthält. Nachdem Sie Ihr signiertes App-Bundle hochgeladen haben, werden die APKs Ihrer App bei Google Play erstellt und signiert und an die Nutzer ausgeliefert.

Jetzt starten

Bei den meisten App-Projekten ist der Aufwand für die Unterstützung von Android App Bundles gering. Das liegt daran, dass das Modul, das Code und Ressourcen für das Basis-APK Ihrer App enthält, das Standard-App-Modul ist, das Sie standardmäßig erhalten, wenn Sie in Android Studio ein neues App-Projekt erstellen. Das Modul, das das application-Plug-in wie im folgenden Snippet gezeigt auf seine build.gradle-Datei anwendet, stellt den Code und die Ressourcen für die grundlegende Funktionalität Ihrer App bereit.

Groovy

// The standard application plugin creates your app's base module.
plugins {
 id 'com.android.application'
}

Kotlin

plugins {
    // The standard application plugin creates your app's base module.
    id("com.android.application")
}

Das Basismodul bietet nicht nur die Hauptfunktionen für Ihre App, sondern auch viele der Build-Konfigurationen und Manifesteinträge, die sich auf Ihr gesamtes App-Projekt auswirken.

Die Build-Konfiguration des Basismoduls

Bei den meisten vorhandenen App-Projekten müssen Sie nichts an der Build-Konfiguration des Basismoduls ändern. Wenn Sie jedoch Funktionsmodule zu Ihrem App-Projekt hinzufügen möchten oder Ihre App zuvor mit mehreren APKs veröffentlicht haben, sollten Sie einige Aspekte der Build-Konfiguration des Basismoduls beachten.

Versionscode und App-Updates

Mit Android App Bundles musst du keine Versionscodes mehr für mehrere APKs verwalten, die du bei Google Play hochlädst. Stattdessen verwalten Sie nur einen Versionscode im Basismodul Ihrer App, wie unten gezeigt:

// In your base module build.gradle file
android {
    defaultConfig {
        …
        // You specify your app's version code only in the base module.
        versionCode 5
        versionName "1.0"
    }
}

Nachdem Sie Ihr App-Bundle hochgeladen haben, verwendet Google Play den Versionscode in Ihrem Basismodul, um allen APKs, die aus diesem Bundle generiert werden, denselben Versionscode zuzuweisen. Das bedeutet, dass alle unterteilten APKs für diese App denselben Versionscode haben, wenn ein Gerät deine App herunterlädt und installiert.

Wenn du deine App mit neuem Code oder neuen Ressourcen aktualisieren möchtest, musst du den Versionscode im Basismodul deiner App aktualisieren und ein neues, vollständiges App-Bundle erstellen. Wenn Sie dieses App-Bundle bei Google Play hochladen, wird ein neuer Satz von APKs basierend auf dem Versionscode generiert, der im Basismodul angegeben ist. Wenn Nutzer anschließend deine App aktualisieren, stellt Google Play ihnen aktualisierte Versionen aller derzeit auf dem Gerät installierten APKs zur Verfügung. Das bedeutet, dass alle installierten APKs auf den neuen Versionscode aktualisiert werden.

Außerdem zu beachten

  • App-Signatur: Wenn Sie Signaturinformationen in Ihre Build-Dateien aufnehmen, sollten Sie diese nur in die Build-Konfigurationsdatei des Basismoduls einfügen. Weitere Informationen finden Sie unter Gradle zum Signieren Ihrer App konfigurieren.
  • Codekomprimierung: Wenn Sie die Codekomprimierung für Ihr gesamtes App-Projekt (einschließlich der Funktionsmodule) aktivieren möchten, müssen Sie dies in der Datei build.gradle des Basismoduls tun. Das bedeutet, dass Sie benutzerdefinierte ProGuard-Regeln in ein Funktionsmodul aufnehmen können, aber das Attribut minifyEnabled in den Build-Konfigurationen des Funktionsmoduls wird ignoriert.
  • Der Block splits wird ignoriert: Beim Erstellen eines App-Bundles ignoriert Gradle Attribute im Block android.splits. Wenn Sie festlegen möchten, welche Arten von Konfigurations-APKs Ihr App-Bundle unterstützt, verwenden Sie stattdessen android.bundle, um bestimmte Arten von Konfigurations-APKs zu deaktivieren.
  • App-Versionierung: Das Basismodul bestimmt den Versionscode und den Versionsnamen für das gesamte App-Projekt. Weitere Informationen finden Sie unter Versionscode und App-Updates.

Konfigurations-APK-Typen wieder aktivieren oder deaktivieren

Wenn Sie ein App-Bundle erstellen, wird standardmäßig die Generierung von Konfigurations-APKs für jede Gruppe von Sprachressourcen, Ressourcen für die Bildschirmdichte und ABI-Bibliotheken unterstützt. Mit dem Block android.bundle in der Datei build.gradle des Basismoduls kannst du die Unterstützung für einen oder mehrere Typen von Konfigurations-APKs deaktivieren:

Groovy

android {
    // When building Android App Bundles, the splits block is ignored.
    // You can remove it, unless you're going to continue to build multiple
    // APKs in parallel with the app bundle
    splits {...}

    // Instead, use the bundle block to control which types of configuration APKs
    // you want your app bundle to support.
    bundle {
        language {
            // This property is set to true by default.
            // You can specify `false` to turn off
            // generating configuration APKs for language resources.
            // These resources are instead packaged with each base and
            // feature APK.
            // Continue reading below to learn about situations when an app
            // might change setting to `false`, otherwise consider leaving
            // the default on for more optimized downloads.
            enableSplit = false
        }
        density {
            // This property is set to true by default.
            enableSplit = true
        }
        abi {
            // This property is set to true by default.
            enableSplit = true
        }
    }
}

Kotlin

android {
    // When building Android App Bundles, the splits block is ignored.
    // You can remove it, unless you're going to continue to build multiple
    // APKs in parallel with the app bundle
    splits {...}

    // Instead, use the bundle block to control which types of configuration APKs
    // you want your app bundle to support.
    bundle {
        language {
            // This property is set to true by default.
            // You can specify `false` to turn off
            // generating configuration APKs for language resources.
            // These resources are instead packaged with each base and
            // feature APK.
            // Continue reading below to learn about situations when an app
            // might change setting to `false`, otherwise consider leaving
            // the default on for more optimized downloads.
            enableSplit = false
        }
        density {
            // This property is set to true by default.
            enableSplit = true
        }
        abi {
            // This property is set to true by default.
            enableSplit = true
        }
    }
}

Umgang mit Sprachänderungen

Google Play bestimmt anhand der Sprachauswahl in den Geräteeinstellungen des Nutzers, welche Sprachressourcen mit der App installiert werden sollen. Angenommen, ein Nutzer ändert seine Standardsystemsprache, nachdem er deine App bereits heruntergeladen hat. Wenn deine App diese Sprache unterstützt, fordert das Gerät zusätzliche Konfigurations-APKs für diese Sprachressourcen von Google Play an und lädt sie herunter.

Bei Apps, die eine Sprachauswahl innerhalb der Anwendung bieten und die Sprache der App unabhängig von der Spracheinstellung auf Systemebene dynamisch ändern, müssen Sie einige Änderungen vornehmen, um Abstürze aufgrund fehlender Ressourcen zu vermeiden. Setzen Sie entweder das Attribut android.bundle.language.enableSplit auf false oder implementieren Sie On-Demand-Sprachdownloads mithilfe der Play Core-Bibliothek, wie unter Zusätzliche Sprachressourcen herunterladen beschrieben.