Play Feature Delivery

Das App-Auslieferungsmodell von Google Play verwendet Android App Bundles, um optimierte APKs für die Gerätekonfigurationen 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 bei Bedarf heruntergeladen werden können. Dazu müssen Sie diese Funktionen zuerst in Funktionsmodule aufteilen.

Build-Konfiguration für Funktionsmodule

Wenn Sie ein neues Funktionsmodul mit Android Studio 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 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, werden auch bestimmte Konfigurationen übernommen. Daher sollten Sie Folgendes in der Datei build.gradle des Funktionsmoduls weglassen:

• Signierungskonfigurationen:App-Bundles werden mit Signierungskonfigurationen signiert, die Sie im Basismodul angeben.
• Die Property minifyEnabled:Sie können Code-Shrinking für Ihr gesamtes App-Projekt nur über die Build-Konfiguration des Basismoduls aktivieren. Daher sollten Sie dieses Attribut aus Funktionsmodulen entfernen. Sie können jedoch zusätzliche ProGuard-Regeln für jedes Funktionsmodul angeben.
• versionCode und versionName: Beim Erstellen Ihres App-Bundles verwendet Gradle die App-Versionsinformationen, die vom Basismodul bereitgestellt werden. Sie sollten diese Properties aus der Datei build.gradle Ihres Feature-Moduls entfernen.

Beziehung zum Basismodul herstellen

Wenn Android Studio Ihr Funktionsmodul erstellt, wird es für das Basismodul sichtbar gemacht, indem die android.dynamicFeatures-Property zur build.gradle-Datei des Basismoduls hinzugefügt wird, wie unten dargestellt:

// 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 nur die Build-Konfiguration des Basismoduls das Verkleinern von Code für Ihr App-Projekt aktivieren kann, können Sie mit dem Attribut proguardFiles benutzerdefinierte ProGuard-Regeln für jedes Funktionsmodul 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 zur Build-Zeit mit denen aus anderen Modulen (einschließlich des Basismoduls) zusammengeführt werden. Jedes Funktionsmodul kann zwar einen neuen Satz von Regeln angeben, diese Regeln gelten jedoch für alle Module im App-Projekt.

App bereitstellen

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

Wenn Ihr App-Projekt ein oder mehrere Funktionsmodule enthält, können Sie auswählen, welche Funktionen beim Bereitstellen Ihrer App einbezogen werden sollen. Dazu müssen Sie Ihre vorhandene Konfiguration für das Ausführen/Debuggen wie folgt ändern:

1. Wählen Sie in der Menüleiste Run > Edit Configurations 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 Dynamische Funktionen zum Bereitstellen ein Häkchen neben jedem Funktionsmodul, das bei der Bereitstellung Ihrer App berücksichtigt werden soll.
4. Klicken Sie auf OK.

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

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. Um beispielsweise die anfängliche Downloadgröße Ihrer App zu verringern, können Sie bestimmte Funktionen so konfigurieren, 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 unterstützen.

Wenn Sie Ihre App als App-Bundle hochladen, erhalten Sie standardmäßig hochgradig optimierte Downloads. Für die erweiterten und anpassbaren Optionen für die Bereitstellung von Funktionen sind jedoch eine zusätzliche Konfiguration und Modularisierung der Funktionen Ihrer App mit Funktionsmodulen erforderlich. Das heißt, Feature-Module sind die Bausteine zum Erstellen 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 unterteilen:

• Kontoanmeldung und ‑erstellung
• Marketplace durchsuchen
• Artikel zum Verkauf anbieten
• Zahlungen verarbeiten

In der folgenden Tabelle werden die verschiedenen Bereitstellungsoptionen beschrieben, die von Funktionsmodulen unterstützt werden, und es wird erläutert, wie sie verwendet werden können, um die anfängliche Downloadgröße der Beispiel-Marketplace-App zu optimieren.

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 URI für die Ressource des Funktionsmoduls 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 Split-APKs geladen wurden.

Hier ein Beispiel für die Generierung des URI: 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 den APK Analyzer verwenden, um das APK Ihres Funktionsmoduls zu untersuchen und den Paketnamen zu 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-Bereitstellung auf einem einzelnen Gerät installieren, kann dies zu Leistungsproblemen führen. Installationszeitmodule, die nicht als entfernbar konfiguriert sind, werden automatisch in das Basismodul aufgenommen und zählen auf jedem Gerät nur als ein Funktionsmodul.
• Beschränken Sie die Anzahl der Module, die Sie für die Bereitstellung zur Installationszeit als entfernbar konfigurieren, auf maximal 10. Andernfalls kann sich die Download- und Installationszeit Ihrer App verlängern.
• Das Herunterladen und Installieren von Funktionen bei Bedarf wird nur auf Geräten mit Android 5.0 (API-Level 21) und höher unterstützt. Wenn Sie Ihr Feature für frühere Android-Versionen verfügbar machen möchten, aktivieren Sie Fusing, wenn Sie ein Feature-Modul erstellen.
• Aktivieren Sie SplitCompat, damit Ihre App auf heruntergeladene Funktionsmodule zugreifen kann, die bei Bedarf bereitgestellt werden.
• In Featuremodulen sollten keine Aktivitäten im Manifest mit android:exported auf true festgelegt werden. Das liegt daran, dass nicht garantiert werden kann, dass das Gerätemodul heruntergeladen wurde, wenn eine andere App versucht, die Aktivität zu starten. Außerdem sollte Ihre App bestätigen, dass eine Funktion heruntergeladen wurde, bevor sie versucht, auf ihren Code und ihre Ressourcen zuzugreifen. Weitere Informationen finden Sie unter Installierte Module verwalten.
• Da für Play Feature Delivery die Veröffentlichung Ihrer App mit einem App-Bundle erforderlich ist, sollten Sie sich über bekannte Probleme mit App-Bundles informieren.

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 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 finden Sie in den folgenden Ressourcen.

Blogposts

• Neue Funktionen für die Entwicklung und Veröffentlichung von Apps und für den Ausbau Ihres Geschäfts bei Google Play
• Die neuesten Updates für Android App Bundles, 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 App-Größe 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 SDK zu. Bitte lesen Sie sich alle anwendbaren Nutzungsbedingungen und Richtlinien durch, bevor Sie auf die Mediathek zugreifen.

Datensicherheit

Die Play Core-Bibliotheken sind die Laufzeitschnittstelle Ihrer App zum Google Play Store. Wenn Sie Play Core in Ihrer App verwenden, führt der Play Store eigene Prozesse aus, die die Verarbeitung von Daten gemäß den Nutzungsbedingungen von Google Play umfassen. Im Folgenden wird beschrieben, wie die Play Core-Bibliotheken Daten verarbeiten, um bestimmte Anfragen Ihrer App zu bearbeiten.

API für zusätzliche Sprachen

Play Feature Delivery

Wir möchten so transparent wie möglich sein, um Sie zu unterstützen. 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.