Livello API: 19
Android 4.4 (KITKAT) è una nuova release della piattaforma Android che offre nuove funzionalità per utenti e sviluppatori di app. Questo documento fornisce un'introduzione alle nuove API più importanti.
In qualità di sviluppatore di app, devi scaricare l'immagine di sistema Android 4.4 e la piattaforma SDK da SDK Manager il prima possibile. Se non hai un dispositivo con Android 4.4 su cui testare la tua app, utilizza l'immagine di sistema di Android 4.4 per testare l'app sull'emulatore Android. Quindi, crea le tue app per la piattaforma Android 4.4 per iniziare a utilizzare le API più recenti.
Aggiorna il livello API target
Per ottimizzare meglio la tua app per i dispositivi con Android 4.4,
devi impostare targetSdkVersion su
"19", installarla su un'immagine di sistema Android 4.4,
testarla e poi pubblicare un aggiornamento con questa modifica.
Puoi utilizzare le API in Android 4.4 e supportare al contempo le versioni precedenti aggiungendo
al codice condizioni che controllano il livello API di sistema prima di eseguire
API non supportate dal tuo minSdkVersion.
Per scoprire di più su come mantenere la compatibilità con le versioni precedenti, leggi Supporto di diverse versioni della piattaforma.
Per saperne di più sul funzionamento dei livelli API, leggi Che cos'è il livello API?
Modifiche importanti al comportamento
Se hai già pubblicato un'app per Android, tieni presente che potrebbe essere interessata dalle modifiche apportate ad Android 4.4.
Se la tua app legge da unità di archiviazione esterne…
La tua app non può leggere i file condivisi nello spazio di archiviazione esterno quando viene eseguita su Android 4.4, a meno che non disponga dell'autorizzazione READ_EXTERNAL_STORAGE. In altre parole, i file all'interno della directory restituita da getExternalStoragePublicDirectory() non sono più accessibili senza l'autorizzazione. Tuttavia, se devi accedere solo alle directory specifiche dell'app, fornite da getExternalFilesDir(), non hai bisogno dell'autorizzazione READ_EXTERNAL_STORAGE.
Se la tua app utilizza WebView…
La tua app potrebbe comportarsi in modo diverso quando viene eseguita su Android 4.4, soprattutto quando aggiorni il valore targetSdkVersion dell'app a "19" o un valore superiore.
Il codice alla base della classe WebView e delle API correlate è stato aggiornato per basarsi su uno snapshot moderno del codice sorgente di Chromium. Ciò comporta una serie di miglioramenti per le prestazioni, il supporto di nuove funzionalità HTML5 e il supporto per il debug remoto dei contenuti di WebView. L'ambito di questo upgrade implica che, se la tua app utilizza WebView, il suo comportamento potrebbe essere influenzato in alcuni casi. Sebbene le modifiche al comportamento note siano documentate e influiscano sulla tua app principalmente solo quando aggiorni il valore targetSdkVersion dell'app impostandolo su "19" o su un valore superiore, il nuovo WebView funziona in "modalità non standard" per fornire alcune funzionalità legacy nelle app che hanno come target il livello API 18 e versioni precedenti. È possibile che la tua app dipenda da comportamenti sconosciuti della versione precedente di WebView.
Quindi, se la tua app esistente utilizza WebView, è importante che tu esegua i test su Android 4.4 il prima possibile e consulti la pagina Migrazione a WebView in Android 4.4 per informazioni su come la tua app potrebbe essere interessata quando aggiorni targetSdkVersion a "19" o versioni successive.
Se la tua app utilizza AlarmManager…
Quando imposti targetSdkVersion della tua app su "19" o un valore superiore, le sveglie che crei utilizzando set() o setRepeating() non saranno esatte.
Per migliorare l'efficienza energetica, Android ora raggruppa le sveglie di tutte le app che si verificano in orari ragionevolmente simili, in modo che il sistema attivi il dispositivo una sola volta anziché più volte per gestire ogni sveglia.
Se la sveglia non è associata a un'ora esatta, ma è comunque importante che venga attivata durante un intervallo di tempo specifico (ad esempio tra le 14:00 e le 16:00), puoi utilizzare il nuovo metodo setWindow(), che accetta un'ora "più presto" per la sveglia e una "finestra" di tempo successiva all'ora più presto entro la quale il sistema deve attivare la sveglia.
Se la sveglia deve essere impostata su un'ora esatta (ad esempio per un promemoria di un evento nel calendario), puoi utilizzare il nuovo metodo setExact().
Questo comportamento di raggruppamento non esatto si applica solo alle app aggiornate. Se hai impostato targetSdkVersion su "18" o un valore inferiore, le sveglie continueranno a comportarsi come nelle versioni precedenti quando vengono eseguite su Android 4.4.
Se la tua app sincronizza i dati utilizzando ContentResolver…
Quando imposti targetSdkVersion della tua app su "19" o un valore superiore, la creazione di una sincronizzazione con addPeriodicSync() eseguirà le operazioni di sincronizzazione entro un intervallo flessibile predefinito di circa il 4% del periodo specificato. Ad esempio, se la frequenza di polling è di 24 ore, l'operazione di sincronizzazione potrebbe avvenire entro un intervallo di tempo di circa un'ora ogni giorno, anziché esattamente alla stessa ora ogni giorno.
Per specificare un intervallo flessibile personalizzato per le operazioni di sincronizzazione, devi iniziare a utilizzare il nuovo metodo requestSync(). Per maggiori dettagli, consulta la sezione di seguito sugli adattatori di sincronizzazione.
Questo comportamento dell'intervallo flessibile si applica solo alle app aggiornate. Se hai impostato targetSdkVersion su "18" o un valore inferiore, le richieste di sincronizzazione esistenti continueranno a comportarsi come nelle versioni precedenti quando vengono eseguite su Android 4.4.
Framework di stampa
Android ora include un framework completo che consente agli utenti di stampare qualsiasi documento utilizzando una stampante connessa tramite Wi-Fi, Bluetooth o altri servizi. Il sistema gestisce la transazione tra un'app che vuole stampare un documento e i servizi che inviano i processi di stampa a una stampante. Il framework android.print fornisce tutte le API necessarie per specificare un documento di stampa e inviarlo al sistema per la stampa. Le API effettivamente necessarie per un determinato job di stampa dipendono dai contenuti.
Stampa di contenuti generici
Se vuoi stampare i contenuti della tua UI come documento, devi prima creare una sottoclasse di PrintDocumentAdapter. All'interno di questa classe, devi implementare alcuni metodi di callback, tra cui onLayout() per stabilire il layout in base alle proprietà di stampa fornite e onWrite() per serializzare i contenuti stampabili in un ParcelFileDescriptor.
Per scrivere i tuoi contenuti nel ParcelFileDescriptor, devi trasmettere un PDF. Le nuove API PdfDocument offrono un modo pratico per farlo fornendo un Canvas da getCanvas(), su cui puoi disegnare i contenuti stampabili. Poi scrivi il PdfDocument nel ParcelFileDescriptor utilizzando il metodo writeTo().
Una volta definita l'implementazione per PrintDocumentAdapter, puoi eseguire i job di stampa su richiesta dell'utente utilizzando il metodo PrintManager, print(), che accetta PrintDocumentAdapter come uno dei suoi argomenti.
Stampa di immagini
Se vuoi stampare solo una foto o un'altra bitmap, le API helper nella libreria di supporto fanno tutto il lavoro per te. Basta creare una nuova istanza di PrintHelper, impostare la modalità di scalabilità con setScaleMode(), quindi passare Bitmap a printBitmap(). È tutto. La libreria gestisce tutte le interazioni rimanenti con il sistema per inviare la bitmap alla stampante.
Creazione di servizi di stampa
In qualità di OEM di stampanti, puoi utilizzare il framework android.printservice per fornire l'interoperabilità con le tue stampanti dai dispositivi Android. Puoi creare e distribuire servizi di stampa come APK, che gli utenti possono installare sui propri dispositivi . Un'app di servizio di stampa funziona principalmente come servizio headless creando una sottoclasse della classe PrintService, che riceve i job di stampa dal sistema e li comunica alle stampanti utilizzando i protocolli appropriati.
Per saperne di più su come stampare i contenuti dell'app, leggi Stampa di contenuti.
Provider SMS
Il provider di contenuti Telephony (il "provider di SMS") consente alle app di leggere e scrivere SMS e MMS sul dispositivo. Include tabelle per i messaggi SMS e MMS ricevuti, in bozza, inviati, in attesa e altro ancora.
A partire da Android 4.4, le impostazioni di sistema consentono agli utenti di selezionare un'"app per SMS predefinita". Una volta selezionata, solo l'app per SMS predefinita può scrivere nel provider di SMS e solo l'app per SMS predefinita riceve la trasmissione SMS_DELIVER_ACTION quando l'utente riceve un SMS o la trasmissione WAP_PUSH_DELIVER_ACTION quando l'utente riceve un MMS. L'app per SMS predefinita è responsabile della scrittura dei dettagli nel provider di SMS quando riceve o invia un nuovo messaggio.
Le altre app che non sono selezionate come app per SMS predefinita possono solo leggere il provider di SMS, ma possono anche ricevere una notifica quando arriva un nuovo SMS ascoltando la trasmissione SMS_RECEIVED_ACTION, che è una trasmissione non annullabile che può essere inviata a più app. Questa trasmissione è destinata alle app che, pur non essendo selezionate come app per SMS predefinita, devono leggere messaggi in arrivo speciali, ad esempio per eseguire la verifica del numero di telefono.
Per ulteriori informazioni, leggi il post del blog Preparazione delle app per SMS per KitKat.
Wireless e connettività
Host Card Emulation
Le app per Android ora possono emulare le schede NFC ISO14443-4 (ISO-DEP) che utilizzano APDU per lo scambio di dati (come specificato in ISO7816-4). In questo modo, un dispositivo con tecnologia NFC con Android 4.4 può emulare più carte NFC contemporaneamente e un terminale di pagamento NFC o un altro lettore NFC può avviare una transazione con la carta NFC appropriata in base all'identificatore dell'applicazione (AID).
Se vuoi emulare una carta NFC che utilizza questi protocolli nella tua app, crea un componente di servizio basato sulla classe HostApduService. Se invece la tua app utilizza un Secure Element per l'emulazione della carta, devi creare un servizio basato sulla classe OffHostApduService, che non sarà direttamente coinvolto nelle transazioni, ma è necessario per registrare gli AID che devono essere gestiti dal Secure Element.
Per saperne di più, consulta la guida Emulazione della carta NFC.
Modalità lettore NFC
Una nuova modalità Lettura NFC consente a un'attività di limitare tutte le attività NFC alla sola lettura dei tipi di tag di interesse dell'attività mentre è in primo piano. Puoi attivare la modalità Lettura per la tua attività con enableReaderMode(), fornendo un'implementazione di NfcAdapter.ReaderCallback che riceve un callback quando vengono rilevati nuovi tag.
Questa nuova funzionalità, insieme alla tecnologia Host Card Emulation, consente ad Android di operare su entrambe le estremità di un'interfaccia di pagamento mobile: un dispositivo funge da terminale di pagamento (un dispositivo che esegue un'attività in modalità di lettura) e un altro dispositivo funge da client di pagamento (un dispositivo che emula una carta NFC).
Trasmettitori a infrarossi
Se l'app viene eseguita su un dispositivo che include un trasmettitore a infrarossi (IR), ora puoi trasmettere segnali IR utilizzando le API ConsumerIrManager. Per ottenere un'istanza di ConsumerIrManager, chiama getSystemService() con CONSUMER_IR_SERVICE come argomento. Puoi quindi eseguire query sulle frequenze IR supportate dal dispositivo con getCarrierFrequencies() e trasmettere i segnali passando la frequenza che preferisci e il pattern di segnale con transmit().
Devi sempre verificare prima se un dispositivo include un trasmettitore IR chiamando hasIrEmitter(), ma se la tua app è compatibile solo con i dispositivi che ne hanno uno, devi includere un elemento <uses-feature> nel manifest per "android.hardware.consumerir" (FEATURE_CONSUMER_IR).
Multimediali
Riproduzione adattiva
Il supporto per la riproduzione video adattiva è ora disponibile con le API MediaCodec, consentendo una modifica fluida della risoluzione durante la riproduzione su un Surface: puoi fornire al decodificatore i frame di input di una nuova risoluzione e la risoluzione dei buffer di output cambia senza un divario significativo.
Puoi attivare la riproduzione adattiva aggiungendo due chiavi a MediaFormat che specificano la risoluzione massima richiesta dalla tua app dal codec: KEY_MAX_WIDTH e KEY_MAX_HEIGHT. Dopo aver aggiunto questi elementi a MediaFormat, passa MediaFormat alla tua istanza MediaCodec con configure().
Il codec passerà da una risoluzione all'altra, che saranno uguali o inferiori a questi valori, in modo fluido. Il codec potrebbe anche supportare risoluzioni superiori ai valori massimi specificati (purché rientrino nei limiti dei profili supportati), ma le transizioni a risoluzioni superiori potrebbero non essere fluide.
Per modificare la risoluzione durante la decodifica di video H.264, continua a mettere in coda i frame utilizzando MediaCodec.queueInputBuffer(), ma assicurati di fornire i nuovi valori Sequence Parameter Set (SPS) e Picture Parameter Set (PPS) insieme al frame Instantaneous Decoder Refresh (IDR) in un unico buffer.
Tuttavia, prima di tentare di configurare il codec per la riproduzione adattiva, devi verificare che il dispositivo supporti la riproduzione adattiva chiamando isFeatureSupported(String) con FEATURE_AdaptivePlayback.
Nota: il supporto della riproduzione adattiva è specifico del fornitore. Alcuni codec potrebbero richiedere più memoria per suggerimenti di risoluzione più elevati. Pertanto, devi impostare i valori massimi di risoluzione in base al materiale di origine che stai decodificando.
Timestamp audio on demand
Per facilitare la sincronizzazione audio-video, la nuova classe AudioTimestamp fornisce dettagli sulla cronologia di un "frame" specifico in uno stream audio gestito da AudioTrack. Per ottenere il timestamp più recente disponibile, crea un'istanza di un oggetto AudioTimestamp e passalo a getTimestamp(). Se la richiesta del timestamp ha esito positivo, l'istanza AudioTrack viene compilata con una posizione in unità di frame, insieme al tempo stimato in cui il frame è stato presentato o è stato eseguito il commit per la presentazione.
Puoi utilizzare il valore di nanoTime in AudioTimestamp (che è monotonico) per trovare il fotogramma video associato più vicino rispetto a framePosition, in modo da poter eliminare, duplicare o interpolare i fotogrammi video in modo che corrispondano all'audio. In alternativa, puoi determinare il delta time tra il valore di nanoTime e il tempo previsto di un fotogramma video futuro (tenendo conto della frequenza di campionamento) per prevedere quale fotogramma audio è previsto nello stesso momento di un fotogramma video.
Lettore di immagini della superficie
La nuova API ImageReader ti offre l'accesso diretto ai buffer di immagini durante il rendering in un Surface. Puoi acquisire un ImageReader con il metodo statico newInstance(). Poi chiama getSurface() per creare un nuovo Surface e invia i dati delle immagini con un producer come MediaPlayer o MediaCodec. Per ricevere una notifica quando sono disponibili nuove immagini dalla superficie, implementa l'interfaccia ImageReader.OnImageAvailableListener e registrala con setOnImageAvailableListener().
Ora, quando disegni contenuti nel tuo Surface, il tuo ImageReader.OnImageAvailableListener riceve una chiamata a onImageAvailable() man mano che ogni nuovo frame dell'immagine diventa disponibile, fornendoti il ImageReader corrispondente. Puoi utilizzare ImageReader per acquisire i dati dell'immagine del frame come oggetto Image chiamando acquireLatestImage() o acquireNextImage().
L'oggetto Image fornisce l'accesso diretto al timestamp, al formato, alle dimensioni e ai dati dei pixel dell'immagine in un ByteBuffer. Tuttavia, affinché la classe Image interpreti le tue immagini, queste devono essere formattate in base a uno dei tipi definiti dalle costanti in ImageFormat o PixelFormat.
Misurazione di picco e RMS
Ora puoi eseguire query sul picco e sull'RMS dello stream audio corrente da Visualizer creando una nuova istanza di Visualizer.MeasurementPeakRms e passandola a getMeasurementPeakRms(). Quando chiami questo metodo, i valori di picco e RMS del Visualizer.MeasurementPeakRms specificato vengono impostati sugli ultimi valori misurati.
Amplificatore di volume
LoudnessEnhancer è una nuova sottoclasse di AudioEffect che ti consente di aumentare il volume udibile di MediaPlayer o AudioTrack. Questo può essere particolarmente utile in combinazione con il nuovo metodo getMeasurementPeakRms() menzionato in precedenza, per aumentare il volume delle tracce audio parlate mentre sono in riproduzione altri contenuti multimediali.
Telecomandi
Android 4.0 (livello API 14) ha introdotto le API RemoteControlClient che consentono alle app multimediali di utilizzare gli eventi del controller multimediale da client remoti, come i controlli multimediali nella schermata di blocco. Ora le nuove API RemoteController ti consentono di creare il tuo telecomando, permettendoti di sviluppare nuove app e periferiche innovative in grado di controllare la riproduzione di qualsiasi app multimediale che si integra con RemoteControlClient.
Per creare un telecomando, puoi implementare l'interfaccia utente come preferisci, ma per inviare gli eventi dei pulsanti multimediali all'app multimediale dell'utente devi creare un servizio che estenda la classe NotificationListenerService e implementi l'interfaccia RemoteController.OnClientUpdateListener. È importante utilizzare NotificationListenerService come base perché fornisce le limitazioni della privacy appropriate, che richiedono agli utenti di attivare la tua app come listener di notifiche nelle impostazioni di sicurezza del sistema.
La classe NotificationListenerService include un paio di metodi astratti che devi implementare, ma se ti interessano solo gli eventi del controller multimediale per la gestione della riproduzione di contenuti multimediali, puoi lasciare vuota l'implementazione e concentrarti invece sui metodi RemoteController.OnClientUpdateListener.
Valutazioni dei telecomandi
Android 4.4 si basa sulle funzionalità esistenti per i client di controllo remoto (app che ricevono eventi di controllo multimediale con RemoteControlClient) aggiungendo la possibilità per gli utenti di valutare la traccia corrente dal telecomando.
La nuova classe Rating incapsula le informazioni sulla valutazione degli utenti. Una classificazione è definita dal suo stile (RATING_HEART, RATING_THUMB_UP_DOWN, RATING_3_STARS, RATING_4_STARS, RATING_5_STARS o RATING_PERCENTAGE) e dal valore di classificazione appropriato per quello stile.
Per consentire agli utenti di valutare le tue tracce da un telecomando:
- Segnala che vuoi mostrare la UI di valutazione all'utente (se applicabile) aggiungendo il flag
FLAG_KEY_MEDIA_RATINGinsetTransportControlFlags(). - Chiama
editMetadata()per recuperare unRemoteControlClient.MetadataEditore passalo aRATING_KEY_BY_USERconaddEditableKey(). - Poi specifica lo stile di valutazione chiamando
putObject()e passandoRATING_KEY_BY_USERcome chiave e uno degli stili di valutazione precedenti come valore.
Per ricevere un callback quando l'utente modifica la valutazione dal telecomando, implementa la nuova interfaccia RemoteControlClient.OnMetadataUpdateListener e passa un'istanza a setMetadataUpdateListener(). Quando l'utente modifica la valutazione, il tuo RemoteControlClient.OnMetadataUpdateListener riceve una chiamata a onMetadataUpdate(), passando RATING_KEY_BY_USER come chiave e un oggetto Rating come valore.
Sottotitoli codificati
VideoView ora supporta le tracce dei sottotitoli WebVTT durante la riproduzione di video HTTP Live Stream (HLS), mostrando la traccia dei sottotitoli in base alle preferenze dei sottotitoli codificati definite dall'utente nelle impostazioni di sistema.
Puoi anche fornire a VideoView le tue tracce dei sottotitoli WebVTT utilizzando il metodo addSubtitleSource(). Questo metodo accetta un InputStream che contiene i dati dei sottotitoli e un oggetto MediaFormat che specifica il formato dei dati dei sottotitoli, che puoi specificare utilizzando createSubtitleFormat(). Questi sottotitoli vengono visualizzati anche sul video in base alle preferenze dell'utente.
Se non utilizzi VideoView per visualizzare i tuoi contenuti video, devi fare in modo che l'overlay dei sottotitoli corrisponda il più possibile alla preferenza dell'utente per i sottotitoli codificati. Una nuova API CaptioningManager ti consente di eseguire query sulle preferenze di sottotitolaggio codificato dell'utente, inclusi gli stili definiti da CaptioningManager.CaptionStyle, come il carattere tipografico e il colore. Se l'utente modifica alcune preferenze dopo l'avvio del video, devi ascoltare le modifiche alle preferenze registrando un'istanza di CaptioningManager.CaptioningChangeListener per ricevere un callback quando una delle preferenze cambia, quindi aggiornare i sottotitoli in base alle necessità.
Animazione e grafica
Scene e transizioni
Il nuovo framework android.transition fornisce API che facilitano le animazioni tra i diversi stati dell'interfaccia utente. Una funzionalità chiave è la possibilità di definire stati distinti della UI, noti come "scene", creando un layout separato per ciascuno. Quando vuoi animare da una scena all'altra, esegui una "transizione", che calcola l'animazione necessaria per cambiare il layout dalla scena corrente a quella successiva.
Per passare da una scena all'altra, in genere devi eseguire le seguenti operazioni:
- Specifica il
ViewGroupcontenente i componenti della UI che vuoi modificare. - Specifica il layout che rappresenta il risultato finale della modifica (la scena successiva).
- Specifica il tipo di transizione che deve animare la modifica del layout.
- Esegui la transizione.
Puoi utilizzare un oggetto Scene per completare i passaggi 1 e 2. Un Scene contiene i metadati che descrivono le proprietà di un layout necessarie per eseguire una transizione, tra cui la vista genitore della scena e il layout della scena. Puoi creare un Scene utilizzando un costruttore di classi o il metodo statico getSceneForLayout().
Devi quindi utilizzare TransitionManager per completare i passaggi 3 e 4. Un modo è passare il tuo Scene al metodo statico go(). In questo modo, viene trovata la vista principale della scena nel layout corrente ed eseguita una transizione sulle viste secondarie per raggiungere il layout definito da Scene.
In alternativa, non è necessario creare un oggetto Scene, ma puoi chiamare beginDelayedTransition(), specificando un ViewGroup che contiene le visualizzazioni che vuoi modificare. Poi aggiungi, rimuovi o riconfigura le viste di destinazione. Dopo che il sistema ha disposto le modifiche necessarie, una transizione inizia ad animare tutte le visualizzazioni interessate.
Per un maggiore controllo, puoi definire insiemi di transizioni che devono verificarsi tra scene predefinite utilizzando un file XML nella directory res/transition/ del progetto. All'interno di un elemento <transitionManager>, specifica uno o più tag <transition> che indicano ciascuno una scena (un riferimento a un file di layout) e la transizione da applicare quando si entra e/o si esce da quella scena. Poi, espandi questo insieme di transizioni utilizzando inflateTransitionManager(). Utilizza l'oggetto TransitionManager restituito per eseguire ogni transizione con transitionTo(), passando un oggetto Scene rappresentato da uno dei tag <transition>. Puoi anche definire insiemi di transizioni in modo programmatico con le API TransitionManager.
Quando specifichi una transizione, puoi utilizzare diversi tipi predefiniti definiti dalle sottoclassi di Transition, come Fade e ChangeBounds. Se non specifichi un tipo di transizione, il sistema utilizza AutoTransition per impostazione predefinita, che applica automaticamente la dissolvenza, lo spostamento e il ridimensionamento delle visualizzazioni in base alle necessità. Inoltre, puoi creare transizioni personalizzate estendendo una di queste classi per eseguire le animazioni come preferisci. Una transizione personalizzata può monitorare qualsiasi modifica alle proprietà e creare qualsiasi animazione in base a queste modifiche. Ad esempio, puoi fornire una sottoclasse di Transition che ascolta le modifiche alla proprietà "rotation" di una visualizzazione e poi anima le modifiche.
Per saperne di più, consulta la documentazione di TransitionManager.
Messa in pausa dell'animatore
Le API Animator ora consentono di mettere in pausa e riprendere un'animazione in corso con i metodi pause() e resume().
Per monitorare lo stato di un'animazione, puoi implementare l'interfaccia Animator.AnimatorPauseListener, che fornisce callback quando un'animazione viene messa in pausa e ripresa: pause() e resume(). Poi aggiungi il listener a un oggetto Animator con addPauseListener().
In alternativa, puoi creare una sottoclasse della classe astratta AnimatorListenerAdapter, che ora include implementazioni vuote per i callback di pausa e ripresa definiti da Animator.AnimatorPauseListener.
Bitmap riutilizzabili
Ora puoi riutilizzare qualsiasi bitmap modificabile in BitmapFactory per decodificare qualsiasi altra bitmap, anche quando la nuova bitmap ha dimensioni diverse, purché il conteggio dei byte risultante della bitmap decodificata (disponibile da getByteCount()) sia inferiore o uguale al conteggio dei byte allocati della bitmap riutilizzata (disponibile da getAllocationByteCount()). Per saperne di più, consulta inBitmap.
Le nuove API per Bitmap consentono una riconfigurazione simile per il riutilizzo al di fuori di BitmapFactory (per la generazione manuale di bitmap o la logica di decodifica personalizzata). Ora puoi impostare le dimensioni di una bitmap con i metodi setHeight() e setWidth() e specificare un nuovo Bitmap.Config con setConfig() senza influire sull'allocazione della bitmap sottostante. Il metodo reconfigure() fornisce anche un modo pratico per combinare queste modifiche con una sola chiamata.
Tuttavia, non devi riconfigurare una bitmap attualmente utilizzata dal sistema di visualizzazione, perché il buffer di pixel sottostante non verrà rimappato in modo prevedibile.
Contenuti degli utenti
Storage Access Framework
Nelle versioni precedenti di Android, se vuoi che la tua app recuperi un tipo specifico di file da un'altra app, deve richiamare un intent con l'azione ACTION_GET_CONTENT. Questa azione è ancora il modo appropriato per richiedere un file che vuoi importare nella tua app. Tuttavia, Android 4.4 introduce l'azione ACTION_OPEN_DOCUMENT, che consente all'utente di selezionare un file di un tipo specifico e concedere alla tua app l'accesso in lettura a lungo termine a quel file (possibilmente con accesso in scrittura) senza importare il file nella tua app.
Se stai sviluppando un'app che fornisce servizi di archiviazione per i file (ad esempio un servizio di salvataggio sul cloud), puoi partecipare a questa UI unificata per la selezione dei file implementando un provider di contenuti come sottoclasse della nuova classe DocumentsProvider. La sottoclasse di DocumentsProvider deve includere un filtro per intent che accetti l'azione PROVIDER_INTERFACE ("android.content.action.DOCUMENTS_PROVIDER"). Devi quindi implementare i quattro metodi astratti in DocumentsProvider:
queryRoots()- Deve restituire un
Cursorche descrive tutte le directory principali dello spazio di archiviazione dei documenti, utilizzando le colonne definite inDocumentsContract.Root. queryChildDocuments()- Deve restituire un
Cursorche descrive tutti i file nella directory specificata, utilizzando le colonne definite inDocumentsContract.Document. queryDocument()- Deve restituire un
Cursorche descrive il file specificato, utilizzando le colonne definite inDocumentsContract.Document. openDocument()- Deve restituire un
ParcelFileDescriptorche rappresenta il file specificato. Il sistema chiama questo metodo quando l'utente seleziona un file e l'app client ne richiede l'accesso chiamandoopenFileDescriptor().
Per maggiori informazioni, consulta la guida di Storage Access Framework.
Accesso all'unità di archiviazione esterna
Ora puoi leggere e scrivere file specifici dell'app su supporti di archiviazione esterni secondari, ad esempio quando un dispositivo fornisce sia lo spazio di archiviazione emulato sia una scheda SD. Il nuovo metodo getExternalFilesDirs() funziona allo stesso modo del metodo getExternalFilesDir() esistente, ma restituisce un array di oggetti File. Prima di leggere o scrivere in uno dei percorsi restituiti da questo metodo, passa l'oggetto File al nuovo metodo getStorageState() per verificare che lo spazio di archiviazione sia attualmente disponibile.
Anche altri metodi per accedere alla directory della cache specifica dell'app e alla directory OBB ora hanno versioni corrispondenti che forniscono l'accesso ai dispositivi di archiviazione secondari: rispettivamente getExternalCacheDirs() e getObbDirs().
La prima voce dell'array File restituito è considerata lo spazio di archiviazione esterno principale del dispositivo, che corrisponde a File restituito dai metodi esistenti come getExternalFilesDir().
Nota: a partire da Android 4.4, la piattaforma non richiede più che la tua app acquisisca WRITE_EXTERNAL_STORAGE o READ_EXTERNAL_STORAGE quando devi accedere solo alle regioni specifiche dell'app dello spazio di archiviazione esterno utilizzando i metodi sopra indicati. Tuttavia, le autorizzazioni sono necessarie se vuoi accedere alle regioni condivisibili dello spazio di archiviazione esterno, fornite da getExternalStoragePublicDirectory().
Adattatori di sincronizzazione
Il nuovo metodo requestSync() in ContentResolver semplifica alcune delle procedure per la definizione di una richiesta di sincronizzazione per il tuo ContentProvider incapsulando le richieste nel nuovo oggetto SyncRequest, che puoi creare con SyncRequest.Builder. Le proprietà in SyncRequest forniscono la stessa funzionalità delle chiamate di sincronizzazione ContentProvider esistenti, ma aggiungono la possibilità di specificare che una sincronizzazione deve essere interrotta se la rete è a consumo, attivando setDisallowMetered().
Input dell'utente
Nuovi tipi di sensori
Il nuovo sensore TYPE_GEOMAGNETIC_ROTATION_VECTOR fornisce dati sul vettore di rotazione basati su un magnetometro, che rappresenta un'alternativa utile al sensore TYPE_ROTATION_VECTOR quando non è disponibile un giroscopio o quando viene utilizzato con eventi dei sensori raggruppati per registrare l'orientamento del dispositivo mentre lo smartphone è in modalità di sospensione. Questo sensore richiede meno energia rispetto a TYPE_ROTATION_VECTOR, ma potrebbe essere soggetto a dati sugli eventi rumorosi ed è più efficace quando l'utente si trova all'aperto.
Android ora supporta anche i sensori di passi integrati nell'hardware:
TYPE_STEP_DETECTOR- Questo sensore attiva un evento ogni volta che l'utente fa un passo. A ogni passo dell'utente, questo sensore genera un evento con un valore di 1,0 e un timestamp che indica quando è stato eseguito il passo.
TYPE_STEP_COUNTER- Anche questo sensore attiva un evento per ogni passo rilevato, ma fornisce il numero totale di passi accumulati dalla prima registrazione del sensore da parte di un'app.
Tieni presente che questi due sensori di passi non forniscono sempre gli stessi risultati. Gli eventi TYPE_STEP_COUNTER si verificano con una latenza maggiore rispetto a quelli di TYPE_STEP_DETECTOR, ma questo è dovuto al fatto che l'algoritmo TYPE_STEP_COUNTER esegue un'elaborazione maggiore per eliminare i falsi positivi. Pertanto, TYPE_STEP_COUNTER potrebbe essere più lento nel fornire gli eventi, ma i suoi risultati dovrebbero essere più accurati.
Entrambi i sensori di passi dipendono dall'hardware (Nexus 5 è il primo dispositivo a supportarli), quindi devi verificare la disponibilità con hasSystemFeature(), utilizzando le costanti FEATURE_SENSOR_STEP_DETECTOR e FEATURE_SENSOR_STEP_COUNTER.
Eventi dei sensori raggruppati in batch
Per gestire meglio l'alimentazione del dispositivo, le API SensorManager ora ti consentono di specificare la frequenza con cui vuoi che il sistema invii batch di eventi dei sensori alla tua app. In questo modo non viene ridotto il numero di eventi dei sensori effettivi disponibili per la tua app per un determinato periodo di tempo, ma viene ridotta la frequenza con cui il sistema chiama il tuo SensorEventListener con gli aggiornamenti dei sensori. In altre parole, anziché inviare ogni evento alla tua app nel momento in cui si verifica, il sistema salva tutti gli eventi che si verificano in un periodo di tempo e poi li invia alla tua app tutti insieme.
Per fornire il raggruppamento, la classe SensorManager aggiunge due nuove versioni del metodo registerListener() che consentono di specificare la "latenza massima del report". Questo nuovo parametro specifica il ritardo massimo che il tuo SensorEventListener tollererà per la pubblicazione di nuovi eventi dei sensori. Ad esempio, se specifichi una latenza di raggruppamento di un minuto, il sistema invierà l'insieme recente di eventi raggruppati a un intervallo non superiore a un minuto effettuando chiamate consecutive al metodo onSensorChanged(), una volta per ogni evento raggruppato. Gli eventi del sensore non verranno mai ritardati oltre il valore di latenza massima dei report, ma potrebbero arrivare prima se altre app hanno richiesto una latenza più breve per lo stesso sensore.
Tuttavia, tieni presente che il sensore invierà alla tua app gli eventi raggruppati in base alla latenza dei report solo quando la CPU è attiva. Anche se un sensore hardware che supporta il raggruppamento continua a raccogliere eventi del sensore mentre la CPU è in modalità di sospensione, non riattiva la CPU per inviare alla tua app gli eventi raggruppati. Quando la memoria del sensore per gli eventi si esaurisce, inizierà a eliminare gli eventi meno recenti per salvare quelli più recenti. Puoi evitare di perdere eventi attivando il dispositivo prima che il sensore riempia la memoria, quindi chiamando flush() per acquisire l'ultimo gruppo di eventi. Per stimare quando la memoria sarà piena e dovrà essere svuotata, chiama getFifoMaxEventCount() per ottenere il numero massimo di eventi del sensore che può salvare e dividi questo numero per la frequenza con cui la tua app richiede ogni evento. Utilizza questo calcolo per impostare le sveglie con AlarmManager che richiamano il tuo Service (che implementa SensorEventListener) per svuotare il sensore.
Nota: non tutti i dispositivi supportano il raggruppamento in batch degli eventi dei sensori, perché è necessario il supporto del sensore hardware. Tuttavia, a partire da Android 4.4, devi sempre utilizzare i nuovi metodi registerListener(), perché se il dispositivo non supporta il raggruppamento in batch, il sistema ignora l'argomento della latenza del batch e fornisce gli eventi del sensore in tempo reale.
Identità dei controller
Android ora identifica ogni controller connesso con un numero intero univoco che puoi interrogare con getControllerNumber(), semplificando l'associazione di ogni controller a un giocatore diverso in un gioco. Il numero di ogni controller può cambiare se i controller vengono disconnessi, connessi o riconfigurati dall'utente, pertanto devi monitorare quale numero di controller corrisponde a ciascun dispositivo di input registrando un'istanza di InputManager.InputDeviceListener. Poi chiama getControllerNumber() per ogni InputDevice quando si verifica una modifica.
I dispositivi connessi ora forniscono anche gli ID prodotto e fornitore disponibili da getProductId() e getVendorId(). Se devi modificare le mappature dei tasti in base all'insieme di tasti disponibili su un dispositivo, puoi eseguire una query sul dispositivo per verificare se determinati tasti sono disponibili con hasKeys(int...).
Interfaccia utente
Modalità immersiva a schermo intero
Per fornire alla tua app un layout che riempia l'intero schermo, il nuovo flag SYSTEM_UI_FLAG_IMMERSIVE per setSystemUiVisibility() (se combinato con SYSTEM_UI_FLAG_HIDE_NAVIGATION) attiva una nuova modalità a schermo intero immersiva. Mentre la modalità immersiva a schermo intero è attiva, la tua attività continua a ricevere tutti gli eventi touch. L'utente può visualizzare le barre di sistema scorrendo verso l'interno lungo l'area in cui vengono normalmente visualizzate. In questo modo, il flag SYSTEM_UI_FLAG_HIDE_NAVIGATION (e il flag SYSTEM_UI_FLAG_FULLSCREEN, se applicato) viene cancellato, in modo che le barre di sistema rimangano visibili. Tuttavia, se vuoi che le barre di sistema vengano nascoste di nuovo dopo qualche istante, puoi utilizzare il flag SYSTEM_UI_FLAG_IMMERSIVE_STICKY.
Barre di sistema traslucide
Ora puoi rendere le barre di sistema parzialmente traslucide con i nuovi temi, Theme.Holo.NoActionBar.TranslucentDecor e Theme.Holo.Light.NoActionBar.TranslucentDecor. Se attivi le barre di sistema traslucide, il layout riempirà l'area dietro le barre di sistema, quindi devi attivare anche fitsSystemWindows per la parte del layout che non deve essere coperta dalle barre di sistema.
Se stai creando un tema personalizzato, imposta uno di questi temi come tema principale o includi le proprietà di stile windowTranslucentNavigation e windowTranslucentStatus nel tuo tema.
Listener di notifiche avanzate
Android 4.3 ha aggiunto le API NotificationListenerService, consentendo alle app di ricevere informazioni sulle nuove notifiche man mano che vengono pubblicate dal sistema. In Android 4.4, i listener di notifiche possono recuperare metadati aggiuntivi per la notifica e dettagli completi sulle azioni della notifica:
Il nuovo campo Notification.extras include un Bundle per fornire al tuo generatore di notifiche metadati aggiuntivi come EXTRA_TITLE e EXTRA_PICTURE.
La nuova classe Notification.Action definisce le caratteristiche di un'azione associata alla notifica, che puoi recuperare dal nuovo campo actions.
Mirroring dei drawable per i layout RTL
Nelle versioni precedenti di Android, se la tua app include immagini che devono invertire l'orientamento orizzontale per i layout da destra a sinistra, devi includere l'immagine speculare in una directory delle risorse drawables-ldrtl/. Ora il sistema può eseguire automaticamente il mirroring delle immagini attivando l'attributo autoMirrored su una risorsa drawable o chiamando setAutoMirrored(). Se l'opzione è attiva, l'icona Drawable viene automaticamente specchiata quando la direzione del layout è da destra a sinistra.
Accessibilità
La classe View ora ti consente di dichiarare "aree dinamiche" per le parti della UI che si aggiornano dinamicamente con nuovi contenuti di testo, aggiungendo il nuovo attributo accessibilityLiveRegion al layout XML o chiamando setAccessibilityLiveRegion(). Ad esempio, una schermata di accesso con un campo di testo che mostra una notifica "password errata" deve essere contrassegnata come area dinamica, in modo che lo screen reader legga il messaggio quando cambia.
Le app che forniscono un servizio di accessibilità ora possono anche migliorare le loro funzionalità con nuove API che forniscono informazioni sulle raccolte di visualizzazioni, come le visualizzazioni elenco o griglia, utilizzando AccessibilityNodeInfo.CollectionInfo e AccessibilityNodeInfo.CollectionItemInfo.
Autorizzazioni app
Di seguito sono riportate le nuove autorizzazioni che la tua app deve richiedere con il tag <uses-permission> per utilizzare determinate nuove API:
INSTALL_SHORTCUT- Consente a un'applicazione di installare una scorciatoia in Avvio app
UNINSTALL_SHORTCUT- Consente a un'applicazione di disinstallare una scorciatoia in Avvio applicazioni
TRANSMIT_IR- Consente a un'applicazione di utilizzare il trasmettitore a infrarossi del dispositivo, se disponibile
Nota: a partire da Android 4.4, la piattaforma non richiede più che la tua app acquisisca WRITE_EXTERNAL_STORAGE o READ_EXTERNAL_STORAGE quando vuoi accedere alle regioni specifiche dell'app dello spazio di archiviazione esterno utilizzando metodi come getExternalFilesDir(). Tuttavia, le autorizzazioni sono comunque necessarie se vuoi accedere alle regioni condivisibili dello spazio di archiviazione esterno, fornite da getExternalStoragePublicDirectory().
Funzioni dispositivo
Di seguito sono riportate le nuove funzionalità del dispositivo che puoi dichiarare con il tag <uses-feature> per dichiarare i requisiti della tua app e attivare i filtri su Google Play o verificare in fase di runtime:
FEATURE_CONSUMER_IR- Il dispositivo è in grado di comunicare con dispositivi IR consumer.
FEATURE_DEVICE_ADMIN- Il dispositivo supporta l'applicazione forzata delle policy per i dispositivi utilizzando gli amministratori dei dispositivi.
FEATURE_NFC_HOST_CARD_EMULATION- Il dispositivo supporta l'emulazione della carta NFC basata su host.
FEATURE_SENSOR_STEP_COUNTER- Il dispositivo include un contapassi hardware.
FEATURE_SENSOR_STEP_DETECTOR- Il dispositivo include un rilevatore di passi hardware.
Per una visualizzazione dettagliata di tutte le modifiche alle API in Android 4.4, consulta il report sulle differenze delle API.