Pacchetti della libreria di supporto

Nota:con il rilascio della libreria di supporto 28.0.0, le librerie android.support incluse nel pacchetto sono ritirate e sostituite da librerie Jetpack con versioni individuali incluse nel pacchetto androidx. La release iniziale 1.0.0 delle librerie Jetpack offre parità con la libreria di supporto 28.0.0 e fornisce un punto di partenza per la migrazione al nuovo pacchetto androidx.

Le librerie esistenti incluse in android.support 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 (con versioni 27 e precedenti e pacchettizzati come android.support) rimarranno disponibili su Google Maven. Tutti i nuovi artefatti verranno pacchettizzati come androidx e richiederanno la migrazione da android.support a androidx.

Ti consigliamo di utilizzare le librerie androidx in tutti i nuovi progetti. Ti consigliamo anche 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 un intervallo specifico di versioni della piattaforma Android e un insieme di funzionalità.

Per utilizzare una delle seguenti librerie, devi scaricare i file della libreria nell'installazione dell'SDK Android. Per completare questo passaggio, segui le istruzioni per scaricare le librerie di supporto in Configurazione della libreria di supporto. Devi eseguire passaggi aggiuntivi per includere una libreria di supporto specifica nella tua applicazione. Vedi la fine di ogni sezione della libreria di seguito per informazioni importanti su come includere la libreria nella tua applicazione.

Nota:la versione SDK minima per tutti i pacchetti della libreria di supporto è almeno il livello API 14. Alcuni pacchetti richiedono un livello API superiore, come indicato di seguito.

Librerie di supporto v4

Queste librerie includono il più ampio insieme di API rispetto alle altre librerie, incluso il supporto per componenti dell'applicazione, funzionalità dell'interfaccia utente, accessibilità, gestione dei dati, connettività di rete e 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 API.

Nota:prima della revisione 24.2.0 della Support Library, esisteva una singola libreria di supporto v4. Questa 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 v4. Tuttavia, per ridurre le dimensioni dell'app, ti consigliamo di elencare solo i moduli specifici di cui ha bisogno.

Libreria di compatibilità v4

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

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

com.android.support:support-compat:28.0.0

libreria v4 core-utils

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

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

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

Libreria v4 core-ui

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

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

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

Libreria v4 media-compat

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

L'identificatore della 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 i fragment, consentendo alle applicazioni di fornire layout che si adattano ai dispositivi con schermi piccoli e grandi. Questo modulo dipende da compat, core-utils, core-ui e media-compat.

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

L'identificatore della 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 fornisce supporto per la creazione di app con più file Dalvik Executable (DEX). Le app che fanno riferimento a più di 65.536 metodi devono utilizzare configurazioni multidex. Per maggiori informazioni sull'utilizzo di multidex, consulta Creazione di app con oltre 64.000 metodi.

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

com.android.support:multidex:1.0.0

Librerie di supporto 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:la libreria appcompat è stata migrata nella libreria AndroidX, che è un componente di Android Jetpack. Guarda come viene utilizzato nell'app demo Sunflower.

Questa libreria aggiunge il supporto per il pattern di progettazione dell'interfaccia utente Action Bar. Questa libreria include il supporto per implementazioni dell'interfaccia utente Material Design.

Nota:Questa libreria dipende dalla libreria di supporto v4.

Ecco alcune delle classi principali incluse nella libreria appcompat v7:

  • ActionBar - Fornisce un'implementazione della barra delle azioni pattern dell'interfaccia utente. 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 supporto.
  • AppCompatDialog - Aggiunge una classe di dialogo che può essere utilizzata come classe base per i dialoghi con tema AppCompat.
  • ShareActionProvider - Aggiunge il supporto per un'azione di condivisione standardizzata (ad esempio email o pubblicazione su applicazioni social) che può essere inclusa in una barra delle azioni.

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

com.android.support:appcompat-v7:28.0.0

libreria v7 cardview

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

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

com.android.support:cardview-v7:28.0.0

Libreria v7 gridlayout

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

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

com.android.support:gridlayout-v7:28.0.0

v7 mediarouter library

Questa libreria fornisce MediaRouter, MediaRouteProvider e classi multimediali correlate che supportano Google Cast.

