Pacchetti della libreria di supporto

Nota: con la release della libreria di assistenza 28.0.0, le librerie in pacchetto android.support vengono deprecate e sostituite da librerie Jetpack con versioni individuali pacchettizzate come androidx. La release iniziale 1.0.0 delle librerie Jetpack corrisponde alla libreria di supporto 28.0.0 e fornisce un punto di partenza per la migrazione alla nuova pacchettizzazione androidx.

Le librerie in pacchetto android.support esistenti continueranno a funzionare, ma non riceveranno aggiornamenti oltre la versione 28.0.0 e non saranno compatibili con le nuove librerie Jetpack. Gli artefatti storici (quelli con versione 27 e precedenti e pacchettizzati come android.support) rimarranno disponibili in Google Maven. Tutti i nuovi artefatti verranno pacchettizzati come androidx e richiederà la migrazione da android.support a androidx.

Ti consigliamo di utilizzare le librerie androidx in tutti i nuovi progetti. Valuta anche la possibilità di eseguire la migrazione dei progetti esistenti per assicurarti che continuino a ricevere correzioni di bug e altri miglioramenti della libreria.

La libreria di supporto Android contiene diversi pacchetti di librerie che possono essere inclusi nella tua applicazione. Ognuna di queste librerie supporta una gamma specifica di versioni della piattaforma Android e un insieme di funzionalità.

Per utilizzare una delle seguenti librerie, devi scaricare i file delle librerie nella tua installazione dell'SDK Android. Segui le indicazioni per scaricare le librerie di assistenza in Configurazione della libreria di supporto per completare questo passaggio. Devi seguire alcuni passaggi aggiuntivi per includere una libreria di assistenza specifica nella tua applicazione. Consulta la fine di ogni sezione sulle librerie di seguito per informazioni importanti su come includere la libreria nella tua applicazione.

Nota: la versione minima dell'SDK per tutti i pacchetti di librerie di assistenza è almeno al livello API 14. Alcuni pacchetti richiedono un livello API superiore, come indicato di seguito.

Librerie di assistenza v4

Queste librerie includono l'insieme di API più ampio rispetto alle altre librerie, che include supporto per i componenti delle applicazioni, le funzioni dell'interfaccia utente, l'accessibilità, la gestione dei dati, la connettività di rete e le utilità di programmazione.

Per informazioni complete e dettagliate sulle classi e sui metodi forniti dalle librerie di supporto v4, consulta il pacchetto android.support.v4 nel riferimento dell'API.

Nota: prima della revisione della libreria di supporto 24.2.0, esisteva un'unica libreria di supporto v4. La libreria è stata suddivisa in più moduli per migliorare l'efficienza. Per la compatibilità con le versioni precedenti, se elenchi support-v4 nello script Gradle, la tua app includerà tutti i moduli della versione 4. Tuttavia, per ridurre le dimensioni dell'app, ti consigliamo di elencare semplicemente i moduli specifici necessari per l'app.

libreria compatibili v4

Fornisce wrapper di compatibilità per una serie di API framework, come Context.obtainDrawable() e View.performAccessibilityAction().

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-compat:28.0.0

libreria core-utils v4

Fornisce una serie di classi di utilità, come AsyncTaskLoader e PermissionChecker.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-core-utils:28.0.0

libreria UI core v4

Implementa una serie di componenti relativi all'interfaccia utente, come ViewPager, NestedScrollView e ExploreByTouchHelper.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-core-ui:28.0.0

libreria di compatibilità multimediale v4

Esegue il backporting di parti del framework media, tra cui MediaBrowser e MediaSession.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-media-compat:28.0.0

libreria di frammenti v4

Aggiunge il supporto per l'incapsulamento dell'interfaccia utente e delle funzionalità con frammenti, consentendo alle applicazioni di fornire layout che si adattano a dispositivi con schermi di piccole dimensioni e uno di grandi dimensioni. Questo modulo ha dipendenze su compat, core-utils, core-ui e media-compat.

Nota: la libreria di supporto v13 fornisce un corso FragmentCompat. La classe Fragment v4 è una classe autonoma che fornisce correzioni di bug aggiunte nelle versioni successive della piattaforma, mentre la classe FragmentCompat v13 fornisce shim di compatibilità per l'implementazione del framework della classe Fragment.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-fragment:28.0.0

libreria di supporto Multidex

Questa libreria supporta la creazione di app con più file Dalvik Executable (DEX). Le app che fanno riferimento a più di 65536 metodi sono necessarie per usare le configurazioni multidex. Per ulteriori informazioni sull'utilizzo del protocollo multidex, consulta la pagina relativa alla creazione di app con oltre 64.000 metodi.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:multidex:1.0.0

Librerie di assistenza v7

Queste librerie forniscono set di funzionalità specifici e possono essere incluse nell'applicazione in modo indipendente l'una dall'altra.

Libreria appcompat v7 Parte di Android Jetpack.

Nota: è stata eseguita la migrazione della libreria appcompat nella libreria AndroidX, che è un componente Android Jetpack. Guarda come viene utilizzato nell'app demo Girasole.

