Pacchetti della libreria di supporto

Nota:con il rilascio della Support Library 28.0.0, il file android.support-in dotazione librerie sono deprecate e sostituite da Jetpack con controllo individuale librerie pacchettizzate come androidx. Il file 1.0.0 iniziale delle librerie Jetpack garantisce la parità con la Support Library 28.0.0 e fornisce un punto di partenza per eseguire la migrazione al nuovo androidx pacchettizzazione.

Le librerie in pacchetto android.support esistenti continueranno a funzionare. ma non riceverà aggiornamenti oltre la versione 28.0.0 e non sarà compatibile con le nuove librerie Jetpack. Artefatti storici (con versioni 27 e precedenti, pacchettizzati come android.support) rimarranno disponibili su Google Maven. Tutti i nuovi elementi 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. Dovresti inoltre Valuta la possibilità di eseguire la migrazione dei progetti esistenti per assicurarti continuano a ricevere correzioni di bug e altri miglioramenti delle librerie.

Android Support Library contiene diversi pacchetti di libreria che è possibile includere nella tua applicazione. Ognuna di queste librerie supporta una gamma specifica di piattaforme Android le versioni e l'insieme di funzionalità disponibili.

Per utilizzare una qualsiasi delle seguenti librerie, devi scaricare i file libreria nel tuo Installazione dell'SDK Android. Segui le istruzioni per scaricare le librerie di assistenza in Configura Libreria di supporto per completa questo passaggio. Devi seguire ulteriori passaggi per includere una Libreria di assistenza specifica in la tua applicazione. Consulta la fine di ogni sezione della libreria qui sotto per informazioni importanti su come include la libreria nell'applicazione.

Nota: la versione minima dell'SDK per tutta l'assistenza di pacchetti di libreria è almeno il livello API 14. Alcuni pacchetti richiedono un'API superiore di sicurezza, come indicato di seguito.

Librerie di assistenza v4

Queste librerie includono il set di API più ampio rispetto alle altre librerie, tra cui il supporto per componenti dell'applicazione, funzionalità dell'interfaccia utente, accessibilità, gestione dei dati, connettività di rete e programmazione utilità.

Per informazioni complete e dettagliate sui corsi e sui metodi forniti da le librerie di supporto v4, consulta il pacchetto android.support.v4 nel riferimento API.

Nota: prima della revisione 24.2.0 di Support Library, era disponibile una singola libreria di supporto v4. La libreria è stata divisa in più moduli per migliorare l'efficienza. Per la compatibilità con le versioni precedenti, se elenchi support-v4 nel tuo script Gradle, la tua app includerà tutti i moduli v4. Tuttavia, per ridurre le dimensioni dell'app, ti consigliamo di elencare i moduli specifici di cui la tua app ha bisogno.

libreria compatibile v4

Fornisce wrapper 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 di 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 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

Parti con backport 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 adattano tra piccole e su dispositivi con schermi 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 versione 4 Fragment è un corso autonomo che fornisce correzioni di bug che sono state aggiunte nelle versioni successive della piattaforma, mentre v13 FragmentCompat disponibile nella classe shim di compatibilità per l'implementazione del framework Fragment corso.

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 le configurazioni multidex. Per Per ulteriori informazioni sull'uso di multidex, vedi 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 caratteristiche specifici e possono essere incluse nell'applicazione in modo indipendente l'uno dall'altro.

libreria appcompat v7 Parte di Android Jetpack.

Nota. È stata eseguita la migrazione della libreria appcompat in nella libreria AndroidX, che è una piattaforma Android Componente Jetpack. Guardalo in uso nel App demo Sunflower.

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

Nota: Questa libreria dipende dalla libreria di supporto v4.

Ecco alcune delle principali classi incluse nella libreria appcompat v7:

  • ActionBar: fornisce un'implementazione della barra delle azioni pattern dell'interfaccia utente. Per ulteriori informazioni informazioni sull'utilizzo della barra delle azioni, consulta Guida per gli sviluppatori sulla barra delle azioni.
  • AppCompatActivity: aggiunge una classe di attività dell'applicazione che può Può essere usata come classe base per le attività che usano la barra delle azioni di Support Library implementazione.
  • AppCompatDialog - Aggiunge una classe di dialogo che può essere utilizzata come base per finestre di dialogo a tema AppCompat.
  • ShareActionProvider: aggiunge il supporto per un modello standardizzato un'azione di condivisione (ad esempio, email o pubblicazione su applicazioni social) che può essere inclusa in un 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 CardView widget, che ti consente di mostrare informazioni all'interno di schede con un aspetto coerente su qualsiasi app. Queste schede sono utili per il material design e sono ampiamente utilizzati 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 Android Support Libraries, questa libreria aggiunge il supporto per GridLayout corso, che ti consente di disporre gli elementi dell'interfaccia utente utilizzando una griglia di celle rettangolari. Per informazioni dettagliate sulle API della libreria griglialayout v7, consulta la 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 raccolta fornisce MediaRouter, MediaRouteProvider e corsi di contenuti multimediali correlati che supportare Google Cast.

In generale, le API della libreria Mediarouter v7 forniscono un mezzo controllando il routing di canali multimediali e stream dal dispositivo corrente a schermi esterni, altoparlanti e altri dispositivi di destinazione. La raccolta include API per la pubblicazione di provider di percorsi multimediali specifici per le app, per il rilevamento e selezionare i dispositivi di destinazione, controllare lo stato dei contenuti multimediali e altro ancora. Per dettagli informazioni sulle API della libreria Mediarouter v7, consulta Pacchetto android.support.v7.media nell'API riferimento.

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

