Libreria di supporto

Nota: con il rilascio di Android 9.0 (livello API 28) è disponibile una nuova versione della libreria di supporto AndroidX, che fa parte di Jetpack. La libreria AndroidX contiene la libreria di supporto esistente e include anche i componenti Jetpack più recenti.

Puoi continuare a utilizzare la libreria di assistenza. Gli artefatti storici (con versioni 27 e precedenti e pacchettizzati come android.support.*) rimarranno disponibili su Google Maven. Tuttavia, tutti i nuovi sviluppi nelle biblioteche verrà eseguita nella libreria AndroidX.

Ti consigliamo di utilizzare le librerie AndroidX in tutti i nuovi progetti. Dovresti inoltre prendere in considerazione eseguendo la migrazione ad AndroidX di progetti esistenti.

Quando sviluppi app che supportano più versioni dell'API, potresti volere un standard per fornire funzionalità più recenti nelle versioni precedenti di Android o utilizzare in modo controllato la funzionalità equivalente. Invece di edilizia per gestire le versioni precedenti della piattaforma, puoi sfruttare queste librerie per fornire questo livello di compatibilità. Inoltre, le librerie di assistenza offrire ulteriori classi di convenienza e funzionalità non disponibili in l'API Framework standard per semplificare lo sviluppo e il supporto in più dispositivi mobili.

In origine un'unica libreria binaria per le app, Android Support Library ha in una suite di librerie per lo sviluppo di app. Molti di questi le librerie sono ora vivamente consigliate, se non essenziali, parte dell'app sviluppo del prodotto.

Questo documento fornisce una panoramica della libreria di assistenza per aiutarti ne comprendi i componenti e come usarli efficacemente nella tua app.

Attenzione:a partire dalla release 26.0.0 di Support Library (luglio 2017), il livello API minimo supportato nella maggior parte delle librerie di supporto è ora disponibile ad Android 4.0 (livello API 14) per la maggior parte dei pacchetti di librerie. Per Per ulteriori informazioni, consulta la sezione Supporto della versione e Nomi in questa pagina.

Utilizzi delle librerie di assistenza

Esistono alcuni utilizzi distinti per le librerie di supporto. Indietro le classi di compatibilità per le versioni precedenti della piattaforma è solo uno dei che li rappresentano. Ecco un elenco più completo di modi in cui puoi utilizzare le librerie di supporto nella tua app:

• Compatibilità con le versioni precedenti per le API più recenti. Una grande quantità le librerie di supporto offrono la compatibilità con le versioni precedenti dei framework più recenti e metodi. Ad esempio, Fragment support class fornisce assistenza per i frammenti sui dispositivi che eseguono versioni precedenti ad Android 3.0 (livello API 11).
• Classi di convenienza e helper: le librerie di supporto forniscono un diverse classi helper, in particolare per lo sviluppo dell'interfaccia utente. Per Ad esempio, la classe RecyclerView fornisce un utente widget dell'interfaccia per visualizzare e gestire elenchi molto lunghi, utilizzabili su di Android a partire dal livello API 7 o versioni successive.
• Debug e utilità: sono disponibili diverse funzionalità che forniscono utilità al di là del codice incorporato nella tua app, ad esempio support-annotations libreria per migliorare i controlli del lint del codice sugli input dei metodi e supporto Multidex per per configurare e distribuire app con più di 65.536 metodi.

Utilizzo delle API Support e Framework

Le librerie di supporto forniscono classi e metodi molto simili alle API il framework Android. Dopo averlo scoperto, potresti chiederti se sia il caso usa la versione framework dell'API o l'equivalente della libreria di supporto. Qui sono le linee guida per l'utilizzo dei corsi della libreria di supporto delle API del framework:

• Compatibilità per funzionalità specifiche: se vuoi supportare una recente funzionalità della piattaforma su dispositivi su cui sono installate versioni precedenti del di Google Cloud, utilizza le classi e i metodi equivalenti della libreria di supporto.
• Compatibilità per le funzionalità di Raccolta correlate - Più sofisticate le classi della libreria di supporto possono dipendere da uno o più tipi di supporto aggiuntivi libreria di supporto, quindi dovresti usare classi di supporto per delle dipendenze. Ad esempio, ViewPager la classe di assistenza deve essere utilizzata con le classi di assistenza FragmentPagerAdapter o FragmentStatePagerAdapter.
• Compatibilità generale del dispositivo: se non disponi di una compatibilità specifica funzionalità della piattaforma che intendi utilizzare con la tua app in modo compatibile con le versioni precedenti è comunque una buona idea usare i corsi della libreria di supporto nella tua app. Ad esempio, puoi utilizzare ActivityCompat al posto della classe del framework Activity, in modo da poter sfruttare le funzionalità più recenti in seguito, ad esempio incorporando il nuovo modello di autorizzazioni introdotto Android 6.0 (livello API 23).

