Pacchetti della libreria di supporto

Nota: con il rilascio della Support Library 28.0.0, le librerie incluse nel pacchetto android.support 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 Support Library 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.

L'Android Support Library contiene diversi pacchetti di librerie che possono essere inclusi nella tua applicazione. Ognuna di queste librerie supporta una serie specifica 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 Support Library in Configurazione della libreria di supporto. Devi eseguire passaggi aggiuntivi per includere una Support Library 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.

Support Library 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 core-utils v4

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 core-ui v4

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 media-compat v4

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 fragment v4

Aggiunge il supporto per l'incapsulamento dell'interfaccia utente e delle funzionalità con i frammenti, 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 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 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 con riferimenti 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

Support Library v7

Queste librerie forniscono set di funzionalità specifici e possono essere incluse nella tua 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 della barra delle azioni. Questa libreria include il supporto per implementazioni dell'interfaccia utente di Material Design.

Nota: Questa libreria dipende dalla Support Library v4.

Ecco alcune delle classi principali incluse nella libreria 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 Support Library.
  • AppCompatDialog - Aggiunge una classe di dialogo che può essere utilizzata come classe di base per i dialoghi con tema AppCompat.
  • ShareActionProvider - Aggiunge il supporto per un'azione di condivisione standardizzata (ad esempio email o post 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 cardview v7

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 gridlayout v7

Dopo aver scaricato le Android Support Library, 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

Libreria mediarouter v7

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 media e stream 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 Support Library r18 sono soggette a modifiche nelle revisioni successive della Support Library. Al momento consigliamo di utilizzare la libreria solo in relazione a Google Cast.

Libreria palette v7

La Support Library palette 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 recyclerview v7

La libreria recyclerview aggiunge la classe RecyclerView. Questa classe fornisce supporto per il widget RecyclerView, una soluzione 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

Support Library Preference 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 Preference 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 dalle altre API della libreria di supporto. Per saperne di più 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/.

L'esempio seguente 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 frammenti. Per saperne di più sui frammenti, consulta la guida per gli sviluppatori Fragment. Per informazioni dettagliate sulle API della Support Library v13, consulta il pacchetto android.support.v13 nel Riferimento API.

Nota: la libreria fragment 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 della dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-v13:28.0.0

Support Library Preference v14

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

Support Library Preference 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 LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener e le classi, come BaseLeanbackPreferenceFragment e LeanbackPreferenceFragment. Per informazioni dettagliate sulle API della Support Library Preference 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 il 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 Annotazione 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

Support Library Design

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

La Support Library Design aggiunge il supporto per vari componenti e pattern di Material Design che gli sviluppatori di app possono utilizzare, ad esempio riquadri di navigazione a scomparsa, Floating Action Button (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

Support Library Custom Tabs

Il pacchetto Custom Tabs 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 Percent

Il pacchetto Percent fornisce API per supportare l'aggiunta e la gestione di dimensioni basate su percentuali 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

Support Library App Recommendation per la TV

Il pacchetto App Recommendation 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 Support Library Wearable.

Per ulteriori informazioni, consulta la sezione Utilizza 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