Play Feature Delivery

Das App-Bereitstellungsmodell von Google Play verwendet Android App Bundles, um optimierte APKs für die Gerätekonfiguration der einzelnen Nutzer zu generieren und bereitzustellen. So laden Nutzer nur den Code und die Ressourcen herunter, die sie zum Ausführen Ihrer App benötigen.

Play Feature Delivery nutzt erweiterte Funktionen von App Bundles, sodass bestimmte Funktionen Ihrer App unter bestimmten Bedingungen bereitgestellt oder on demand heruntergeladen werden können. Dazu müssen Sie diese Funktionen zuerst von Ihrer Basis-App trennen und in Funktionsmodule aufteilen.

Build-Konfiguration für Funktionsmodule

Wenn Sie mit Android Studio ein neues Funktionsmodul erstellen, wendet die IDE das folgende Gradle-Plug-in auf die Datei build.gradle 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 für das Standard-Anwendungs-Plug-in verfügbaren Properties sind auch für Ihr Funktionsmodul verfügbar. In den folgenden Abschnitten werden die Attribute beschrieben, die Sie in die Build-Konfiguration Ihres Funktionsmoduls aufnehmen sollten und welche nicht.

Was nicht in die Build-Konfiguration des Funktionsmoduls aufgenommen werden sollte

Da jedes Funktionsmodul vom Basismodul abhängt, übernimmt es auch bestimmte Konfigurationen. Daher sollten Sie Folgendes in der build.gradle-Datei des Funktionsmoduls weglassen:

• Signaturkonfigurationen:App-Bundles werden mit Signaturkonfigurationen signiert, die Sie im Basismodul angeben.
• Das Attribut minifyEnabled: Du kannst die Codekomprimierung für dein gesamtes App-Projekt nur über die Build-Konfiguration des Basismoduls aktivieren. Sie sollten dieses Attribut daher in Funktionsmodulen weglassen. Sie können jedoch für jedes Funktionsmodul zusätzliche ProGuard-Regeln angeben.
• versionCode und versionName: Beim Erstellen des App-Bundles verwendet Gradle die vom Basismodul bereitgestellten Informationen zur App-Version. Diese Properties sollten Sie in der Datei build.gradle Ihres Funktionsmoduls weglassen.

Beziehung zum Basismodul herstellen

Wenn Android Studio Ihr Funktionsmodul erstellt, wird es für das Basismodul sichtbar gemacht. Dazu wird das Attribut android.dynamicFeatures in die Datei build.gradle des Basismoduls eingefügt, wie unten gezeigt:

// 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 Funktionsmoduls, 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

Obwohl die Codekomprimierung für Ihr App-Projekt nur in der Build-Konfiguration des Basismoduls aktiviert werden kann, können Sie für jedes Funktionsmodul benutzerdefinierte ProGuard-Regeln mit der Property proguardFiles angeben, wie unten gezeigt.

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 beim Erstellen mit denen aus anderen Modulen (einschließlich des Basismoduls) zusammengeführt werden. Auch wenn jedes Funktionsmodul einen neuen Satz von Regeln angibt, gelten diese Regeln für alle Module im App-Projekt.

Anwendung bereitstellen

Wenn 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 bei der Bereitstellung Ihrer App enthalten sein sollen. Ändern Sie dazu Ihre vorhandene Konfiguration ausführen/debuggen so:

1. Wählen Sie in der Menüleiste Ausführen > Konfigurationen bearbeiten aus.
2. Wählen Sie im linken Bereich des Dialogfelds Konfigurationen ausführen/debuggen die gewünschte Android-App-Konfiguration aus.
3. Klicken Sie auf dem Tab Allgemein unter Bereitzustellende dynamische Funktionen das Kästchen neben jedem Funktionsmodul an, das Sie bei der Bereitstellung Ihrer App einbeziehen möchten.
4. Klicken Sie auf OK.

Standardmäßig stellt Android Studio Ihre App nicht mithilfe von App-Bundles bereit. Stattdessen werden in der IDE APKs erstellt und auf Ihrem Gerät installiert, die für die Bereitstellungsgeschwindigkeit und nicht für die APK-Größe optimiert sind. Wenn Sie Android Studio so konfigurieren möchten, dass stattdessen APKs und Instant-Versionen aus einem App-Bundle erstellt und bereitgestellt werden, ändern Sie die Konfiguration ausführen/debuggen.

Funktionsmodule für die benutzerdefinierte 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. Beispielsweise können Sie die anfängliche Downloadgröße Ihrer App reduzieren, indem Sie bestimmte Funktionen so konfigurieren, dass sie entweder bei Bedarf heruntergeladen werden oder nur von Geräten, die bestimmte Funktionen unterstützen, z. B. die Möglichkeit, Bilder aufzunehmen oder Augmented-Reality-Funktionen zu unterstützen.

