Pacchetti della libreria di supporto

Nota: con il rilascio della libreria di supporto 28.0.0, le librerie con pacchetti android.support vengono ritirate e sostituite da librerie Jetpack con versioni individuali pacchettizzate come 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 pacchettizzazione androidx.

Le librerie 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 elementi storici (con versione 27 e precedenti e pacchettizzati come android.support) rimarranno disponibili su Google Maven. Tutti i nuovi elementi 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 determinato insieme di funzionalità e versioni della piattaforma Android.

Per utilizzare una qualsiasi 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 assistenza in Configurazione delle librerie di assistenza. Devi eseguire ulteriori passaggi per includere una raccolta di supporto specifica nella tua applicazione. Vedi la fine di ogni sezione della libreria qui sotto per informazioni importanti su come includere la libreria nella tua applicazione.

Nota:la versione minima dell'SDK per tutti i pacchetti delle librerie 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 all'API.

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

libreria compatibile v4

Fornisce wrapper di compatibilità per varie API del 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 4

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 relativi 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

Esegui il backport di parti del framework media, tra cui 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 dell'incapsulamento dell'interfaccia utente e delle funzionalità con frammenti, consentendo alle applicazioni di fornire layout che si adattino ai dispositivi con schermi di piccole e grandi dimensioni. Questo modulo ha dipendenze 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 che fanno riferimento a più di 65536 metodi devono utilizzare configurazioni multidex. Per maggiori informazioni sull'utilizzo di multidex, consulta Creare app con più di 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 assistenza v7

Queste librerie forniscono set di funzionalità specifiche e possono essere incluse nella tua applicazione indipendentemente l'una dall'altra.

Libreria appcompat v7   Componente di Android Jetpack.

Nota:è stata eseguita la migrazione della libreria appcompat nella libreria AndroidX, che è un componente Android Jetpack. Guardalo in uso nell'app demo Sunflower.

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

Nota: questa libreria dipende dalla libreria di supporto v4.

Di seguito sono riportate alcune delle classi principali incluse nella libreria appcompat della versione 7:

  • ActionBar - Fornisce un'implementazione del pattern di interfaccia utente della barra di azioni. Per ulteriori informazioni sull'utilizzo della barra delle azioni, consulta la guida per gli sviluppatori sulla barra delle azioni.
  • AppCompatActivity: aggiunge una classe di attività dell'applicazione che può essere utilizzata come classe di base per le attività che utilizzano l'implementazione della barra di azioni della libreria di supporto.
  • AppCompatDialog: aggiunge una classe di dialogo che può essere utilizzata come base per le finestre di dialogo a 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 CardView v7

Questa libreria aggiunge il supporto per il widget CardView, che ti consente di mostrare informazioni all'interno di schede con un aspetto coerente su qualsiasi app. Queste schede sono utili per le implementazioni di material design e sono ampiamente utilizzate 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 layout griglia v7

Dopo aver scaricato le Android Support Library, questa libreria aggiunge il supporto per la classe GridLayout, che consente di organizzare gli elementi dell'interfaccia utente utilizzando una griglia di celle rettangolari. Per informazioni dettagliate sulle API della libreria di layout a griglia v7, consulta il android.support.v7.widget pacchetto nel riferimento all'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 7 forniscono un mezzo per controllare il routing di canali e stream multimediali dal dispositivo corrente a schermi esterni, altoparlanti e altri dispositivi di destinazione. La raccolta include API per la pubblicazione di fornitori di percorsi multimediali specifici per app, per rilevare e selezionare i dispositivi di destinazione, per controllare lo stato dei contenuti multimediali e altro ancora. Per informazioni dettagliate sulle API della libreria mediarouter 7, consulta il pacchetto android.support.v7.media nella documentazione dell'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 7 introdotte nella versione 18 della libreria di supporto sono soggette a modifiche nelle revisioni successive della libreria di supporto. Al momento, consigliamo di utilizzare la libreria solo in combinazione con Google Cast.

Libreria di tavolozze v7

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

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 supporta il widget RecyclerView, una visualizzazione che consente di visualizzare in modo efficiente set di dati di grandi dimensioni tramite 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 per le preferenze v7

Il pacchetto preference fornisce API per supportare l'aggiunta di oggetti preferenze, come CheckBoxPreference e ListPreference, per consentire agli utenti di modificare le impostazioni della UI.

La libreria Preference v7 aggiunge il supporto per interfacce, come Preference.OnPreferenceChangeListener e Preference.OnPreferenceClickListener, e per 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

Libreria di supporto v8

Questa libreria fornisce set di funzionalità specifici e può essere inclusa nella tua applicazione indipendente da 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 nell'applicazione sono molto diversi dalle altre API della libreria di assistenza. 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 le build di Android Studio e 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
}

Libreria di supporto v13

Questa libreria aggiunge il supporto per il pattern di interfaccia utente Fragment con la classe (FragmentCompat) e classi di supporto aggiuntive per i frammenti. Per ulteriori informazioni sui frammenti, consulta la Guida per gli sviluppatori su Fragments. Per informazioni dettagliate sulle API della libreria di supporto v13, consulta il pacchetto android.support.v13 nel riferimento all'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 della dipendenza dello script di build Gradle per questa libreria è il seguente:

com.android.support:support-v13:28.0.0

Libreria di supporto per le preferenze v14

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

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

com.android.support:preference-v14:28.0.0

v17 Libreria di supporto delle preferenze per la TV

Il pacchetto android.support.v17.preference fornisce API per fornire interfacce di 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 Preference Support Library 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 su 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 Drawable vettoriale

Fornisce il 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

Annotations Support Library

Il pacchetto Annotation fornisce API per supportare l'aggiunta di metadati delle annotazioni alle 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 di assistenza per il design aggiunge il supporto di vari componenti e pattern di Material Design su cui gli sviluppatori di app possono basarsi, ad esempio riquadri di navigazione, pulsanti di azione flottanti (FAB), barra delle app 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 di Custom Tabs

Il pacchetto Custom Tabs fornisce API per supportare l'aggiunta e la gestione delle schede personalizzate nelle tue app.

La libreria di assistenza per le schede personalizzate aggiunge supporto per varie classi, tra cui Servizio schede personalizzate e callback per le schede personalizzate.

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

Percent Support Library

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

Nota:a partire dalla versione 26.0.0, la libreria Percent Support è stata ritirata. I client di questo modulo devono eseguire la migrazione al nuovo widget ConstraintLayout, fornito come elemento 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

Libreria di supporto ExifInterface

I tag Exif memorizzano informazioni come l'orientamento, la data e l'ora, le informazioni sulla fotocamera e la posizione direttamente in un file JPEG o RAW. La classe ExifInterface separa il supporto per la lettura delle informazioni Exif dai file JPEG e RAW (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW e RAF) e 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 assistenza per i consigli di app per TV

Il pacchetto App Recommendations fornisce le API per supportare l'aggiunta di suggerimenti sui contenuti nella tua app in esecuzione sui dispositivi TV.

La libreria di app aggiunge il supporto per le annotazioni, ad esempio ContentRecommendation.ContentMaturity, e per varie classi, come 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 include API per creare interfacce utente per le app Wear. Le API, disponibili nel pacchetto android.support.wear.widget, sostituiscono le API corrispondenti nella libreria di supporto per i dispositivi indossabili.

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