Play Feature Delivery

Beim App-Auslieferungsmodell von Google Play werden mit Android App Bundles optimierte APKs für die Gerätekonfiguration jedes Nutzers generiert und bereitgestellt. So laden Nutzer nur den Code und die Ressourcen herunter, die sie zum Ausführen Ihrer App benötigen.

Bei Play Feature Delivery werden erweiterte Funktionen von App-Bundles verwendet, sodass bestimmte Funktionen Ihrer App bedingt bereitgestellt oder bei Bedarf heruntergeladen werden können. Dazu müssen Sie diese Funktionen zuerst von Ihrer Basis-App in Funktionsmodule trennen.

Buildkonfiguration für Funktionsmodule

Wenn Sie mit Android Studio ein neues Funktionsmodul erstellen, wendet die IDE das folgende Gradle-Plug-in auf die build.gradle-Datei des Moduls an.

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

Viele der Eigenschaften, die für das Standard-Anwendungs-Plug-in verfügbar sind, sind auch für Ihr Funktionsmodul verfügbar. In den folgenden Abschnitten werden die Eigenschaften beschrieben, die Sie in die Build-Konfiguration Ihres Feature-Moduls aufnehmen sollten und welche nicht.

Was die Build-Konfiguration des Feature-Moduls nicht enthalten sollte

Da jedes Feature-Modul vom Basismodul abhängt, werden auch bestimmte Konfigurationen übernommen. Daher sollten Sie Folgendes in der build.gradle-Datei des Feature-Moduls weglassen:

• Signaturkonfigurationen:App-Bundles werden mit Signaturkonfigurationen signiert, die Sie im Basismodul angeben.
• Eigenschaft minifyEnabled:Sie können das Minimieren von Code für Ihr gesamtes App-Projekt nur über die Build-Konfiguration des Basismoduls aktivieren. Daher sollten Sie dieses Attribut aus den Modul-Features entfernen. Sie können jedoch für jedes Feature-Modul zusätzliche ProGuard-Regeln angeben.
• versionCode und versionName: Beim Erstellen Ihres App-Bundles verwendet Gradle Informationen zur App-Version, die vom Basismodul bereitgestellt werden. Sie sollten diese Properties aus der build.gradle-Datei Ihres Feature-Moduls ausschließen.

Beziehung zum Basismodul herstellen

Wenn Android Studio Ihr Feature-Modul erstellt, wird es für das Basismodul sichtbar gemacht, indem der Datei build.gradle des Basismoduls die Property android.dynamicFeatures hinzugefügt wird (siehe unten):

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

Außerdem enthält Android Studio das Basismodul als Abhängigkeit des Feature-Moduls, wie unten dargestellt:

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

Zusätzliche ProGuard-Regeln angeben

Auch wenn nur die Build-Konfiguration des Basismoduls das Schrumpfen von Code für Ihr App-Projekt aktivieren kann, können Sie mithilfe des Attributs proguardFiles benutzerdefinierte ProGuard-Regeln für jedes Funktionsmodul angeben, wie unten dargestellt.

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

Beachten Sie, dass diese ProGuard-Regeln zum Zeitpunkt der Build-Phase mit denen anderer Module (einschließlich des Basismoduls) zusammengeführt werden. Jedes Funktionsmodul kann also eine neue Reihe von Regeln angeben, die für alle Module im App-Projekt gelten.

Anwendung bereitstellen

Während Sie Ihre App mit Unterstützung für Funktionsmodule entwickeln, können Sie sie wie gewohnt auf einem verbundenen Gerät bereitstellen. Wählen Sie dazu in der Menüleiste Ausführen > Ausführen aus oder klicken Sie in der Symbolleiste auf Ausführen .

Wenn Ihr App-Projekt ein oder mehrere Funktionsmodule enthält, können Sie auswählen, welche Funktionen beim Bereitstellen Ihrer App berücksichtigt werden sollen. Ändern Sie dazu die vorhandene Konfiguration für Ausführung/Fehlerbehebung folgendermaßen:

1. Wählen Sie in der Menüleiste Ausführen > Konfigurationen bearbeiten aus.
2. Wählen Sie im linken Bereich des Dialogfelds Run/Debug Configurations die gewünschte Android-App-Konfiguration aus.
3. Setzen Sie auf dem Tab Allgemein unter Zu implementierende dynamische Funktionen ein Häkchen neben jedem Funktionsmodul, das Sie beim Bereitstellen Ihrer App einschließen möchten.
4. Klicken Sie auf OK.

