Play Feature Delivery

Das App-Bereitstellungsmodell von Google Play verwendet Android-Apps Sets zum Generieren und Bereitstellen optimierter APKs für die Gerätekonfiguration, sodass Nutzer nur den Code und die Ressourcen herunterladen, die sie benötigen, die App ausführen.

Play Feature Delivery nutzt die erweiterten Funktionen von App Bundles, unter bestimmten Bedingungen bereitgestellt oder on demand heruntergeladen werden können. Dazu müssen Sie diese Funktionen zuerst in Funktionsmodule.

Build-Konfiguration für Funktionsmodul

Wenn Sie mit Android Studio ein neues Funktionsmodul erstellen, wendet 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 verfügbaren Unterkünfte Standard-Anwendungs-Plug-in sind auch für Ihr Funktionsmodul verfügbar. Die folgenden Abschnitte beschreiben Sie die Eigenschaften, die Sie in Ihren Build-Konfiguration des Funktionsmoduls.

Was nicht in der Build-Konfiguration des Feature-Moduls enthalten ist

Da jedes Funktionsmodul vom Basismodul abhängt, übernimmt bestimmte Konfigurationen. Daher sollten Sie Folgendes im Feld Datei build.gradle des Funktionsmoduls:

• Signierungskonfigurationen:App-Bundles werden mithilfe von Signaturen signiert. Konfigurationen, die Sie im Basismodul angeben.
• Die Property minifyEnabled: Du kannst Folgendes tun: Codekomprimierung aktivieren für Ihr gesamtes App-Projekt nur aus dem Build des Basismoduls Konfiguration. Deshalb sollten Sie diese Eigenschaft Funktionsmodule. Sie können jedoch zusätzliche ProGuard-Regeln angeben für jedes Funktionsmodul.
• versionCode und versionName: Beim Erstellen deines App Bundles: Gradle verwendet Informationen zur App-Version, die vom Basismodul bereitgestellt werden. Du solltest diese Eigenschaften in den build.gradle-Datei.

Beziehung zum Basismodul herstellen

Wenn Android Studio dein Funktionsmodul erstellt, wird es sichtbar dem Basismodul hinzu, indem Sie die Eigenschaft android.dynamicFeatures zum build.gradle-Datei des Basismoduls, 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"]
}

Darüber hinaus 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 ermöglichen kann können Sie für jedes App-Projekt benutzerdefinierte ProGuard-Regeln festlegen, mithilfe der Funktion proguardFiles 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'
     }
}

Beachte, dass diese ProGuard-Regeln mit denen aus anderen Modulen zusammengeführt werden (einschließlich des Basismoduls) zur Build-Erstellung. Obwohl jede Funktion neue Regeln angeben, gelten diese Regeln für alle Module im App-Projekt

Anwendung bereitstellen

Während du deine App mit Unterstützung für Funktionsmodule entwickelst, kannst du Stellen Sie Ihre App wie gewohnt auf einem verbundenen Gerät bereit, indem Sie Ausführen > Ausführen über die Menüleiste (oder durch Klicken auf Ausführen in in der Symbolleiste).

Wenn Ihr App-Projekt ein oder mehrere Funktionsmodule enthält, können Sie Wählen Sie aus, welche Features bei der Bereitstellung Ihrer App berücksichtigt werden sollen, indem Sie Ihre vorhandene Ausführungs-/Fehlerbehebungskonfiguration als folgt:

1. Wählen Sie Ausführen > Edit Configurations (Konfigurationen bearbeiten) aus.
2. Wählen Sie im linken Bereich des Dialogfelds Run/Debug Configurations die gewünschte Konfiguration für die Android-App.
3. Klicken Sie auf dem Tab General (Allgemein) unter Dynamic features to deploy (Bereitstellung mit dynamischen Funktionen) das Kästchen neben neben jedem Funktionsmodul, das Sie einfügen möchten, der Bereitstellung Ihrer App.
4. Klicken Sie auf OK.

Standardmäßig wird Ihre App von Android Studio nicht mithilfe von App Bundles bereitgestellt. für Ihre App. Stattdessen gibt die IDE für Ihr Gerät APKs, die für die Bereitstellungsgeschwindigkeit optimiert sind, statt auf die APK-Größe. Um Android Studio für die Erstellung und Bereitstellung zu konfigurieren APKs und Instant-Versionen aus einem App Bundle, Ausführungs-/Debugging-Einstellungen ändern Konfiguration.

Funktionsmodule für benutzerdefinierte Zustellung verwenden

Ein besonderer Vorteil von Funktionsmodulen ist die Möglichkeit, individuell anzupassen, wie und wann verschiedene Funktionen deiner App auf Geräte mit Android 5.0 heruntergeladen werden, (API-Level 21) oder höher. Um beispielsweise die anfängliche Downloadgröße können Sie bestimmte Funktionen so konfigurieren, dass sie nach Bedarf oder nur für Geräte, die bestimmte Funktionen unterstützen, Fotos aufnehmen oder Augmented Reality-Funktionen unterstützen.

Auch wenn die Downloads beim Hochladen Ihrer App standardmäßig optimiert sind, als App Bundle sind die erweiterten und anpassbaren Optionen für die Funktionsbereitstellung erfordern eine zusätzliche Konfiguration und Modularisierung der Funktionen Ihrer App. Funktionsmodule. Funktionsmodule stellen also die zum Erstellen modularer Funktionen, die Sie jeweils nach Bedarf heruntergeladen.

Stellen Sie sich eine App vor, mit der Nutzer Waren online kaufen und verkaufen können. -Markt. Sie können jede der folgenden Funktionen sinnvoll modularisieren. der App in separate Funktionsmodule:

• Kontoanmeldung und Kontoerstellung
• Marketplace durchsuchen
• Einen Artikel zum Verkauf anbieten
• Zahlungen werden verarbeitet

In der folgenden Tabelle werden die verschiedenen Zustellungsoptionen beschrieben, die diese Funktion bietet. Unterstützung von Modulen und wie sie zur Optimierung des anfänglichen Downloads verwendet werden können Beispielgröße der Marketplace-App.

URI für eine Ressource erstellen

Wenn Sie auf eine in einem Funktionsmodul gespeicherte Ressource mithilfe eines URI erstellen, einen Ressourcen-URI für Funktionsmodul mit Uri.Builder():

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 Pfades zur Ressource wird während der Laufzeit erstellt. Dadurch wird sichergestellt, dass nach dem Laden der unterteilten APKs der richtige Namespace generiert wird.

Als Beispiel für die Generierung des URI nehmen wir an, Sie haben eine App und Funktionsmodule mit diesen Namen:

• App-Paketname: com.example.my_app_package
• Paketname der Featureressourcen: 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 ein, würde der obige Uri.Builder()-Code Geben Sie Folgendes aus:

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

Mit diesem URI kann deine App dann auf die Ressource des Funktionsmoduls zugreifen.

Mit dem APK Analyzer können Sie die Pfade in Ihrem URI validieren. um dein APK für dein Funktionsmodul zu prüfen und den Paketnamen zu ermitteln:

Abbildung 2: Verwende das APK Analyzer, um den Paketnamen in einer kompilierten Ressourcendatei zu überprüfen.

Überlegungen zu Funktionsmodulen

Mit Funktionsmodulen können Sie die Build- und 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:

• Installation von mindestens 50 Funktionsmodulen auf einem einzigen Gerät über bedingte oder On-Demand-Auslieferung zu verhindern, kann dies zu Leistungsproblemen führen. der Installationszeitmodule, sind nicht als abnehmbar konfiguriert, sind automatisch in der Basis enthalten. und zählen nur als ein Funktionsmodul auf jedem Gerät.
• Begrenzen Sie die Anzahl der Module, die Sie während der Installation als austauschbar konfigurieren Auslieferung auf 10 oder weniger. Andernfalls wird der die Download- und Installationszeit Ihrer App erhöhen können.
• Support nur auf Geräten mit Android 5.0 (API-Level 21) oder höher können Funktionen bei Bedarf heruntergeladen und installiert werden. So machen Sie Ihre Funktion verfügbar: auf früheren Android-Versionen Fusion beim Erstellen eines Funktionsmoduls.
• Aktivieren Sie SplitCompat. damit deine App Zugriff auf heruntergeladene Funktionsmodule hat, Nachfrage.
• Funktionsmodule sollten in ihrem Manifest keine Aktivitäten mit android:exported festgelegt auf true. Das liegt daran, dass es keine Garantie dafür gibt, das Funktionsmodul heruntergeladen hat, als eine andere App versucht, Aktivitäten. Außerdem sollte Ihre App bestätigen, dass eine Funktion bevor Sie versuchen, auf den Code und die Ressourcen zuzugreifen. Weitere Informationen finden Sie unter Installierte Module verwalten.
• Da du deine App für Play Feature Delivery mit einem App Bundle veröffentlichen musst, sollten Sie das App Bundle kennen, bekannten Problemen.

Manifestreferenz für Funktionsmodul

Beim Erstellen eines neuen Funktionsmoduls mit Android Studio enthält die meisten Manifestattribute, die für das Verhalten des Moduls erforderlich sind. wie ein Funktionsmodul. Außerdem werden einige Attribute vom beim Kompilieren des Systems, sodass Sie sie nicht selbst angeben oder ändern müssen. In der folgenden Tabelle werden die Manifestattribute beschrieben, die für Funktionsmodule.

Weitere Informationen

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

Blogposts

• Neue Funktionen für die Entwicklung, Veröffentlichung und den Ausbau deines Geschäfts bei Google Play
• Die neuesten Updates für Android App Bundle, einschließlich der Add-ons API
• Patchwork Plaid – Eine Geschichte zur Modularisierung

Videos

• Individuelle Bereitstellung mit dem App Bundle und einfaches Teilen von Test-Builds
• Neue Tools zur Optimierung der Größe deiner App und zur Steigerung der Installationen bei Google Play

Nutzungsbedingungen und Datensicherheit

Durch den Zugriff auf die Play Feature Delivery Library oder deren Verwendung erklärst du dich mit den Nutzungsbedingungen für das Play Core Software Development Kit. Bitte lesen und sich mit allen geltenden Nutzungsbedingungen und Richtlinien vertraut machen, bevor Sie auf die Bibliothek zugreifen.

Datensicherheit

Die Play Core-Bibliotheken sind die Schnittstelle zwischen Ihrer App und dem Google Play Store. Wenn Sie Play Core in Ihrer App verwenden, wird der Play Store daher wie die Verarbeitung von Daten gemäß den Google Play-Nutzungsbedingungen Im Folgenden wird beschrieben, wie die Play Core-Bibliotheken Daten verarbeiten, um bestimmte Anfragen aus Ihrer App zu verarbeiten.

API für zusätzliche Sprachen

Play Feature Delivery

Wir möchten Ihnen zwar so transparent wie möglich sein, aber Sie tragen die alleinige Verantwortung wie du das Formular für den Abschnitt zur Datensicherheit von Google Play ausfüllen sollst in Bezug auf die Erhebung, Weitergabe und Sicherheit von Nutzerdaten in Ihrer App.