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, tutti i nuovi sviluppi nelle biblioteche verrà eseguita nella libreria AndroidX.

Ti consigliamo di utilizzare le librerie AndroidX in tutti i nuovi progetti. Dovresti inoltre prendere in considerazione eseguendo la migrazione ad AndroidX di progetti esistenti.

Il modo in cui configuri le librerie di assistenza Android nel tuo progetto di sviluppo dipende dalle funzionalità che vuoi utilizzare e la gamma di versioni della piattaforma Android che 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 l'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 di Android più recenti che vuoi supportare. Per ulteriori informazioni sulle funzionalità forniti dalle varie librerie, consulta Supporta le funzionalità della Libreria.

Aggiunta di librerie di assistenza

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 nella cartella settings.gradle.

   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 in genere hanno il stesso nome della classe framework ma si trovano nei pacchetti di classi android.support, o avere un suffisso *Compat.

Nota:una volta inclusa la libreria di supporto nel progetto della tua applicazione, Consigliamo vivamente di ridurre, offuscare e ottimizzare la tua app per il rilascio. Oltre a proteggere il codice sorgente con l'offuscamento, rimuove le classi inutilizzate da tutte le librerie che includi nell'applicazione, mantenendo di download dell'applicazione il più piccolo 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 su singoli metodi e classi della Libreria di supporto, vedi i pacchetti android.support nel riferimento API.

Modifiche alla dichiarazione del file manifest

Se stai aumentando la compatibilità con le versioni precedenti della tua applicazione esistente a una versione dell'API Android con la libreria di supporto, assicurati di aggiornare il codice del file manifest. 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 ulteriori informazioni informazioni sulle varianti di build, consulta Panoramica del sistema di creazione.

Nota: se hai incluso diverse librerie di supporto, il la versione minima dell'SDK deve essere la versione più alta richiesta da uno qualsiasi degli alle 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.