Standardmäßig wird Ihre App in Android Studio nicht mithilfe von App-Bundles bereitgestellt. Stattdessen werden in der IDE APKs erstellt und auf Ihrem Gerät installiert, die nicht nach der APK-Größe, sondern nach der Bereitstellungsgeschwindigkeit optimiert sind. Wenn Sie Android Studio so konfigurieren möchten, dass stattdessen APKs und Instant-Apps aus einem App-Bundle erstellt und bereitgestellt werden, ändern Sie die Ausführungs-/Fehlerbehebungskonfiguration.

Funktionsmodule für eine angepasste Bereitstellung verwenden

Ein einzigartiger Vorteil von Funktionsmodulen ist die Möglichkeit, anzupassen, wie und wann verschiedene Funktionen Ihrer App auf Geräte mit Android 5.0 (API-Level 21) oder höher heruntergeladen werden. Du kannst die anfängliche Downloadgröße deiner App verringern, indem du bestimmte Funktionen so konfigurierst, dass diese erst bei Bedarf oder nur von Geräten heruntergeladen werden, die bestimmte Funktionen unterstützen, z. B. die Möglichkeit, Fotos aufzunehmen oder Augmented-Reality-Funktionen zu nutzen.

Wenn Sie Ihre App als App-Bundle hochladen, erhalten Sie zwar standardmäßig optimierte Downloads. Die erweiterten und anpassbaren Bereitstellungsoptionen für Funktionen erfordern jedoch eine zusätzliche Konfiguration und Modularisierung der Funktionen Ihrer App mithilfe von Funktionsmodulen. Mithilfe von Feature-Modulen können Sie modulare Funktionen erstellen, die Sie so konfigurieren können, dass sie bei Bedarf heruntergeladen werden.

Angenommen, Sie haben eine App, mit der Nutzer Waren auf einem Onlinemarktplatz kaufen und verkaufen können. Sie können jede der folgenden Funktionen der App in separate Funktionsmodule modularisieren:

• Anmeldung und Erstellung von Konten
• Marketplace durchsuchen
• Artikel zum Verkauf anbieten
• Zahlungen werden verarbeitet

In der folgenden Tabelle werden die verschiedenen Bereitstellungsoptionen beschrieben, die von Feature-Modulen unterstützt werden, und wie sie verwendet werden können, um die Größe des ersten Downloads der Beispielmarktplatz-App zu optimieren.

URI für eine Ressource erstellen

Wenn Sie über einen URI auf eine in einem Feature-Modul gespeicherte Ressource zugreifen möchten, können Sie mit Uri.Builder() einen URI für die Feature-Modulressource generieren. Gehen Sie dazu so vor:

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

Jeder Teil des Pfads zur Ressource wird zur Laufzeit erstellt, damit der richtige Namespace generiert wird, nachdem die gesplitteten APKs geladen wurden.

Angenommen, Sie haben eine App und Feature-Module mit den folgenden Namen:

• Name des App-Pakets: com.example.my_app_package
• Name des Ressourcenpakets des Elements: com.example.my_app_package.my_dynamic_feature

Wenn sich resId im Code-Snippet oben auf eine Rohdateiressource mit dem Namen „my_video“ in deinem Feature-Modul bezieht, würde der Code Uri.Builder() oben Folgendes ausgeben:

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

Dieser URI kann dann von Ihrer App verwendet werden, um auf die Ressource des Funktionsmoduls zuzugreifen.

Um die Pfade in Ihrem URI zu validieren, können Sie mit dem APK-Analysetool das APK Ihres Funktionsmoduls prüfen und den Paketnamen ermitteln:

Hinweise zu Funktionsmodulen

Mit Funktionsmodulen können Sie die Build-Geschwindigkeit und die Entwicklungsgeschwindigkeit verbessern und die Bereitstellung der Funktionen Ihrer App umfassend anpassen, um die Größe Ihrer App zu verringern. Bei der Verwendung von Funktionsmodulen sind jedoch einige Einschränkungen und Grenzfälle zu beachten:

• Wenn Sie 50 oder mehr Funktionsmodule über die bedingte oder On-Demand-Auslieferung auf einem einzelnen Gerät installieren, kann dies zu Leistungsproblemen führen. Module, die zur Installationszeit hinzugefügt werden und nicht als entfernbar konfiguriert sind, werden automatisch in das Basismodul aufgenommen und zählen auf jedem Gerät nur als ein Funktionsmodul.
• Begrenzen Sie die Anzahl der Module, die Sie für die Bereitstellung zur Installationszeit als entfernbar konfigurieren, auf maximal 10. Andernfalls kann es länger dauern, die App herunterzuladen und zu installieren.
• Das On-Demand-Herunterladen und Installieren von Funktionen wird nur auf Geräten mit Android 5.0 (API-Level 21) und höher unterstützt. Wenn Sie Ihre Funktion für ältere Android-Versionen verfügbar machen möchten, aktivieren Sie beim Erstellen eines Funktionsmoduls die Fusing.
• Aktivieren Sie SplitCompat, damit Ihre App auf heruntergeladene Funktionsmodule zugreifen kann, die auf Anfrage bereitgestellt werden.
• In Funktionsmodulen dürfen keine Aktivitäten im Manifest angegeben werden, für die android:exported auf true festgelegt ist. Das liegt daran, dass nicht garantiert werden kann, dass das Gerät das Funktionsmodul heruntergeladen hat, wenn eine andere App versucht, die Aktivität zu starten. Außerdem sollte Ihre App prüfen, ob eine Funktion heruntergeladen wurde, bevor versucht wird, auf den Code und die Ressourcen zuzugreifen. Weitere Informationen finden Sie unter Installierte Module verwalten.
• Da Sie Ihre App für Play Feature Delivery mit einem App-Bundle veröffentlichen müssen, sollten Sie sich mit den bekannten Problemen mit App-Bundles vertraut machen.

Manifestreferenz für Funktionsmodule

Wenn Sie mit Android Studio ein neues Funktionsmodul erstellen, enthält die IDE die meisten Manifestattribute, die das Modul benötigt, um sich wie ein Funktionsmodul zu verhalten. Außerdem werden einige Attribute vom Build-System zur Kompilierungszeit eingefügt, sodass Sie sie nicht selbst angeben oder ändern müssen. In der folgenden Tabelle werden die Manifest-Attribute beschrieben, die für Feature-Module wichtig sind.

Weitere Informationen

Weitere Informationen zur Verwendung von Funktionsmodulen finden Sie in den folgenden Ressourcen.

Blogposts

• Neue Funktionen für die Entwicklung und Veröffentlichung von Apps sowie für den Ausbau Ihres Geschäfts bei Google Play
• Die neuesten Android App Bundle-Updates, einschließlich der Additional Languages API
• Patchwork Plaid – die Geschichte einer Modularisierung

Videos

• Anpassbare Bereitstellung mit App-Bundle und einfache Freigabe von Test-Builds
• Neue Tools zur Optimierung der Größe Ihrer App und zur Steigerung der Installationen bei Google Play

Nutzungsbedingungen und Datensicherheit

Wenn Sie auf die Play Feature Delivery Library zugreifen oder sie verwenden, stimmen Sie den Nutzungsbedingungen für das Play Core Software Development Kit zu. Bitte lesen Sie sich alle anwendbaren Nutzungsbedingungen und Richtlinien durch, bevor Sie auf die Bibliothek zugreifen.

Datensicherheit

Die Play Core-Bibliotheken sind die Laufzeitschnittstelle Ihrer App mit dem Google Play Store. Wenn Sie Play Core in Ihrer App verwenden, führt der Play Store eigene Prozesse aus, einschließlich der Verarbeitung von Daten gemäß den Google Play-Nutzungsbedingungen. Unten wird beschrieben, wie die Play Core-Bibliotheken mit Daten umgehen, um bestimmte Anfragen von Ihrer App zu verarbeiten.

API für zusätzliche Sprachen

Play Feature Delivery

Wir möchten so transparent wie möglich sein. Sie als App-Entwickler entscheiden jedoch selbstverantwortlich, wie Sie das Formular für den Abschnitt zur Datensicherheit in Google Play im Hinblick auf die Erhebung, Weitergabe und den Schutz von Daten ausfüllen.