Questa pagina è stata tradotta dall'API Cloud Translation.

Configurazione della libreria di assistenza

Nota: con la release 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 assistenza esistente e include anche i componenti Jetpack più recenti.

Puoi continuare a utilizzare la libreria di assistenza. Gli artefatti storici (quelli con versione 27 e precedenti e pacchettizzati come android.support.*) rimarranno disponibili su Google Maven. Tuttavia, lo sviluppo di tutte le nuove librerie avverrà nella libreria AndroidX.

Consigliamo di utilizzare le librerie AndroidX in tutti i nuovi progetti. Consigliamo anche di eseguire la migrazione dei progetti esistenti ad AndroidX.

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

Questo documento ti aiuta a scaricare il pacchetto della libreria di assistenza e ad 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à presto rimossa.

Scegliere le librerie di assistenza

Prima di aggiungere una libreria di assistenza all'applicazione, decidi quali funzionalità vuoi includere e quali sono le versioni Android più basse che vuoi supportare. Per scoprire di più sulle funzionalità fornite dalle diverse librerie, consulta la sezione Funzionalità della libreria di assistenza.

Aggiungere librerie di assistenza

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

Per aggiungere una libreria di assistenza al progetto della tua applicazione:

Includi il repository Maven di Google nel file settings.gradle del tuo 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'
        // }
    }
}

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 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 della versione imprevisti e incompatibilità delle regressioni. Ti consigliamo di specificare esplicitamente una versione della libreria (ad esempio palette-v7:28.0.0).

Utilizzo delle API della libreria di assistenza

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

Attenzione: quando utilizzi i corsi dalla libreria di assistenza, assicurati di importare il corso dal pacchetto appropriato. Ad esempio, quando applichi la classe ActionBar:

android.support.v7.app.ActionBar quando viene utilizzata la libreria di assistenza.
android.app.ActionBar per lo sviluppo solo per il livello API 11 o livelli successivi.

Nota: dopo aver incluso la libreria di assistenza nel progetto della tua applicazione, ti consigliamo vivamente di restringere, offuscare e ottimizzare l'app per il rilascio. Oltre a proteggere il codice sorgente con offuscamento, la riduzione rimuove le classi inutilizzate da qualsiasi libreria inclusa nell'applicazione, mantenendo le dimensioni di download dell'applicazione il più ridotte possibile.

Ulteriori indicazioni sull'utilizzo di alcune funzionalità della libreria di assistenza sono disponibili nei corsi di formazione, nelle guide e negli esempi di Android per sviluppatori. Per maggiori informazioni sui singoli metodi e classi delle librerie di assistenza, consulta 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 precedente dell'API Android con la libreria di assistenza, assicurati di aggiornare il manifest dell'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 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 utilizzi i file di build Gradle, l'impostazione minSdkVersion nel file di build sostituisce 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 della build dell'applicazione può essere installata sui dispositivi con Android 4.1 (livello API 16) e versioni successive. Per ulteriori informazioni sulle varianti della build, consulta la panoramica del sistema di build.

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

Indietro

软件包

Avanti