Configurazione della libreria di supporto

Nota: con il rilascio di Android 9.0 (livello API 28) è disponibile una nuova versione della libreria di supporto 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, 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 assistenza Android nel tuo progetto di sviluppo dipende dalle funzionalità che vuoi utilizzare e quale gamma di versioni della piattaforma Android vuoi supportare con un'applicazione.

Questo documento ti guida nella procedura di download del pacchetto Support Library e aggiunta di librerie al tuo ambiente di sviluppo.

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

Scelta delle librerie di assistenza

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à forniti dalle varie librerie, consulta Supporta le funzionalità della Libreria.

Aggiunta di librerie di supporto

Per utilizzare una libreria di supporto, devi modificare il delle dipendenze classpath nell'ambiente di sviluppo. Devi eseguire questa procedura per ogni libreria di supporto che vuoi utilizzare.

Per aggiungere una libreria di supporto al progetto della tua 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 nella Blocco dependencies del file build.gradle del modulo. Per Ad esempio, per aggiungere la libreria core-utils v4, aggiungi quanto segue:

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

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

Utilizzo delle API Support Library

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.

Attenzione:quando utilizzi corsi della libreria di supporto, assicurati di importare la classe dal pacchetto appropriato. Ad esempio, quando applichi ActionBar classe:

• android.support.v7.app.ActionBar quando utilizzi la Libreria di supporto.
• android.app.ActionBar se si sviluppano solo per il livello API 11 o superiore.

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.

Nel sito per gli sviluppatori Android sono disponibili ulteriori indicazioni per l'utilizzo di alcune funzionalità della Libreria di supporto corsi di formazione, guide e campioni. 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 del file 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 android:minSdkVersion dell'elemento <uses-sdk> nel manifest al nuovo numero di versione precedente, come come mostrato di seguito:

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

L'impostazione del file 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 usi i file di build Gradle, l'impostazione minSdkVersion nel file di build le impostazioni del file 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 predefinita può essere installata su dispositivi con Android 4.1 (livello API 16) e versioni successive. Per maggiori informazioni informazioni sulle varianti di build, consulta Panoramica del sistema di creazione.

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 l'app include sia la libreria Supporto preferenze v14 sia la Libreria Leanback v17, il tuo minimo La versione dell'SDK deve essere 17 o successiva.