Wenn Sie Ihre App als App-Bundle hochladen, erhalten Sie standardmäßig hochgradig optimierte Downloads. Für die erweiterten und anpassbaren Optionen zur Bereitstellung von Funktionen sind jedoch zusätzliche Konfigurationen und die Modularisierung der Funktionen Ihrer App mithilfe von Funktionsmodulen erforderlich. Funktionsmodule sind also die Bausteine für die Erstellung modularer Funktionen, die Sie so konfigurieren können, dass sie bei Bedarf heruntergeladen werden.

Stellen Sie sich eine App vor, 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:

• Kontoanmeldung und -erstellung
• Marketplace durchsuchen
• Artikel zum Verkauf anbieten
• Zahlungsabwicklung

In der folgenden Tabelle werden die verschiedenen Bereitstellungsoptionen beschrieben, die von Funktionsmodulen unterstützt werden, und wie sie zur Optimierung der anfänglichen Downloadgröße der Beispiel-Marktplatz-App verwendet werden können.

URI für eine Ressource erstellen

Wenn Sie über einen URI auf eine Ressource zugreifen möchten, die in einem Funktionsmodul gespeichert ist, können Sie mit Uri.Builder() einen Ressourcen-URI für das Funktionsmodul generieren:

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. So wird sichergestellt, dass der richtige Namespace generiert wird, nachdem die unterteilten APKs geladen wurden.

Angenommen, Sie haben eine App und Funktionsmodule mit den folgenden Namen:

• App-Paketname: com.example.my_app_package
• Paketname der Ressourcen des Features: com.example.my_app_package.my_dynamic_feature

Wenn sich resId im obigen Code-Snippet auf eine Rohdateiressource mit dem Namen „my_video“ in Ihrem Funktionsmodul bezieht, würde der obige Uri.Builder()-Code 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.

Wenn Sie die Pfade in Ihrem URI validieren möchten, können Sie mit dem APK Analyzer das APK Ihres Funktionsmoduls prüfen und den Paketnamen ermitteln:

Überlegungen 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 reduzieren. Bei der Verwendung von Funktionsmodulen sind jedoch einige Einschränkungen und Grenzfälle zu beachten:

• Wenn Sie 50 oder mehr Funktionsmodule auf einem einzelnen Gerät installieren, kann dies zu Leistungsproblemen führen. Module, die bei der Installation geladen 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 Auslieferung bei der Installation als entfernbar konfigurieren, auf maximal 10. Andernfalls kann sich die Download- und Installationszeit Ihrer App erhöhen.
• Nur Geräte mit Android 5.0 (API-Level 21) und höher unterstützen das Herunterladen und Installieren von Funktionen bei Bedarf. Wenn Sie Ihre Funktion für frühere Android-Versionen verfügbar machen möchten, aktivieren Sie beim Erstellen eines Funktionsmoduls die Option Zusammenführen.
• Aktiviere SplitCompat, damit deine App Zugriff auf heruntergeladene Funktionsmodule hat, die on demand bereitgestellt werden.
• In Funktionsmodulen sollten keine Aktivitäten im Manifest angegeben werden, bei denen android:exported auf true festgelegt ist. Das liegt daran, dass es keine Garantie dafür gibt, dass das Gerät das Funktionsmodul heruntergeladen hat, wenn eine andere App versucht, die Aktivität zu starten. Außerdem sollte Ihre App bestätigen, dass 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 bei Play Feature Delivery mit einem App-Bundle veröffentlichen müssen, sollten Sie sich über die bekannten Probleme mit App-Bundles informieren.

Referenz zum Manifest für Funktionsmodule

Wenn Sie ein neues Funktionsmodul mit Android Studio 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 Kompilierzeit eingefügt, sodass Sie sie nicht selbst angeben oder ändern müssen. In der folgenden Tabelle werden die Manifestattribute beschrieben, die für Funktionsmodule wichtig sind.

Zusätzliche Ressourcen

Weitere Informationen zur Verwendung von Funktionsmodulen findest du in den folgenden Ressourcen.

Blogposts

• Neue Funktionen, mit denen du Apps und Spiele bei Google Play entwickeln, veröffentlichen und deinen Umsatz steigern kannst
• Die neuesten Android App Bundle-Updates, einschließlich der API für zusätzliche Sprachen
• Patchwork Plaid — A modularization story

Videos

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

Nutzungsbedingungen und Datensicherheit

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

Datensicherheit

Die Play Core-Bibliotheken sind die Laufzeitschnittstelle Ihrer App zum Google Play Store. Wenn du Play Core in deiner App verwendest, führt der Google Play Store eigene Prozesse aus, einschließlich der Verarbeitung von Daten, die den Google Play-Nutzungsbedingungen unterliegt. Im Folgenden wird beschrieben, wie die Play Core-Bibliotheken Daten verarbeiten, um bestimmte Anfragen von deiner App zu bearbeiten.

API für zusätzliche Sprachen

Play Feature Delivery

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