Configurazione della libreria di supporto

Nota:con il rilascio di Android 9.0 (livello API 28) è disponibile una nuova versione della libreria di supporto chiamata AndroidX, che fa parte di Jetpack. La libreria AndroidX contiene la libreria di supporto esistente e include anche i componenti Jetpack più recenti.

Puoi continuare a utilizzare la libreria di assistenza. Gli artefatti storici (con versioni 27 e precedenti e pacchettizzati come android.support.*) rimarranno disponibili su Google Maven. Tuttavia, tutti i nuovi sviluppi della libreria avverranno nella libreria AndroidX.

Ti consigliamo di utilizzare le librerie AndroidX in tutti i nuovi progetti. Ti consigliamo anche di migrare i progetti esistenti ad AndroidX.

La configurazione delle librerie di supporto Android nel tuo progetto di sviluppo dipende dalle funzionalità che vuoi utilizzare e dall'intervallo di versioni della piattaforma Android che vuoi supportare con la tua applicazione.

Questo documento ti guida nel download del pacchetto Support Library e nell'aggiunta di librerie al tuo ambiente di sviluppo.

Le librerie di supporto sono ora disponibili tramite il repository Maven di Google. Non supportiamo più il download delle librerie tramite SDK Manager e questa funzionalità verrà rimossa a breve.

Scegliere le librerie di supporto

Prima di aggiungere una libreria di supporto alla tua applicazione, decidi quali funzionalità vuoi includere e le versioni di Android meno recenti che vuoi supportare. Per saperne di più sulle funzionalità fornite dalle diverse librerie, consulta Funzionalità della libreria di supporto.

Aggiunta delle librerie di supporto

Per utilizzare una libreria di supporto, devi modificare le dipendenze del classpath del progetto dell'applicazione all'interno dell'ambiente di sviluppo. Devi eseguire questa procedura per ogni Support Library che vuoi utilizzare.

Per aggiungere una libreria di supporto al progetto dell'applicazione:

1. Includi il repository Maven di Google nel file settings.gradle del progetto.

   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
   
           // If you're using a version of Gradle lower than 4.1, you must
           // instead use:
           //
           // maven {
           //     url 'https://maven.google.com'
           // }
       }
   }

2. Per ogni modulo in cui vuoi utilizzare una libreria di supporto, aggiungi la libreria nel blocco dependencies del file build.gradle del modulo. Ad esempio, per aggiungere la libreria core-utils v4, aggiungi quanto segue:

   dependencies {
       ...
       implementation "com.android.support:support-core-utils:28.0.0"
   }

Attenzione:l'utilizzo di dipendenze dinamiche (ad esempio, palette-v7:23.0.+) può causare aggiornamenti imprevisti delle versioni e incompatibilità di regressione. Ti consigliamo di specificare esplicitamente una versione della libreria (ad esempio, palette-v7:28.0.0).

Utilizzo delle API della libreria di supporto

Le classi della libreria di supporto che forniscono supporto per le API del framework esistenti in genere hanno lo stesso nome della classe del framework, ma si trovano nei pacchetti di classi android.support o hanno un suffisso *Compat.

Nota:dopo aver incluso la libreria di supporto nel progetto dell'applicazione, ti consigliamo vivamente di ridurre, offuscare e ottimizzare la tua app per la release. Oltre a proteggere il codice sorgente con l'offuscamento, la riduzione rimuove le classi inutilizzate da tutte le librerie incluse nell'applicazione, in modo da mantenere le dimensioni del download dell'applicazione il più ridotte possibile.

Ulteriori indicazioni per l'utilizzo di alcune funzionalità della Support Library sono fornite nelle classi di formazione, nelle guide e negli esempi per sviluppatori Android. Per ulteriori informazioni sulle singole classi e sui singoli metodi della libreria di supporto, consulta i pacchetti android.support nel riferimento API.

Modifiche alla dichiarazione del manifest

Se aumenti la compatibilità con le versioni precedenti della tua applicazione esistente a una versione precedente dell'API Android con la libreria di supporto, assicurati di aggiornare il manifest della tua applicazione. In particolare, devi aggiornare l'elemento android:minSdkVersion del tag <uses-sdk> nel manifest con il nuovo numero di versione inferiore, come mostrato di seguito:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

L'impostazione del manifest indica a Google Play che la tua applicazione può essere installata su dispositivi con Android 4.0 (livello API 14) e versioni successive.

Se utilizzi i file di build Gradle, l'impostazione minSdkVersion nel file di build override le impostazioni del manifest.

plugins {
  id 'com.android.application'
}

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

In questo caso, l'impostazione del file di build indica a Google Play che la variante di build predefinita della tua applicazione può essere installata su dispositivi con Android 4.1 (livello API 16) e versioni successive. Per saperne di più sulle varianti di build, consulta la panoramica del sistema di build.

Nota:se includi diverse librerie di supporto, la versione minima dell'SDK deve essere la più recente richiesta da una delle librerie specificate. Ad esempio, se la tua app include sia la libreria di supporto delle preferenze v14 sia la libreria Leanback v17, la versione minima dell'SDK deve essere 17 o superiore.