Classi di libreria di supporto che forniscono un'implementazione compatibile della piattaforma Le classi API potrebbero non essere in grado di fornire il set completo di funzionalità disponibile nell'ultima release, a causa delle limitazioni del dispositivo host completamente gestita. In questi casi, i corsi della Libreria di supporto sono progettati per ridurre in modo controllato la qualità e non fornire tutte le funzionalità o tutti i dati l'attuale API della piattaforma. Per questo motivo, dovresti esaminare il riferimento documentazione per le classi e i metodi delle librerie che utilizzi e una su dispositivi che utilizzano la prima versione della piattaforma supportata da la tua app.

Nota: le librerie di supporto non forniscono equivalenti classi e metodi per ogni API framework. In alcuni casi, può essere necessario aggrega una chiamata al metodo del framework con un controllo esplicito della versione dell'SDK e fornisci un codice alternativo per gestire metodi non disponibili su un dispositivo. Per ulteriori informazioni informazioni sull'utilizzo dei controlli della versione nel codice, consulta Supportare Versioni della piattaforma.

Supporto delle versioni e nomi dei pacchetti

Alcuni pacchetti della libreria di supporto hanno nomi di pacchetto che indicano la minimo dell'API che supportavano inizialmente, utilizzando una notazione v#, come support-v4. A partire dalla versione 26.0.0 di Support Library (rilasciata in luglio 2017), il livello API minimo supportato è stato aggiornato ad Android 4.0 (API livello 14) per tutti i pacchetti delle librerie di supporto. Per questo motivo, quando si lavora recente della libreria di supporto, non devi dare per scontato che la notazione del pacchetto v# indica un livello minimo di supporto API. Questa modifica nelle versioni recenti indica anche che i pacchetti di libreria con la versione 4 e v7 sono essenzialmente equivalenti nel livello minimo di API che supportano. Ad esempio, il pacchetto support-v4 e il pacchetto support-v7 supportano entrambi Livello API 14 per le release della libreria di supporto dalla 26.0.0 e successive.

Supporta le versioni delle release della libreria

Lo di release della Support Library, ad esempio 24.2.0 o 25.0.1, è diverso dal livello API minimo supportato da qualsiasi libreria release.Il numero della versione indica la versione della piattaforma API su cui è stata creata la base e, di conseguenza, quali potrebbero essere le API più recenti inclusi in questa versione delle librerie.

In particolare, la prima sezione del numero di versione della release, ad esempio il 24 nella versione 24.2.0, generalmente corrisponde alla versione del l'API Platform disponibile al momento del rilascio. Il livello della versione support Library indica che incorpora alcune funzionalità dell'API in questione livello di sicurezza, ma non devi dare per scontato che offra compatibilità con tutti rilasciate nella nuova versione API della piattaforma.

Dipendenze libreria

La maggior parte delle librerie nella suite Android Support Library presenta una certa dipendenza una o più librerie. Ad esempio, quasi tutte le librerie di supporto hanno un dal pacchetto support-compat. In generale, non devi preoccuparsi di supportare le dipendenze della libreria, poiché la build gestisce le dipendenze della libreria per te, includendo automaticamente librerie dipendenti.

Se vuoi vedere quali librerie e dipendenze di libreria sono incluse esegui questo comando nella radice di build dello sviluppo dell'app per ottenere un report sulle dipendenze del progetto, Librerie di assistenza Android e altre librerie:

gradle -q dependencies your-app-project:dependencies

Per ulteriori informazioni sull'aggiunta di librerie di supporto al tuo sviluppo progetto con Gradle, consulta Assistenza Configurazione Raccolta. Per ulteriori informazioni sull'utilizzo di Gradle, vedi Configura La tua build.

Tieni presente che tutte le librerie di assistenza Android dipendono anche da un certo livello di base della piattaforma, per le release recenti, ossia Android 4.0 (livello API 14) oppure in alto.