In generale, le API nella libreria mediarouter v7 forniscono un mezzo per controllare il routing di canali e stream multimediali dal dispositivo attuale a schermi, speaker e altri dispositivi di destinazione esterni. La libreria include API per la pubblicazione di provider di route multimediali specifici per le app, per la scoperta e la selezione di 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 nel riferimento API.

L'identificatore della 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 libreria solo in relazione a Google Cast.

Libreria di tavolozze V7

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

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

com.android.support:palette-v7:28.0.0

Libreria v7 recyclerview

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

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

com.android.support:recyclerview-v7:28.0.0

Libreria di supporto delle preferenze v7

Il pacchetto preference fornisce API per supportare l'aggiunta di oggetti delle preferenze, 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 classi come CheckBoxPreference e ListPreference.

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

com.android.support:preference-v7:28.0.0

Support Library v8

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

libreria renderscript 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 i passaggi per includere queste API nella tua applicazione sono molto diversi da quelli delle altre API della libreria di supporto. Per ulteriori informazioni sull'utilizzo di queste API nella tua applicazione, consulta la guida per gli sviluppatori di RenderScript.

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

Il seguente esempio mostra le proprietà dello script di build Gradle per questa libreria:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Support Library v13

Questa libreria aggiunge il supporto per il pattern dell'interfaccia utente Fragment con la classe (FragmentCompat) e classi di supporto aggiuntive per i fragment. Per saperne di più sui fragment, consulta la guida per gli sviluppatori Fragment. Per informazioni dettagliate sulle API della libreria di supporto v13, consulta il pacchetto android.support.v13 nel riferimento API.

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

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

com.android.support:support-v13:28.0.0

v14 Preference Support Library

Il pacchetto android.support.v14.preference fornisce API per aggiungere il supporto per interfacce delle preferenze come PreferenceFragment.OnPreferenceStartFragmentCallback e PreferenceFragment.OnPreferenceStartScreenCallback, insieme a classi come MultiSelectListPreference e PreferenceFragment. Per informazioni dettagliate sulle API della libreria di supporto delle preferenze v14, consulta il pacchetto preference nel riferimento API.

L'identificatore della 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 TV

Il pacchetto android.support.v17.preference fornisce API per fornire interfacce delle preferenze sui dispositivi TV, incluso il supporto per l'interfaccia e le classi LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener, come BaseLeanbackPreferenceFragment e LeanbackPreferenceFragment. Per informazioni dettagliate sulle API della libreria di supporto delle preferenze v17, consulta il pacchetto preference nel riferimento API.

Questo pacchetto richiede il livello API 17 o versioni successive. L'identificatore della 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. Fornisce 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 della dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:leanback-v17:28.0.0

Libreria di drawable vettoriali

Fornisce supporto per la grafica vettoriale statica.

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

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

Libreria di drawable vettoriali animati

Fornisce supporto per la grafica vettoriale animata.

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

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

Support Library per le annotazioni

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

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

com.android.support:support-annotations:28.0.0

Design Support Library

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

La libreria Design Support aggiunge il supporto per vari componenti e pattern di Material Design che gli sviluppatori di app possono utilizzare, ad esempio riquadri di navigazione, pulsanti di azione rapida (FAB), snackbar e schede.

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

com.android.support:design:28.0.0

Libreria di supporto delle schede personalizzate

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

La libreria Custom Tabs Support aggiunge il supporto per varie classi, ad esempio Custom Tabs Service e Custom Tabs Callback.

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

com.android.support:customtabs:28.0.0

Support Library per le percentuali

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

Nota:a partire dalla release 26.0.0, la libreria Percent Support è ritirata. I client di questo modulo devono eseguire la migrazione al nuovo widget ConstraintLayout, 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 della dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:percent:28.0.0

Support Library ExifInterface

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

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

com.android.support:exifinterface:28.0.0

Libreria di supporto per i consigli sulle app per la TV

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

La libreria App aggiunge il supporto per le annotazioni, ad esempio ContentRecommendation.ContentMaturity e varie classi, ad esempio ContentRecommendation e RecommendationExtender.

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

com.android.support:recommendation:28.0.0

libreria 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 supporto Wearable.

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

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

com.android.support:wear:28.0.0