com.android.support:mediarouter-v7:28.0.0

API della libreria Mediarouter v7 introdotte nella libreria di supporto Le versioni r18 sono soggette a modifiche nelle revisioni successive della Libreria di supporto. In questo momento ti consigliamo di utilizzare la raccolta soltanto insieme a Google Cast.

Libreria tavolozza v7

La libreria di supporto della tavolozza V7 include Palette, che ti consente di estrarre colori più marcati da un'immagine. Ad esempio, un'app di musica potrebbe utilizzare una Palette oggetto per estrarre i colori principali dalla copertina di un album e usarli per creare un brano coordinato per colore intertitolo.

L'identificatore della 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 di riciclo aggiunge RecyclerView . Questo corso fornisce assistenza per: Vista riciclo una vista per mostrare in modo efficiente set di dati di grandi dimensioni fornendo un 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 preferenze v7

La preferenza fornisce API per supportare l'aggiunta di oggetti preferiti, come CheckBoxPreference e ListPreference, per agli utenti di modificare le impostazioni della UI.

La libreria Preference v7 aggiunge il supporto per le interfacce, Preference.OnPreferenceChangeListener e Preference.OnPreferenceClickListener e corsi, 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 in modo indipendente da altre librerie.

Libreria renderingscript v8

Questa libreria aggiunge supporto per il calcolo di RenderScript il modello di machine learning. Queste API sono incluse nel pacchetto android.support.v8.renderscript. Tu tieni presente che i passaggi per includere queste API nell'applicazione sono molto diverso da altre API delle librerie di supporto. Per ulteriori informazioni sull'uso di queste API nella tua applicazione, controlla RenderScript guida per gli sviluppatori.

Nota: l'utilizzo di RenderScript con la libreria di supporto è supportato su Android Build basate su Studio e Gradle. La La libreria renderscript 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 assistenza per il pattern dell'interfaccia utente Fragment con la classe (FragmentCompat) e un ulteriore supporto per i frammenti . Per ulteriori informazioni sui frammenti, consulta Guida per gli sviluppatori relativa ai frammenti. Per dettagli informazioni sulle API Support Library v13, consulta il pacchetto android.support.v13 nel riferimento API.

Nota: la libreria di frammenti v4 fornisce un corso Fragment. La versione 4 Fragment è un corso autonomo che fornisce correzioni di bug che sono state aggiunte nelle versioni successive della piattaforma, mentre v13 FragmentCompat disponibile nella classe shim di compatibilità per l'implementazione del framework Fragment corso.

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

Il pacchetto android.support.v14.preference fornisce le API per aggiungere supporto per interfacce delle preferenze come PreferenceFragment.OnPreferenceStartFragmentCallback e PreferenceFragment.OnPreferenceStartScreenCallback, insieme a corsi come MultiSelectListPreference e PreferenceFragment. Per dettagli informazioni sulle API Preference Support Library v14, consulta preferenza 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

v17 Libreria di supporto delle preferenze per la TV

Il pacchetto android.support.v17.preference fornisce API per fornire la preferenza per dispositivi TV, compreso il supporto per LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener dell'interfaccia utente e delle classi, BaseLeanbackPreferenceFragment e LeanbackPreferenceFragment. Per dettagli informazioni sulle API Preference Support Library v17, consulta preferenza nel riferimento API.

Questo pacchetto richiede il livello API 17 o superiore. Script di build Gradle l'identificatore delle dipendenze 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 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 superiore. Script di build Gradle l'identificatore delle dipendenze per questa libreria è il seguente:

com.android.support:leanback-v17:28.0.0

Libreria disegnabile vettoriale

Supporta la grafica vettoriale statica.

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

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

Libreria animata disegnabile vettoriale

Supporta le grafiche vettoriali animate.

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

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

Libreria di supporto delle annotazioni

La sezione Annotazione fornisce le API per supportare l'aggiunta di metadati di annotazione alle app.

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

com.android.support:support-annotations:28.0.0

Libreria di supporto al design

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

La libreria Supporto al design aggiunge supporto per vari componenti e pattern di material design per sviluppatori di app su cui creare, ad esempio riquadri di navigazione a scomparsa, pulsanti di azione fluttuanti (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 per le schede personalizzate

La Schede personalizzate fornisce le API per supportare l'aggiunta e la gestione di schede personalizzate nelle app.

La libreria di assistenza per le schede personalizzate aggiunge supporto per vari corsi, come Schede personalizzate Servizio e Schede personalizzate Callback.

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

com.android.support:customtabs:28.0.0

Libreria di supporto Percent

La Percentuale fornisce API per supportare l'aggiunta e la gestione di dati dimensioni 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 alla nuova versione di ConstraintLayout fornito come artefatto separato in SDK Manager.

La libreria Percent Support aggiunge il supporto per Interfaccia PercentLayoutHelper.PercentLayoutParams e in varie classi, Layout PercentFrame e PercentualerelativeLayout.

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 quali orientamento, data e ora, e la posizione direttamente in un file JPEG o RAW. La ExifInterface non raggruppa le informazioni EXIF in JPEG e grezzi (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW e RAF) e impostando le 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

Raccolta di assistenza dei suggerimenti relativi alle app per la TV

La App Consiglio fornisce API per supportare l'aggiunta di consigli di 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, come ContentRecommendations 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

Raccolta UI di Wear

Questa libreria include API per creare interfacce utente per le app Wear. Le API, disponibili nel pacchetto android.support.wear.widget, sostituire le API corrispondenti nella libreria di supporto Wearable.

Per ulteriori informazioni, vedi Viene utilizzata la raccolta UI di Wear.

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

com.android.support:wear:28.0.0