Questa libreria aggiunge il supporto per il pattern di progettazione dell'interfaccia utente della barra delle azioni. Questa libreria include supporto per le implementazioni dell'interfaccia utente di material design.

Nota: questa libreria dipende dalla libreria di supporto v4.

Ecco alcune delle classi chiave incluse nella libreria di appcompat v7:

  • ActionBar: fornisce un'implementazione del pattern dell'interfaccia utente della barra delle azioni. Per ulteriori informazioni sull'utilizzo della barra delle azioni, consulta la guida per gli sviluppatori della barra delle azioni.
  • AppCompatActivity - Aggiunge una classe di attività dell'applicazione che può essere utilizzata come classe base per le attività che utilizzano l'implementazione della barra delle azioni della libreria di assistenza.
  • AppCompatDialog: aggiunge una classe delle finestre di dialogo che può essere utilizzata come classe base per le finestre di dialogo a tema AppCompat.
  • ShareActionProvider: aggiunge il supporto per un'azione di condivisione standardizzata (come email o pubblicazione su applicazioni social) che può essere inclusa in una barra delle azioni.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:appcompat-v7:28.0.0

raccolta di visualizzazioni di schede v7

Questa libreria aggiunge il supporto per il widget CardView, che ti consente di mostrare informazioni all'interno delle schede con un aspetto coerente su qualsiasi app. Queste schede sono utili per le implementazioni di material design e sono utilizzate ampiamente nei layout per le app TV.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:cardview-v7:28.0.0

libreria layout griglia v7

Dopo aver scaricato le librerie di assistenza Android, questa libreria aggiunge il supporto per la classe GridLayout, che ti consente di organizzare gli elementi dell'interfaccia utente su una griglia di celle rettangolari. Per informazioni dettagliate sulle API della libreria griglia v7, consulta il pacchetto android.support.v7.widget nella documentazione di riferimento dell'API.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:gridlayout-v7:28.0.0

libreria mediarouter v7

Questa raccolta fornisce MediaRouter, MediaRouteProvider e corsi multimediali correlati che supportano Google Cast.

In generale, le API nella libreria mediarouter v7 forniscono un mezzo per controllare il routing dei canali multimediali e degli stream dal dispositivo attuale a schermi esterni, speaker e altri dispositivi di destinazione. La libreria include API per la pubblicazione di fornitori di route multimediali specifici per app, per il rilevamento e la selezione dei dispositivi di destinazione, per il controllo dello stato dei contenuti multimediali e altro ancora. Per informazioni dettagliate sulle API della libreria mediarouter v7, consulta il pacchetto android.support.v7.media nella documentazione di riferimento API.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:mediarouter-v7:28.0.0

Le API della libreria mediarouter v7 introdotte nella libreria di supporto r18 sono soggette a modifiche nelle revisioni successive della libreria di supporto. Al momento, consigliamo di utilizzare la raccolta soltanto in relazione a Google Cast.

libreria tavolozza v7

La libreria di supporto per la tavolozza v7 include la classe Palette, che consente di estrarre i colori in evidenza da un'immagine. Ad esempio, un'app di musica potrebbe utilizzare un oggetto Palette per estrarre i colori principali dalla copertina di un album e utilizzarli per creare una scheda del titolo di un brano con colori coordinati.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:palette-v7:28.0.0

libreria di riciclo v7

La libreria recyclerview aggiunge la classe RecyclerView. Questa classe fornisce supporto per il widget RecyclerView, una visualizzazione che consente di visualizzare in modo efficiente set di dati di grandi dimensioni fornendo una finestra limitata di elementi di dati.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:recyclerview-v7:28.0.0

Libreria di supporto preferenze v7

Il pacchetto preference fornisce API per supportare l'aggiunta di oggetti preferenza, come CheckBoxPreference e ListPreference, per consentire agli utenti di modificare le impostazioni dell'interfaccia utente.

La libreria delle preferenze v7 aggiunge il supporto per interfacce come Preference.OnPreferenceChangeListener e Preference.OnPreferenceClickListener e per classi, come CheckBoxPreference e ListPreference.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:preference-v7:28.0.0

Libreria di supporto v8

Questa libreria fornisce set di funzionalità specifici e può essere inclusa nell'applicazione indipendentemente dalle altre librerie.

libreria di script di rendering v8

Questa libreria aggiunge il supporto per il framework di calcolo RenderScript. Queste API sono incluse nel pacchetto android.support.v8.renderscript. Tieni presente che la procedura per includere queste API nell'applicazione è molto diversa dalle altre API della libreria di assistenza. Per ulteriori informazioni sull'utilizzo di queste API nella tua applicazione, consulta la guida per gli sviluppatori RenderScript.

Nota: l'utilizzo di RenderScript con la libreria di supporto è supportato con le build basate su Android Studio e Gradle. La libreria di renderingscript si trova nella cartella build-tools/$VERSION/renderscript/.

L'esempio seguente mostra le proprietà degli script di build Gradle per questa libreria:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Libreria di supporto v13

