Panoramica di Play Feature Delivery

Il modello di pubblicazione delle app di Google Play utilizza gli Android App Bundle per generare e pubblicare APK ottimizzati per la configurazione del dispositivo di ogni utente, in modo che gli utenti scarichino solo il codice e le risorse di cui hanno bisogno per eseguire la tua app.

Play Feature Delivery utilizza le funzionalità avanzate degli app bundle, consentendo di caricare alcune funzionalità della tua app in base alle condizioni o di scaricarle on demand. Per farlo, devi prima separare queste funzionalità dall'app di base in moduli di funzionalità.

Configurazione di compilazione del modulo della funzionalità

Quando crei un nuovo modulo di funzionalità utilizzando Android Studio, l'IDE applica il seguente plug-in Gradle al file build.gradle del modulo.

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

Molte delle proprietà disponibili per il plug-in dell'applicazione standard sono disponibili anche per il modulo della funzionalità. Le seguenti sezioni descrivono le proprietà che dovresti e non dovresti includere nella configurazione della build del tuo modulo delle funzionalità.

Elementi da escludere nella configurazione di compilazione del modulo della funzionalità

Poiché ogni modulo delle funzionalità dipende dal modulo di base, eredita anche determinate configurazioni. Devi quindi omettere quanto segue nel file build.gradle del modulo della funzionalità:

• Configurazioni di firma:gli app bundle vengono firmati utilizzando le configurazioni di firma specificate nel modulo di base.
• La proprietà minifyEnabled: puoi abilitare la riduzione del codice per l'intero progetto dell'app solo dalla configurazione della build del modulo di base. Dovresti quindi omettere questa proprietà dai moduli delle caratteristiche. Tuttavia, puoi specificare regole ProGuard aggiuntive per ogni modulo di funzionalità.
• versionCode e versionName: durante la creazione dell'app bundle, Gradle utilizza le informazioni sulla versione dell'app fornite dal modulo di base. Devi omettere queste proprietà dal file build.gradle del modulo di funzionalità.

Stabilire una relazione con il modulo di base

Quando Android Studio crea il modulo delle funzionalità, lo rende visibile al modulo di base aggiungendo la proprietà android.dynamicFeatures al file build.gradle del modulo di base, come mostrato di seguito:

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

Inoltre, Android Studio include il modulo di base come dipendenza del modulo della funzionalità, come mostrato di seguito:

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

Specifica regole ProGuard aggiuntive

Sebbene solo la configurazione di build del modulo di base possa attivare la riduzione del codice per il progetto dell'app, puoi fornire regole ProGuard personalizzate con ogni modulo di funzionalità utilizzando la proprietà proguardFiles, come mostrato di seguito.

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

Tieni presente che queste regole ProGuard vengono unite a quelle di altri moduli (incluso il modulo di base) in fase di creazione. Pertanto, anche se ogni modulo di funzionalità può specificare un nuovo insieme di regole, queste regole si applicano a tutti i moduli del progetto dell'app.

Esegui il deployment dell'app

Durante lo sviluppo dell'app con il supporto dei moduli di funzionalità, puoi eseguire il deployment dell'app su un dispositivo connesso come faresti normalmente selezionando Esegui > Esegui dalla barra dei menu (o facendo clic su Esegui nella barra degli strumenti).

Se il progetto dell'app include uno o più moduli delle funzionalità, puoi scegliere quali includere durante il deployment dell'app modificando la configurazione di esecuzione/debug esistente come segue:

1. Seleziona Esegui > Modifica configurazioni dalla barra dei menu.
2. Nel riquadro a sinistra della finestra di dialogo Configurazioni esecuzione/debug, seleziona la configurazione dell'app per Android che preferisci.
3. In Funzionalità dinamiche da implementare nella scheda Generali, seleziona la casella accanto a ogni modulo di funzionalità da includere durante l'implementazione dell'app.
4. Fai clic su OK.

Per impostazione predefinita, Android Studio non esegue il deployment dell'app utilizzando gli app bundle. L'IDE, infatti, compila e installa sul dispositivo APK ottimizzati per la velocità di deployment, anziché per le dimensioni. Per configurare Android Studio in modo da creare e implementare invece APK ed esperienze istantanee da un app bundle, modifica la configurazione di esecuzione/debug.

Utilizza i moduli delle funzionalità per una pubblicazione personalizzata

Un vantaggio esclusivo dei moduli delle funzionalità è la possibilità di personalizzare come e quando funzionalità diverse della tua app vengono scaricate sui dispositivi con Android 5.0 (livello API 21) o versioni successive. Ad esempio, per ridurre le dimensioni di download iniziali della tua app, puoi configurare alcune funzionalità in modo che vengano scaricate on demand in base alle necessità oppure soltanto su dispositivi che le supportano, ad esempio la possibilità di scattare foto o supportare le funzionalità di realtà aumentata.

Sebbene tu ottenga download altamente ottimizzati per impostazione predefinita quando carichi la tua app come app bundle, le opzioni di pubblicazione delle funzionalità più avanzate e personalizzabili richiedono una configurazione e una modularizzazione aggiuntive delle funzionalità dell'app tramite i moduli delle funzionalità. In altre parole, i moduli di funzionalità forniscono i componenti di base per creare funzionalità modulari che puoi configurare in modo che ciascuna possa essere scaricata in base alle esigenze.

Prendi ad esempio un'app che consente agli utenti di acquistare e vendere prodotti in un marketplace online. Puoi modularizzare ragionevolmente ciascuna delle seguenti funzionalità dell'app in moduli di funzionalità distinti:

• Accesso e creazione dell'account
• Esplorazione del marketplace
• Mettere un articolo in vendita
• Elaborazione dei pagamenti

La tabella seguente descrive le diverse opzioni di caricamento supportate dai moduli di funzionalità e come possono essere utilizzate per ottimizzare le dimensioni del download iniziale dell'app marketplace di esempio.

Creazione di un URI per una risorsa

Se vuoi accedere a una risorsa archiviata in un modulo di funzionalità utilizzando un URI, ecco come generare un URI di risorsa del modulo di funzionalità utilizzando 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();

Ogni parte del percorso alla risorsa viene costruita in fase di esecuzione, assicurando che lo spazio dei nomi corretto venga generato dopo il caricamento degli APK suddivisi.

Come esempio di come viene generato l'URI, supponiamo di avere un'app e moduli di funzionalità con i seguenti nomi:

• Nome pacchetto dell'app: com.example.my_app_package
• Nome del pacchetto delle risorse della funzionalità: com.example.my_app_package.my_dynamic_feature

Se resId nello snippet di codice riportato sopra si riferisce a una risorsa di file non elaborata denominata "my_video" nel modulo della funzionalità, il codice Uri.Builder() riportato sopra restituirà il seguente risultato:

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

Questo URI può essere utilizzato dalla tua app per accedere alla risorsa del modulo della funzionalità.

Per convalidare i percorsi nell'URI, puoi utilizzare lo Strumento di analisi APK per esaminare l'APK del modulo delle funzionalità e determinare il nome del pacchetto:

Figura 2. Utilizza APK Analyzer per ispezionare il nome del pacchetto in un file di risorse compilato.

Considerazioni sui moduli delle funzionalità

Con i moduli di funzionalità, puoi migliorare la velocità di compilazione e la velocità di ingegnerizzazione e personalizzare ampiamente la distribuzione delle funzionalità dell'app per ridurne le dimensioni. Tuttavia, ci sono alcuni vincoli e casi limite da tenere presenti quando si utilizzano i moduli delle caratteristiche:

• L'installazione di 50 o più moduli di funzionalità su un singolo dispositivo, tramite distribuzione condizionale o on demand, potrebbe causare problemi di prestazioni. I moduli al momento dell'installazione, che non sono configurati come rimovibili, vengono inclusi automaticamente nel modulo di base e conteggiati come un solo modulo delle funzionalità su ogni dispositivo.
• Limita il numero di moduli configurati come rimovibili per il caricamento al momento dell'installazione a 10 o meno. In caso contrario, il tempo di download e installazione dell'app potrebbe aumentare.
• Solo i dispositivi con Android 5.0 (livello API 21) e versioni successive supportano il download e l'installazione delle funzionalità on demand. Per rendere disponibile la tua funzionalità per le versioni precedenti di Android, abilita Fusing quando crei un modulo di funzionalità.
• Abilita SplitCompat, in modo che la tua app abbia accesso ai moduli delle funzionalità scaricati che vengono forniti on demand.
• I moduli di funzionalità non devono specificare attività nel file manifest con android:exported impostato su true. Questo perché non c'è alcuna garanzia che il dispositivo abbia scaricato il modulo della funzionalità quando un'altra app tenta di avviare l'attività. Inoltre, l'app deve confermare che una funzionalità è stata scaricata prima di tentare di accedere al relativo codice e alle relative risorse. Per scoprire di più, consulta Gestire i moduli installati.
• Poiché Play Feature Delivery richiede la pubblicazione dell'app tramite un app bundle, assicurati di essere a conoscenza dei problemi noti relativi all'app bundle.

Riferimento manifest del modulo della funzionalità

Quando crei un nuovo modulo di funzionalità utilizzando Android Studio, l'IDE include la maggior parte degli attributi del file manifest necessari al modulo per comportarsi come un modulo di funzionalità. Inoltre, alcuni attributi vengono inseriti dal sistema di compilazione in fase di compilazione, quindi non è necessario specificarli o modificarli manualmente. La tabella seguente descrive gli attributi manifest importanti per i moduli di funzionalità.

Risorse aggiuntive

Per scoprire di più sull'utilizzo dei moduli di funzionalità, prova le seguenti risorse.

Post del blog

• Nuove funzionalità che ti aiuteranno a sviluppare, rilasciare e far crescere la tua attività su Google Play
• Gli ultimi aggiornamenti di Android App Bundle, inclusa l'API delle lingue aggiuntive
• Patchwork Plaid: una storia di modularizzazione

Video

• Pubblicazione personalizzabile con l'app bundle e condivisione semplificata delle build di test
• Nuovi strumenti per ottimizzare le dimensioni della tua app e aumentare le installazioni su Google Play

Termini di servizio e sicurezza dei dati

Se accedi alla Play Feature Delivery Library o la utilizzi, accetti i Termini di servizio del kit di sviluppo software Play Core. Prima di accedere alla raccolta, leggete e comprendete tutti i termini e le norme vigenti.

Sicurezza dei dati

Le librerie Play Core sono l'interfaccia di runtime della tua app con il Google Play Store. Pertanto, quando utilizzi Play Core nella tua app, il Play Store esegue le proprie procedure, che includono il trattamento dei dati ai sensi dei Termini di servizio di Google Play. Le informazioni riportate di seguito descrivono il modo in cui le librerie Play Core gestiscono i dati per elaborare richieste specifiche della tua app.

API Additional Language

Play Feature Delivery

Cerchiamo di essere il più trasparenti possibili, ma sei l'unico responsabile della decisione su come rispondere al modulo della sezione Sicurezza dei dati di Google Play per quanto riguarda le modalità di raccolta, condivisione e sicurezza dei dati utente della tua app.