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 necessari per eseguire la tua app.

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

Configurazione della build del modulo delle funzionalità

Quando crei un nuovo modulo delle 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 delle funzionalità. Le sezioni seguenti descrivono le proprietà che devi e non devi includere nella configurazione di build del modulo delle funzionalità.

Elementi da escludere dalla configurazione di build del modulo delle funzionalità

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

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

Stabilire una relazione con il modulo base

Quando Android Studio crea il modulo della funzionalità, lo rende visibile al modulo base aggiungendo la proprietà android.dynamicFeatures al file build.gradle del modulo 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 base come dipendenza del modulo delle 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')
}

Specificare regole ProGuard aggiuntive

Sebbene solo la configurazione della build del modulo base possa attivare la riduzione del codice per il progetto dell'app, puoi fornire regole ProGuard personalizzate con ogni modulo delle 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 base) al momento della compilazione. Pertanto, mentre ogni modulo delle 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

Mentre sviluppi l'app con il supporto dei moduli delle 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 tuo progetto di app include uno o più moduli delle funzionalità, puoi scegliere le funzionalità da 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 di esecuzione/debug, seleziona la configurazione App Android che preferisci.
3. Nella sezione Funzionalità dinamiche da implementare della scheda Generale, seleziona la casella accanto a ogni modulo delle 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. Al contrario, l'IDE crea e installa APK sul dispositivo ottimizzati per la velocità di deployment, anziché per le dimensioni dell'APK. Per configurare Android Studio in modo da creare ed eseguire il deployment di APK e app istantanee da un app bundle, modifica la configurazione di esecuzione/debug.

Utilizzare i moduli delle funzionalità per la pubblicazione personalizzata

Un vantaggio unico dei moduli delle funzionalità è la possibilità di personalizzare come e quando le diverse funzionalità dell'app vengono scaricate sui dispositivi con Android 5.0 (livello API 21) o versioni successive. Ad esempio, per ridurre le dimensioni di download iniziali dell'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 il supporto delle funzionalità di realtà aumentata.

Anche se per impostazione predefinita ottieni download altamente ottimizzati quando carichi l'app come app bundle, le opzioni di distribuzione delle funzionalità più avanzate e personalizzabili richiedono una configurazione e una modularizzazione aggiuntive delle funzionalità dell'app utilizzando i moduli delle funzionalità. ovvero, i moduli delle funzionalità forniscono i componenti di base per la creazione di funzionalità modulari che puoi configurare in modo che vengano scaricate singolarmente in base alle necessità.

Prendi in considerazione un'app che consenta ai tuoi utenti di acquistare e vendere beni in un marketplace online. Puoi modularizzare in modo ragionevole ciascuna delle seguenti funzionalità dell'app in moduli di funzionalità separati:

• Accesso e creazione dell'account
• Navigazione nel marketplace
• Inserimento di un articolo in vendita
• Elaborazione dei pagamenti

La tabella seguente descrive le diverse opzioni di pubblicazione supportate dai moduli delle 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 delle funzionalità utilizzando un URI, ecco come generare un URI risorsa del modulo delle 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 creata in fase di runtime, garantendo 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 delle funzionalità con questi nomi:

• Nome pacchetto app: com.example.my_app_package
• Nome del pacchetto di risorse della funzionalità: com.example.my_app_package.my_dynamic_feature

Se resId nello snippet di codice precedente si riferisce a una risorsa di file non elaborato denominata "my_video" nel modulo della funzionalità, il codice Uri.Builder() precedente produrrà il seguente output:

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 delle funzionalità.

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

Considerazioni per i moduli delle funzionalità

Con i moduli delle funzionalità, puoi migliorare la velocità di build e di ingegneria e personalizzare in modo approfondito la distribuzione delle funzionalità della tua app per ridurne le dimensioni. Tuttavia, quando utilizzi i moduli delle funzionalità, devi tenere presente alcuni vincoli e casi limite:

• L'installazione di 50 o più moduli delle funzionalità su un singolo dispositivo, tramite la pubblicazione 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 vengono conteggiati come un solo modulo delle funzionalità su ogni dispositivo.
• Limita il numero di moduli che configuri come rimovibili per la distribuzione al momento dell'installazione a un massimo di 10. 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 di funzionalità on demand. Per rendere disponibile la funzionalità per le versioni precedenti di Android, attiva Fusing quando crei un modulo delle funzionalità.
• Attiva SplitCompat, in modo che la tua app abbia accesso ai moduli delle funzionalità scaricati e forniti su richiesta.
• I moduli delle funzionalità non devono specificare attività nel file manifest con android:exported impostato su true. Questo perché non è garantito che il dispositivo abbia scaricato il modulo delle 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ù, leggi Gestire i moduli installati.
• Poiché Play Feature Delivery richiede la pubblicazione dell'app utilizzando un app bundle, assicurati di essere a conoscenza dei problemi noti relativi agli app bundle.

Riferimento al manifest del modulo delle funzionalità

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

Risorse aggiuntive

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

Post del blog

• Nuove funzionalità per aiutarti 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 facilità di condivisione dei build di test
• Nuovi strumenti per ottimizzare le dimensioni dell'app e aumentare le installazioni su Google Play

Termini di servizio e sicurezza dei dati

Se accedi alla libreria Play Feature Delivery o la utilizzi, accetti i Termini di servizio del kit di sviluppo software Play Core. Leggi e comprendi tutti i termini e le norme vigenti prima di accedere alla libreria.

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 i propri processi, che includono la gestione dei dati regolata dai Termini di servizio di Google Play. Le informazioni riportate di seguito descrivono come le librerie Play Core gestiscono i dati per elaborare richieste specifiche dalla tua app.

API per lingue aggiuntive

Play Feature Delivery

Sebbene il nostro obiettivo sia la massima trasparenza, sei l'unico responsabile della decisione su come rispondere al modulo della sezione Sicurezza dei dati di Google Play in merito alle pratiche di raccolta, condivisione e sicurezza dei dati utente della tua app.