Présentation de Play Feature Delivery

Le modèle de distribution d'application de Google Play utilise des Android App Bundles pour générer et distribuer des APK optimisés pour la configuration d'appareil de chaque utilisateur. Les utilisateurs téléchargent ainsi uniquement le code et les ressources dont ils ont besoin pour exécuter votre application.

Play Feature Delivery utilise des fonctionnalités avancées d'app bundles, qui permettent de distribuer certaines fonctionnalités de votre application de manière conditionnelle ou de les télécharger à la demande. Pour ce faire, vous devez d'abord séparer ces fonctionnalités de votre application de base en modules de fonctionnalité.

Configuration de compilation du module de fonctionnalité

Lorsque vous créez un module de fonctionnalité à l'aide d'Android Studio, l'IDE applique le plug-in Gradle suivant au fichier build.gradle du module.

// 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'
}

Nombre des propriétés disponibles pour le plug-in d'application standard sont également disponibles pour votre module de fonctionnalité. Les sections suivantes décrivent les propriétés à inclure et à ne pas inclure dans la configuration de compilation de votre module de fonctionnalité.

Éléments à ne pas inclure dans la configuration de compilation du module de fonctionnalité

Étant donné que chaque module de fonctionnalité dépend du module de base, les modules de fonctionnalité héritent également de certaines configurations. Vous devez donc omettre les éléments suivants dans le fichier build.gradle du module de fonctionnalité :

• Configurations de signature : les app bundles sont signés à l'aide des configurations de signature que vous spécifiez dans le module de base.
• Propriété minifyEnabled : vous ne pouvez activer la minification de code pour l'ensemble de votre projet d'application qu'à partir de la configuration de compilation du module de base. Vous devez donc omettre cette propriété dans les modules de fonctionnalité. Toutefois, vous pouvez spécifier des règles ProGuard supplémentaires pour chaque module de fonctionnalité.
• versionCode et versionName lors de la création de votre app bundle, Gradle utilise les informations sur la version de l'application fournies par le module de base. Vous devez omettre ces propriétés dans le fichier build.gradle de votre module de fonctionnalité.

Établir une relation avec le module de base

Après avoir créé votre module de fonctionnalité, Android Studio le rend visible par le module de base en ajoutant la propriété android.dynamicFeatures au fichier build.gradle du module de base, comme indiqué ci-dessous :

// 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"]
}

De plus, Android Studio inclut le module de base en tant que dépendance du module de fonctionnalité, comme indiqué ci-dessous :

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

Spécifier des règles ProGuard supplémentaires

Bien que seule la configuration de compilation du module de base permette la minification du code pour votre projet d'application, vous pouvez fournir des règles ProGuard personnalisées avec chaque module de fonctionnalité à l'aide de proguardFiles, comme indiqué ci-dessous.

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

Notez que ces règles ProGuard sont fusionnées avec celles d'autres modules (y compris le module de base) au moment de la compilation. Ainsi, bien que chaque module de fonctionnalité puisse spécifier un nouvel ensemble de règles, ces règles s'appliquent à tous les modules du projet d'application.

Déployer votre application

Lorsque vous développez une application avec prise en charge des modules de fonctionnalités, vous pouvez la déployer sur un appareil connecté comme vous le feriez normalement en sélectionnant Exécuter > Exécuter dans la barre de menu, ou en cliquant sur Exécuter  dans la barre d'outils.

Si votre projet d'application inclut un ou plusieurs modules de fonctionnalité, vous pouvez choisir les fonctionnalités à inclure lors du déploiement de votre application en modifiant votre configuration d'exécution/de débogage existante comme suit :

1. Sélectionnez Exécuter > Modifier les configurations dans la barre de menu.
2. Dans le panneau de gauche de la boîte de dialogue Configurations d'exécution/de débogage, sélectionnez la configuration d'application Android souhaitée.
3. Sous Fonctionnalités dynamiques à déployer dans l'onglet Général, cochez la case située à côté de chaque module de fonctionnalité que vous souhaitez inclure lors du déploiement de votre application.
4. Cliquez sur OK.

