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 inoltre di eseguire la migrazione dei progetti esistenti per assicurarti che continuino a ricevere correzioni di bug e altri miglioramenti delle librerie.

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 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. Consulta la fine di ogni sezione della libreria di seguito per informazioni importanti su come includerla 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 con la versione 4

Fornisce wrapper di compatibilità per una serie di API di 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

Eseguire 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 per l'incapsulamento dell'interfaccia utente e della funzionalità con fragment, consentendo alle applicazioni di fornire layout che si adattano ai dispositivi con schermo piccolo e grande. 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 il supporto per la creazione di app con più file eseguibili Dalvik (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 supporto 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: la libreria appcompat è stata migrata nella libreria AndroidX, che è un componente di 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 consente di mostrare informazioni all'interno di schede con un aspetto coerente su qualsiasi app. Queste schede sono utili per le implementazioni del 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 di layout a griglia v7

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 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 v7, consulta il pacchetto android.support.v7.media nel riferimento all'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 fornisce il supporto per il widget RecyclerView, una visualizzazione per la visualizzazione efficiente di 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 per le preferenze v7

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

La libreria Preference 7 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

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. Devi essere consapevole che i passaggi per includere queste API nella tua applicazione sono molto diversi da quelli di altre API di librerie 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/.

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

Libreria di supporto delle preferenze v17 per 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 della libreria di supporto delle preferenze v17, consulta il pacchetto preference nel riferimento all'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. Ecco alcuni dei corsi più importanti:

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 Design Support 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 di Custom Tabs aggiunge il supporto di vari tipi di classi, come 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

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 è deprecata. 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

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 Consigli per le app fornisce API per supportare l'aggiunta di consigli sui contenuti nella tua 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 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