Questa libreria aggiunge supporto per il pattern dell'interfaccia utente Fragment con la classe (FragmentCompat) e altre classi di supporto dei frammenti. Per ulteriori informazioni sui frammenti, consulta la guida per gli sviluppatori Frammenti. Per informazioni dettagliate sulle API Support Library v13, consulta il pacchetto android.support.v13 nella documentazione di riferimento dell'API.

Nota: la libreria di frammenti v4 fornisce una classe Fragment. La classe Fragment v4 è una classe autonoma che fornisce correzioni di bug aggiunte nelle versioni successive della piattaforma, mentre la classe FragmentCompat v13 fornisce shim di compatibilità per l'implementazione del framework della classe Fragment.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-v13:28.0.0

Libreria di supporto preferenze v14

Il pacchetto android.support.v14.preference fornisce API per aggiungere il supporto per le interfacce di preferenza come PreferenceFragment.OnPreferenceStartFragmentCallback e PreferenceFragment.OnPreferenceStartScreenCallback, oltre a classi come MultiSelectListPreference e PreferenceFragment. Per informazioni dettagliate sulle API Preference Support Library v14, consulta il pacchetto preference nel riferimento dell'API.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:preference-v14:28.0.0

Libreria di supporto delle preferenze v17 per la TV

Il pacchetto android.support.v17.preference fornisce API per fornire le interfacce preferite sui dispositivi TV, compreso il supporto per l'interfaccia e le classi LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener, quali BaseLeanbackPreferenceFragment e LeanbackPreferenceFragment. Per informazioni dettagliate sulle API Preference Support Library v17, consulta il pacchetto preference nel riferimento dell'API.

Questo pacchetto richiede il livello API 17 o versioni successive. L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

 com.android.support:preference-leanback-v17:28.0.0 

Libreria Leanback v17

Il pacchetto android.support.v17.leanback fornisce API per supportare la creazione di interfacce utente sui dispositivi TV. Offre una serie di widget importanti per le app TV. Alcune delle classi più importanti includono:

Questo pacchetto richiede il livello API 17 o versioni successive. L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:leanback-v17:28.0.0

Libreria di disegni vettoriali

Offre supporto per grafiche vettoriali statiche.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-vector-drawable:28.0.0

Raccolta di disegni vettoriali animati

Offre supporto per grafiche vettoriali animate.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:animated-vector-drawable:28.0.0

Libreria di supporto delle annotazioni

Il pacchetto Annotation fornisce API per supportare l'aggiunta di metadati delle annotazioni alle tue app.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-annotations:28.0.0

Libreria di supporto alla progettazione

Il pacchetto Design fornisce API per supportare l'aggiunta di pattern e componenti di material design alle tue app.

La libreria di Design Support aggiunge il supporto di vari componenti e pattern di Material Design su cui gli sviluppatori di app possono integrare, come cassetti di navigazione, pulsanti di azione mobili (FAB), snackbar e schede.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:design:28.0.0

Libreria supporto schede personalizzate

Il pacchetto Schede personalizzate fornisce API per supportare l'aggiunta e la gestione di schede personalizzate nelle tue app.

La libreria di assistenza per le schede personalizzate aggiunge il supporto per varie classi, ad esempio il servizio per le schede personalizzate e il callback per le schede personalizzate.

Questo pacchetto richiede il livello API 15 o versioni successive. L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:customtabs:28.0.0

libreria di supporto di Percent

Il pacchetto Percent fornisce API per supportare l'aggiunta e la gestione di dimensioni basate su percentuale nella tua app.

Nota:a partire dalla release 26.0.0, la libreria Percent Support è stata ritirata. I client di questo modulo devono eseguire la migrazione al nuovo widget ConstraintLayout, che viene fornito come artefatto separato in SDK Manager.

La libreria Percent Support aggiunge il supporto per l'interfaccia PercentLayoutHelper.PercentLayoutParams e per varie classi, come PercentFrameLayout e PercentrelativeLayout.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:percent:28.0.0

Libreria di supporto ExifInterface

I tag EXIF memorizzano informazioni come orientamento, data e ora, informazioni della fotocamera e posizione direttamente in un file JPEG o RAW. La classe ExifInterface separa il supporto per la lettura di informazioni EXIF da file in formato JPEG e non elaborati (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW e RAF) e per l'impostazione delle informazioni EXIF sui file immagine JPEG.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:exifinterface:28.0.0

Libreria di supporto dei suggerimenti di app per la TV

Il pacchetto Consigli per app fornisce API per supportare l'aggiunta di consigli sui contenuti nella tua app in esecuzione sui dispositivi TV.

La libreria di app aggiunge il supporto per le annotazioni, come ContentRecommendation.ContentMaturity e varie classi, come ContentRecommendation e RecommendationExtender.

Questo pacchetto richiede il livello API 21 o versioni successive. L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:recommendation:28.0.0

libreria di Wear UI

Questa libreria contiene API per la creazione di interfacce utente per le app Wear. Le API, disponibili nel pacchetto android.support.wear.widget, sostituiscono le API corrispondenti nella libreria di assistenza per dispositivi indossabili.

Per ulteriori informazioni, consulta la sezione Utilizzare la libreria UI di Wear.

L'identificatore di dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:wear:28.0.0