Par défaut, Android Studio n'utilise pas d'app bundles pour déployer votre application. L'IDE crée et installe sur votre appareil des APK optimisés pour leur vitesse de déploiement, plutôt que pour leur taille. Pour configurer Android Studio afin qu'il crée et déploie plutôt des APK et des expériences instantanées à partir d'un app bundle, modifiez votre configuration d'exécution/de débogage.

Utiliser des modules de fonctionnalité pour une distribution personnalisée

L'un des avantages uniques des modules de fonctionnalité est la possibilité de personnaliser quand et comment différentes fonctionnalités de votre application sont téléchargées sur des appareils équipés d'Android 5.0 (niveau d'API 21) ou version ultérieure. Pour réduire la taille de téléchargement initiale de votre application, vous pouvez configurer certaines fonctionnalités de sorte qu'elles puissent être téléchargées à la demande ou seulement sur les appareils compatibles. Par exemple, la capacité de prendre des photos ou la prise en charge de fonctionnalités de réalité augmentée.

Bien que les téléchargements soient hautement optimisés par défaut lorsque vous importez votre application en tant qu'app bundle, les options de distribution de fonctionnalités plus avancées et personnalisables nécessitent une configuration et une modularisation supplémentaires des fonctionnalités de votre application à l'aide de modules de fonctionnalité. Autrement dit, les modules de fonctionnalité fournissent des composants pour la création de fonctionnalités modulaires que vous pouvez configurer pour qu'elles puissent être téléchargées en fonction des besoins.

Prenons l'exemple d'une application qui permet à vos utilisateurs d'acheter et de vendre des produits sur une place de marché en ligne. Vous pouvez raisonnablement modulariser chacune des fonctionnalités suivantes de l'application dans des modules de fonctionnalité distincts :

• Connexion et création de compte
• Navigation dans la place de marché
• Mise en vente d'un article
• Traitement des paiements

Le tableau ci-dessous décrit les différentes options de distribution compatibles avec les modules de fonctionnalité, et explique comment elles peuvent permettre d'optimiser la taille de téléchargement initiale de l'exemple d'application de place de marché.

Créer un URI pour une ressource

Si vous souhaitez accéder à une ressource stockée dans un module de fonctionnalité à l'aide d'un URI, voici comment générer un URI de ressource de module de fonctionnalité à l'aide de 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();

Chaque partie du chemin d'accès à la ressource est construite au moment de l'exécution, ce qui garantit que l'espace de noms approprié est généré après le chargement des APK divisés.

Pour un exemple de la manière dont l'URI est généré, imaginons que vous disposez d'une application et de modules de fonctionnalité portant les noms suivants :

• Nom du package d'application : com.example.my_app_package
• Nom du package de ressources de la fonctionnalité : com.example.my_app_package.my_dynamic_feature

Si l'élément resId de l'extrait de code ci-dessus fait référence à une ressource de fichier brute nommée "my_video" dans votre module de fonctionnalité, le code Uri.Builder() ci-dessus génère le résultat suivant :

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

Votre application peut ensuite utiliser cet URI pour accéder à la ressource du module de fonctionnalité.

Pour valider les chemins dans votre URI, vous pouvez utiliser l'analyseur d'APK pour inspecter l'APK du module de fonctionnalité et déterminer le nom du package :

Remarques concernant les modules de fonctionnalité

Les modules de fonctionnalité vous permettent d'améliorer la vitesse de compilation et d'ingénierie, et de personnaliser de manière significative la distribution des fonctionnalités de votre application afin de réduire sa taille. Toutefois, vous devez tenir compte de certaines contraintes et de certains cas particuliers lorsque vous utilisez des modules de fonctionnalité :

• L'installation de 50 modules de fonctionnalité ou plus sur un seul appareil via une distribution conditionnelle ou à la demande peut entraîner des problèmes de performances. Les modules d'installation de l'application, qui ne sont pas configurés comme pouvant être supprimés, sont automatiquement inclus dans le module de base et ne comptent que pour un module de fonctionnalité sur chaque appareil.
• Limitez le nombre de modules que vous configurez comme pouvant être supprimés pour la distribution au moment de l'installation à 10 ou moins. Sinon, le temps de téléchargement et d'installation de votre application peut augmenter.
• Seuls les appareils équipés d'Android 5.0 (niveau d'API 21) ou version ultérieure sont compatibles avec le téléchargement et l'installation de fonctionnalités à la demande. Pour rendre votre fonctionnalité disponible dans les versions antérieures d'Android, activez Fusing lorsque vous créez un module de fonctionnalité.
• Activez SplitCompat afin que votre application ait accès aux modules de fonctionnalité téléchargés et distribués à la demande.
• Les modules de fonctionnalité ne doivent pas spécifier d'activités dans leur fichier manifeste lorsque android:exported est défini sur true. En effet, rien ne garantit que l'appareil a téléchargé le module de fonctionnalité lorsqu'une autre application tente de lancer l'activité. Par ailleurs, votre application doit confirmer qu'une fonctionnalité a été téléchargée avant d'essayer d'accéder à son code et à ses ressources. Pour en savoir plus, consultez la section Gérer les modules installés.
• Comme Play Feature Delivery nécessite de publier votre application à l'aide d'un app bundle, assurez-vous de connaître les problèmes connus avec les app bundle.

