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 elementi storici (con versione 27 e precedenti e pacchettizzati come android.support.*) rimarranno disponibili su Google Maven. Tuttavia, tutto il nuovo sviluppo delle librerie avviene nella libreria AndroidX.

Ti consigliamo di utilizzare le librerie AndroidX in tutti i nuovi progetti. Ti consigliamo inoltre di eseguire la migrazione dei progetti esistenti ad AndroidX.

Il modo in cui configuri le 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 illustra come scaricare il pacchetto della libreria di supporto e aggiungere 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à includere e le versioni Android minime che vuoi supportare. Per ulteriori informazioni sulle funzionalità offerte dalle diverse librerie, consulta Funzionalità delle librerie di supporto.

Aggiunta di librerie di supporto

Per utilizzare una libreria di supporto, devi modificare le dipendenze del classpath del progetto dell'applicazione nell'ambiente di sviluppo. Devi eseguire questa procedura per ogni libreria di supporto 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, aggiungila nel blocco dependencies del file build.gradle del modulo. Ad esempio, per aggiungere la libreria core-utils 4, 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 hanno in genere 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 le dimensioni, offuscare e ottimizzare la tua app per la pubblicazione. Oltre a proteggere il codice sorgente con l'offuscamento, la riduzione rimuove le classi inutilizzate da tutte le librerie incluse nell'applicazione, mantenendo così le dimensioni del download dell'applicazione il più ridotte possibile.

Ulteriori indicazioni per l'utilizzo di alcune funzionalità della libreria di supporto sono disponibili nei corsi di formazione, nelle guide e nei sample per sviluppatori Android. Per ulteriori informazioni sulle singole classi e sui singoli metodi della libreria di assistenza, consulta i pacchetti android.support nel riferimento all'API.

Modifiche alla dichiarazione manifest

Se stai aumentando la compatibilità con le versioni precedenti della tua applicazione esistente a una versione precedente della API Android con la Libreria Supporto, assicurati di aggiornare il file manifest della tua applicazione. In particolare, devi aggiornare l'elemento android:minSdkVersion del tag <uses-sdk> nel file manifest con il nuovo numero di versione inferiore, come показано показано di seguito:

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

L'impostazione 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 compilazione Gradle, l'impostazione minSdkVersion nel file di compilazione aggira 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 maggiori informazioni 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 versione più recente richiesta da una delle librerie specificate. Ad esempio, se la tua app include sia la libreria di supporto delle preferenze 14 sia la libreria Leanback 17, la versione minima dell'SDK deve essere 17 o successiva.