Référence du fichier manifeste du module de fonctionnalité

Lors de la création d'un module de fonctionnalité à l'aide d'Android Studio, l'IDE inclut la plupart des attributs de manifeste dont le module a besoin pour se comporter comme un module de fonctionnalité. De plus, certains attributs sont injectés par le système de compilation au moment de la compilation. Vous n'avez donc pas besoin de les spécifier ni de les modifier vous-même. Le tableau suivant décrit les attributs de fichier manifeste qui sont importants pour les modules de fonctionnalité.

Ressources supplémentaires

Pour en savoir plus sur l'utilisation des modules de fonctionnalité, consultez les ressources suivantes.

Articles de blog

• New features to help you develop, release, and grow your business on Google Play (Nouvelles fonctionnalités pour vous aider à développer, publier et développer votre activité sur Google Play)
• Dernières mises à jour du format Android App Bundle, y compris l'API destinée aux langues supplémentaires
• Patchwork Plaid — A modularization story (Plaid en patchwork - Une histoire de modularisation)

Vidéos

• Distribution personnalisable avec App Bundle et partage simplifié des versions de build
• New Tools to Optimize Your App's Size and Boost Installs on Google Play (Nouveaux outils pour optimiser la taille de votre application et booster les installations sur Google Play)

Conditions d'utilisation et sécurité des données

En accédant à la bibliothèque Play Feature Delivery ou en l'utilisant, vous acceptez les Conditions d'utilisation du kit de développement logiciel Play Core. Lisez attentivement les règles et conditions d'utilisation applicables avant d'accéder à la bibliothèque.

Sécurité des données

Les bibliothèques Play Core constituent l'interface d'exécution de votre application avec le Google Play Store. Ainsi, lorsque vous utilisez Play Core dans votre application, le Play Store exécute ses propres processus, y compris le traitement des données conformément aux Conditions d'utilisation de Google Play. Les informations ci-dessous décrivent comment les bibliothèques Play Core traitent les données pour traiter des requêtes spécifiques de votre application.

API de langues supplémentaires

Play Feature Delivery

Notre objectif est d'être les plus transparents possible. Toutefois, vous êtes seul responsable de vos réponses au formulaire de Google Play pour la section Sécurité des données concernant la collecte et le partage des données utilisateur dans votre application, ainsi que vos pratiques de sécurité.