API per Android 5.0

Livello API: 21

Android 5.0 (LOLLIPOP) offre nuove funzionalità per utenti e sviluppatori di app. Questo documento fornisce un'introduzione alle nuove API più importanti.

Se hai un'app pubblicata, assicurati di controllare le modifiche al comportamento di Android 5.0 di cui devi tenere conto nella tua app. Queste modifiche al comportamento potrebbero influire sulla tua app sui dispositivi Android 5.0, anche se non utilizzi nuove API o non hai come target nuove funzionalità.

Per una panoramica generale delle nuove funzionalità della piattaforma, consulta invece i punti salienti di Android Lollipop.

Inizia a sviluppareeloping

Per iniziare a creare app per Android 5.0, devi prima scaricare l'SDK Android. Poi utilizza SDK Manager per scaricare la piattaforma SDK Android 5.0 e le immagini di sistema.

Aggiorna il livello API target

Per ottimizzare meglio la tua app per i dispositivi con Android 5.0, imposta targetSdkVersion su "21", installa l'app su un'immagine di sistema Android 5.0, testala e poi pubblica l'app aggiornata con questa modifica.

Puoi utilizzare le API Android 5.0 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 del comportamento

Se hai già pubblicato un'app per Android, tieni presente che potrebbe essere interessata dalle modifiche apportate ad Android 5.0.

Per informazioni complete, consulta Modifiche di Android 5.0.

Interfaccia utente

Supporto di Material Design

Android 5.0 aggiunge il supporto per il nuovo stile Material Design di Android. Puoi creare app con Material Design visivamente dinamiche e con transizioni degli elementi UI che sembrano naturali agli utenti. Questo supporto include:

  • Il tema di Material
  • Visualizza ombre
  • Il widget RecyclerView
  • Animazione disegnabile ed effetti di stile
  • Animazione Material Design ed effetti di transizione delle attività
  • Animatori per le proprietà di visualizzazione in base allo stato della visualizzazione
  • Widget UI e barre delle app personalizzabili con tavolozze dei colori che puoi controllare
  • Elementi drawable animati e non animati basati su grafica vettoriale XML

Per scoprire di più sull'aggiunta di funzionalità di Material Design alla tua app, consulta Material Design.

Documenti e attività simultanei nella schermata Recenti

Nelle versioni precedenti, la schermata Recenti poteva mostrare solo un'attività per ogni app con cui l'utente aveva interagito più di recente. Ora la tua app può aprire più attività in base alle esigenze per attività simultanee aggiuntive per i documenti. Questa funzionalità facilita il multitasking consentendo agli utenti di passare rapidamente da singole attività e documenti alla schermata Recenti, con un'esperienza di passaggio coerente in tutte le app. Esempi di queste attività simultanee potrebbero includere schede aperte in un'app browser web, documenti in un'app di produttività, partite simultanee in un gioco o chat in un'app di messaggistica. La tua app può gestire le sue attività tramite la classe ActivityManager.AppTask.

Per inserire un'interruzione logica in modo che il sistema tratti la tua attività come una nuova attività, utilizza FLAG_ACTIVITY_NEW_DOCUMENT quando avvii l'attività con startActivity(). Puoi ottenere questo comportamento anche impostando l'attributo documentLaunchMode dell'elemento <activity> su "intoExisting" o "always" nel manifest.

Per evitare di ingombrare la schermata Recenti, puoi impostare il numero massimo di attività della tua app che possono essere visualizzate in quella schermata. Per farlo, imposta l'attributo android:maxRecents di <application>. Il numero massimo attuale che è possibile specificare è 50 attività per utente (25 per i dispositivi con poca RAM).

Le attività nella schermata Recenti possono essere impostate in modo da essere mantenute anche dopo i riavvii. Per controllare il comportamento di persistenza, utilizza l'attributo android:persistableMode. Puoi anche modificare le proprietà visive di un'attività nella schermata Recenti, ad esempio il colore, l'etichetta e l'icona dell'attività, chiamando il metodo setTaskDescription().

Aggiornamenti di WebView

Android 5.0 aggiorna l'implementazione di WebView a Chromium M37, apportando miglioramenti alla sicurezza e alla stabilità, nonché correzioni di bug. La stringa user agent predefinita per un'app WebView in esecuzione su Android 5.0 è stata aggiornata per incorporare 37.0.0.0 come numero di versione.

Questa release introduce la classe PermissionRequest, che consente alla tua app di concedere l'autorizzazione WebView per accedere a risorse protette come la fotocamera e il microfono, tramite API web come getUserMedia(). La tua app deve disporre delle autorizzazioni Android appropriate per queste risorse per poter concedere le autorizzazioni a WebView.

Con il nuovo metodo onShowFileChooser(), ora puoi utilizzare un campo del modulo di immissione in WebView e avviare un selettore file per selezionare immagini e file dal dispositivo Android.

Inoltre, questa release introduce il supporto degli standard aperti WebAudio, WebGL e WebRTC. Per scoprire di più sulle nuove funzionalità incluse in questa release, consulta WebView per Android.

Acquisizione schermo e condivisione

Android 5.0 ti consente di aggiungere funzionalità di acquisizione e condivisione schermo alla tua app con le nuove API android.media.projection. Questa funzionalità è utile, ad esempio, se vuoi attivare la condivisione schermo in un'app di videoconferenza.

Il nuovo metodo createVirtualDisplay() consente alla tua app di acquisire i contenuti della schermata principale (il display predefinito) in un oggetto Surface, che l'app può poi inviare tramite la rete. L'API consente di acquisire solo contenuti dello schermo non protetti e non l'audio di sistema. Per iniziare l'acquisizione dello schermo, l'app deve prima richiedere l'autorizzazione dell'utente avviando una finestra di dialogo di acquisizione dello schermo utilizzando un Intent ottenuto tramite il metodo createScreenCaptureIntent().

Per un esempio di come utilizzare le nuove API, consulta la classe MediaProjectionDemo nel progetto di esempio.

Notifiche

Notifiche nella schermata di blocco

Le schermate di blocco di Android 5.0 possono mostrare notifiche. Gli utenti possono scegliere tramite le Impostazioni se consentire la visualizzazione di contenuti delle notifiche sensibili su una schermata di blocco sicura.

La tua app può controllare il livello di dettaglio visibile quando le sue notifiche vengono visualizzate nella schermata di blocco sicura. Per controllare il livello di visibilità, chiama setVisibility() e specifica uno di questi valori:

  • VISIBILITY_PRIVATE: mostra informazioni di base, come l'icona della notifica, ma nasconde i contenuti completi della notifica.
  • VISIBILITY_PUBLIC: mostra i contenuti completi della notifica.
  • VISIBILITY_SECRET: non mostra nulla, nemmeno l'icona della notifica.

Quando il livello di visibilità è VISIBILITY_PRIVATE, puoi anche fornire una versione oscurata dei contenuti della notifica che nasconde i dettagli personali. Ad esempio, un'app per SMS potrebbe mostrare una notifica con il testo "Hai 3 nuovi messaggi", ma nascondere i contenuti e i mittenti dei messaggi. Per fornire questa notifica alternativa, crea prima la notifica sostitutiva utilizzando Notification.Builder. Quando crei l'oggetto di notifica privata, allega la notifica sostitutiva tramite il metodo setPublicVersion().

Metadati delle notifiche

Android 5.0 utilizza i metadati associati alle notifiche dell'app per ordinarle in modo più intelligente. Per impostare i metadati, chiama i seguenti metodi in Notification.Builder quando crei la notifica:

  • setCategory(): indica al sistema come gestire le notifiche dell'app quando il dispositivo è in modalità prioritaria (ad esempio, se una notifica rappresenta una chiamata in arrivo, un messaggio immediato o una sveglia).
  • setPriority(): contrassegna la notifica come più o meno importante rispetto alle notifiche normali. Le notifiche con il campo di priorità impostato su PRIORITY_MAX o PRIORITY_HIGH vengono visualizzate in una piccola finestra mobile se la notifica ha anche un suono o una vibrazione.
  • addPerson(): consente di aggiungere una o più persone pertinenti a una notifica. La tua app può utilizzarla per segnalare al sistema che deve raggruppare le notifiche delle persone specificate o classificare le notifiche di queste persone come più importanti.

Grafica

Supporto per OpenGL ES 3.1

Android 5.0 aggiunge interfacce Java e il supporto nativo per OpenGL ES 3.1. Le nuove funzionalità principali fornite in OpenGL ES 3.1 includono:

  • Compute shader
  • Oggetti shader separati
  • Comandi di disegno indiretti
  • Texture multisample e stencil
  • Miglioramenti del linguaggio di ombreggiatura
  • Estensioni per modalità di fusione avanzate e debug
  • Compatibilità con le versioni precedenti di OpenGL ES 2.0 e 3.0

L'interfaccia Java per OpenGL ES 3.1 su Android viene fornita con GLES31. Quando utilizzi OpenGL ES 3.1, assicurati di dichiararlo nel file manifest con il tag <uses-feature> e l'attributo android:glEsVersion. Ad esempio:

<manifest>
    <uses-feature android:glEsVersion="0x00030001" />
    ...
</manifest>

Per saperne di più sull'utilizzo di OpenGL ES, incluso come controllare la versione OpenGL ES supportata dal dispositivo in fase di runtime, consulta la guida all'API OpenGL ES.

Android Extension Pack

Oltre a OpenGL ES 3.1, questa release fornisce un pacchetto di estensioni con interfacce Java e supporto nativo per funzionalità grafiche avanzate. Queste estensioni vengono trattate come un unico pacchetto da Android. Se l'estensione ANDROID_extension_pack_es31a è presente, l'app può presupporre che tutte le estensioni nel pacchetto siano presenti e attivare le funzionalità del linguaggio di shading con una singola istruzione #extension.

Il pacchetto di estensioni supporta:

  • Supporto dei fragment shader richiesto per buffer di archiviazione, immagini e atomiche degli shader (il supporto dei fragment shader è facoltativo in OpenGL ES 3.1).
  • Tessellation e geometry shader
  • Formato di compressione delle texture ASTC (LDR)
  • Interpolazione e ombreggiatura per campione
  • Diverse modalità di fusione per ogni allegato di colore in un frame buffer

L'interfaccia Java per l'extension pack è fornita con GLES31Ext. Nel manifest dell'app, puoi dichiarare che l'app deve essere installata solo su dispositivi che supportano l'extension pack. Ad esempio:

<manifest>
    <uses-feature android:name="android.hardware.opengles.aep"
        android:required="true" />
    ...
</manifest>

Media

API Camera per funzionalità avanzate della fotocamera

Android 5.0 introduce la nuova API android.hardware.camera2 per facilitare l'acquisizione di foto e l'elaborazione delle immagini con un livello di dettaglio elevato. Ora puoi accedere in modo programmatico ai dispositivi con fotocamera disponibili per il sistema con getCameraIdList() e connetterti a un dispositivo specifico con openCamera(). Per iniziare ad acquisire immagini, crea un CameraCaptureSession e specifica gli oggetti Surface a cui inviare le immagini acquisite. CameraCaptureSession può essere configurato per scattare foto singole o più immagini in sequenza.

Per ricevere una notifica quando vengono acquisite nuove immagini, implementa il listener CameraCaptureSession.CaptureCallback e impostalo nella richiesta di acquisizione. Ora, quando il sistema completa la richiesta di acquisizione di immagini, il listener CameraCaptureSession.CaptureCallback riceve una chiamata a onCaptureCompleted(), fornendoti i metadati di acquisizione di immagini in un CaptureResult.

La classe CameraCharacteristics consente alla tua app di rilevare le funzionalità della fotocamera disponibili su un dispositivo. La proprietà INFO_SUPPORTED_HARDWARE_LEVEL dell'oggetto rappresenta il livello di funzionalità della videocamera.

  • Tutti i dispositivi supportano almeno il livello hardware INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY, che ha funzionalità approssimativamente equivalenti a quelle dell'API Camera deprecata.
  • I dispositivi che supportano il livello hardware INFO_SUPPORTED_HARDWARE_LEVEL_FULL sono in grado di controllare manualmente l'acquisizione e la post-elaborazione e di acquisire immagini ad alta risoluzione con frequenze fotogrammi elevate.

Per scoprire come utilizzare l'API Camera aggiornata, consulta gli esempi di implementazione di Camera2Basic e Camera2Video in questa release.

Riproduzione audio

Questa release include le seguenti modifiche a AudioTrack:

  • Ora la tua app può fornire dati audio in formato con rappresentazione in virgola mobile (ENCODING_PCM_FLOAT). Ciò consente una gamma dinamica più ampia, una precisione più coerente e un maggiore margine di sicurezza. L'aritmetica in virgola mobile è particolarmente utile durante i calcoli intermedi. Gli endpoint di riproduzione utilizzano il formato intero per i dati audio e una profondità di bit inferiore. In Android 5.0, alcune parti della pipeline interna non sono ancora in virgola mobile.
  • Ora la tua app può fornire dati audio come ByteBuffer, nello stesso formato fornito da MediaCodec.
  • L'opzione WRITE_NON_BLOCKING può semplificare il buffering e il multithreading per alcune app.

Controllo della riproduzione di contenuti multimediali

Utilizza le nuove API di notifica e multimediali per assicurarti che la UI di sistema sia a conoscenza della riproduzione dei contenuti multimediali e possa estrarre e mostrare la copertina dell'album. Controllare la riproduzione di contenuti multimediali tramite un'interfaccia utente e un servizio è ora più semplice con le nuove classi MediaSession e MediaController.

La nuova classe MediaSession sostituisce la classe RemoteControlClient deprecata e fornisce un singolo insieme di metodi di callback per la gestione dei controlli di trasporto e dei pulsanti multimediali. Se la tua app fornisce la riproduzione di contenuti multimediali e viene eseguita sulla piattaforma Android TV o Wear, utilizza la classe MediaSession per gestire i controlli di trasporto utilizzando gli stessi metodi di callback.

Ora puoi creare la tua app di controllo dei contenuti multimediali con la nuova classe MediaController. Questa classe fornisce un modo thread-safe per monitorare e controllare la riproduzione di contenuti multimediali dal processo della UI della tua app. Quando crei un controller, specifica un oggetto MediaSession.Token in modo che la tua app possa interagire con l'oggetto MediaSession specificato. Utilizzando i metodi MediaController.TransportControls, puoi inviare comandi come play(), stop(), skipToNext() e setRating() per controllare la riproduzione dei contenuti multimediali in quella sessione. Con il controller, puoi anche registrare un oggetto MediaController.Callback per ascoltare i metadati e le modifiche dello stato della sessione.

Inoltre, puoi creare notifiche avanzate che consentono i controlli di riproduzione collegati a una sessione multimediale con la nuova classe Notification.MediaStyle.

Navigazione dei contenuti multimediali

Android 5.0 introduce la possibilità per le app di sfogliare la raccolta di contenuti multimediali di un'altra app tramite la nuova API android.media.browse. Per esporre i contenuti multimediali nella tua app, estendi la classe MediaBrowserService. La tua implementazione di MediaBrowserService deve fornire l'accesso a un MediaSession.Token in modo che le app possano riprodurre i contenuti multimediali forniti tramite il tuo servizio.

Per interagire con un servizio di browser multimediale, utilizza la classe MediaBrowser. Specifica il nome del componente per un MediaSession quando crei un'istanza MediaBrowser. Utilizzando l'istanza del browser, l'app può quindi connettersi al servizio associato e ottenere un oggetto MediaSession.Token per riprodurre i contenuti esposti tramite il servizio.

Archiviazione

Selezione della directory

Android 5.0 estende lo Storage Access Framework per consentire agli utenti di selezionare un intero sottoalbero di directory, offrendo alle app l'accesso in lettura/scrittura a tutti i documenti contenuti senza richiedere la conferma dell'utente per ogni elemento.

Per selezionare una sottostruttura di directory, crea e invia un intent OPEN_DOCUMENT_TREE. Il sistema visualizza tutte le istanze DocumentsProvider che supportano la selezione della struttura secondaria, consentendo all'utente di sfogliare e selezionare una directory. L'URI restituito rappresenta l'accesso al sottoalbero selezionato. Puoi quindi utilizzare buildChildDocumentsUriUsingTree() e buildDocumentUriUsingTree() insieme a query() per esplorare il sottoalbero.

Il nuovo metodo createDocument() consente di creare nuovi documenti o directory in qualsiasi punto del sottoalbero. Per gestire i documenti esistenti, utilizza renameDocument() e deleteDocument(). Controlla COLUMN_FLAGS per verificare il supporto del provider per queste chiamate prima di effettuarle.

Se stai implementando un DocumentsProvider e vuoi supportare la selezione della struttura secondaria, implementa isChildDocument() e includi FLAG_SUPPORTS_IS_CHILD nel tuo COLUMN_FLAGS.

Android 5.0 introduce anche nuove directory specifiche per i pacchetti nello spazio di archiviazione condiviso, in cui l'app può inserire file multimediali da includere in MediaStore. La nuova API getExternalMediaDirs() restituisce i percorsi di queste directory su tutti i dispositivi di archiviazione condivisi. Analogamente a getExternalFilesDir(), la tua app non richiede autorizzazioni aggiuntive per accedere ai percorsi di ritorno restituiti. La piattaforma esegue periodicamente la scansione di nuovi contenuti multimediali in queste directory, ma puoi anche utilizzare MediaScannerConnection per eseguire esplicitamente la scansione di nuovi contenuti.

Wireless e connettività

Più connessioni di rete

Android 5.0 fornisce nuove API di networking multiplo che consentono alla tua app di cercare dinamicamente le reti disponibili con funzionalità specifiche e di stabilire una connessione con queste. Questa funzionalità è utile quando l'app richiede una rete specializzata, ad esempio una rete SUPL, MMS o di fatturazione con l'operatore, oppure se vuoi inviare dati utilizzando un tipo particolare di protocollo di trasporto.

Per selezionare e connetterti a una rete in modo dinamico dalla tua app, segui questi passaggi:

  1. Crea un ConnectivityManager.
  2. Utilizza la classe NetworkRequest.Builder per creare un oggetto NetworkRequest e specifica le funzionalità di rete e il tipo di trasporto che interessano alla tua app.
  3. Per cercare reti idonee, chiama requestNetwork() o registerNetworkCallback() e passa l'oggetto NetworkRequest e un'implementazione di ConnectivityManager.NetworkCallback. Utilizza il metodo requestNetwork() se vuoi passare attivamente a una rete adatta una volta rilevata; per ricevere solo notifiche per le reti scansionate senza passare attivamente, utilizza invece il metodo registerNetworkCallback().

Quando il sistema rileva una rete adatta, si connette alla rete e richiama il callback onAvailable(). Puoi utilizzare l'oggetto Network del callback per ottenere informazioni aggiuntive sulla rete o per indirizzare il traffico in modo che utilizzi la rete selezionata.

Bluetooth Low Energy

Android 4.3 ha introdotto il supporto della piattaforma per Bluetooth Low Energy (Bluetooth LE) nel ruolo centrale. In Android 5.0, un dispositivo Android può ora fungere da dispositivo periferico Bluetooth LE. Le app possono utilizzare questa funzionalità per farsi riconoscere dai dispositivi nelle vicinanze. Ad esempio, puoi creare app che consentono a un dispositivo di funzionare come contapassi o monitor della salute e di comunicare i suoi dati con un altro dispositivo Bluetooth LE.

Le nuove API android.bluetooth.le consentono alle tue app di trasmettere annunci, cercare risposte e stabilire connessioni con dispositivi Bluetooth LE nelle vicinanze. Per utilizzare le nuove funzionalità di annuncio e scansione, aggiungi l'autorizzazione BLUETOOTH_ADMIN nel manifest. Quando gli utenti aggiornano o scaricano la tua app dal Play Store, viene chiesto loro di concedere alla tua app la seguente autorizzazione: "Informazioni sulla connessione Bluetooth: consente all'app di controllare il Bluetooth, inclusa la trasmissione o la ricezione di informazioni sui dispositivi Bluetooth nelle vicinanze".

Per avviare la pubblicità Bluetooth LE in modo che altri dispositivi possano rilevare la tua app, chiama startAdvertising() e passa un'implementazione della classe AdvertiseCallback. L'oggetto di callback riceve un report sull'esito positivo o negativo dell'operazione di annuncio.

Android 5.0 introduce la classe ScanFilter in modo che la tua app possa cercare solo i tipi specifici di dispositivi che le interessano. Per iniziare la ricerca di dispositivi Bluetooth LE, chiama startScan() e passa un elenco di filtri. Nella chiamata al metodo, devi anche fornire un'implementazione di ScanCallback per segnalare quando viene trovato un annuncio Bluetooth LE.

Miglioramenti NFC

Android 5.0 aggiunge questi miglioramenti per consentire un utilizzo più ampio e flessibile della tecnologia NFC:

  • Android Beam è ora disponibile nel menu di condivisione.
  • La tua app può richiamare Android Beam sul dispositivo dell'utente per condividere i dati chiamando invokeBeam(). In questo modo, l'utente non deve toccare manualmente il dispositivo con un altro dispositivo compatibile con NFC per completare il trasferimento dei dati.
  • Puoi utilizzare il nuovo metodo createTextRecord() per creare un record NDEF contenente dati di testo UTF-8.
  • Se stai sviluppando un'app per pagamenti, ora puoi registrare un ID applicazione (AID) NFC in modo dinamico chiamando registerAidsForService(). Puoi anche utilizzare setPreferredService() per impostare il servizio di emulazione della carta preferito da utilizzare quando un'attività specifica è in primo piano.

Project Volta

Oltre alle nuove funzionalità, Android 5.0 si concentra sui miglioramenti della durata della batteria. Utilizza le nuove API e il nuovo strumento per comprendere e ottimizzare il consumo energetico della tua app.

Pianificazione dei job

Android 5.0 fornisce una nuova API JobScheduler che ti consente di ottimizzare la durata della batteria definendo i job che il sistema deve eseguire in modo asincrono in un secondo momento o in condizioni specificate (ad esempio quando il dispositivo è in carica). La pianificazione dei job è utile in situazioni quali:

  • L'app ha un lavoro non rivolto agli utenti che puoi posticipare.
  • L'app ha un'attività che preferisci eseguire quando l'unità è collegata alla corrente.
  • L'app ha un'attività che richiede l'accesso alla rete o una connessione Wi-Fi.
  • L'app ha una serie di attività che vuoi eseguire in batch in base a una pianificazione regolare.

Un'unità di lavoro è incapsulata da un oggetto JobInfo. Questo oggetto specifica i criteri di pianificazione.

Utilizza la classe JobInfo.Builder per configurare la modalità di esecuzione dell'attività pianificata. Puoi pianificare l'esecuzione dell'attività in condizioni specifiche, ad esempio:

  • Avvia quando il dispositivo è in carica
  • Avvia quando il dispositivo è connesso a una rete non a consumo
  • Avvia quando il dispositivo è inattivo
  • Terminare prima di una determinata scadenza o con un ritardo minimo

Ad esempio, puoi aggiungere un codice come questo per eseguire l'attività su una rete non a consumo:

Kotlin

val uploadTask: JobInfo = JobInfo.Builder(
        jobId,
        serviceComponent /* JobService component */
).run {
    setRequiredNetworkType(JobInfo.NETWORK_TYPE_UNMETERED)
    build()
}
val jobScheduler = context.getSystemService(Context.JOB_SCHEDULER_SERVICE) as JobScheduler
jobScheduler.schedule(uploadTask)

Java

JobInfo uploadTask = new JobInfo.Builder(jobId,
                                         serviceComponent /* JobService component */)
        .setRequiredNetworkCapabilities(JobInfo.NETWORK_TYPE_UNMETERED)
        .build();
JobScheduler jobScheduler =
        (JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
jobScheduler.schedule(uploadTask);

Se il dispositivo ha un'alimentazione stabile (ovvero è collegato da più di 2 minuti e la batteria è a un livello ottimale), il sistema eseguirà qualsiasi job pianificato pronto per l'esecuzione, anche se la scadenza del job non è ancora passata.

Per un esempio di come utilizzare l'API JobScheduler, consulta l'esempio di implementazione di JobSchedulerSample in questa release.

Strumenti per sviluppatori per l'utilizzo della batteria

Il nuovo comando dumpsys batterystats genera dati statistici interessanti sull'utilizzo della batteria su un dispositivo, organizzati per ID utente (UID) univoco. Le statistiche includono:

  • Cronologia degli eventi relativi alla batteria
  • Statistiche globali per il dispositivo
  • Consumo di energia approssimativo per UID e componente di sistema
  • ms per pacchetto mobile per app
  • Statistiche aggregate degli UID di sistema
  • Statistiche aggregate dell'UID dell'app

Utilizza l'opzione --help per scoprire le varie opzioni per personalizzare l'output. Ad esempio, per stampare le statistiche sull'utilizzo della batteria per un determinato pacchetto applicativo dall'ultima ricarica del dispositivo, esegui questo comando:

$ adb shell dumpsys batterystats --charged <package-name>

Puoi utilizzare lo strumento Battery Historian sull'output del comando dumpsys per generare una visualizzazione HTML degli eventi relativi all'alimentazione dai log. Queste informazioni ti consentono di comprendere e diagnosticare più facilmente eventuali problemi relativi alla batteria.

Android sul posto di lavoro e nell'istruzione

Provisioning gestito

Android 5.0 offre nuove funzionalità per l'esecuzione di app in un ambiente aziendale. Un amministratore del dispositivo può avviare un processo di provisioning gestito per aggiungere un profilo gestito copresente ma separato a un dispositivo, se l'utente ha un account personale esistente. Le app associate ai profili gestiti vengono visualizzate insieme alle app non gestite in Avvio app, nella schermata Recenti e nelle notifiche dell'utente.

Per avviare la procedura di provisioning gestito, invia ACTION_PROVISION_MANAGED_PROFILE in un Intent. Se la chiamata va a buon fine, il sistema attiva il callback onProfileProvisioningComplete(). Puoi quindi chiamare setProfileEnabled() per attivare questo profilo gestito.

Per impostazione predefinita, nel profilo gestito è attivato solo un piccolo sottoinsieme di app. Puoi installare altre app nel profilo gestito chiamando enableSystemApp().

Se stai sviluppando un'app di avvio, puoi utilizzare la nuova classe LauncherApps per ottenere un elenco di attività avviabili per l'utente corrente e per tutti i profili gestiti associati. Il tuo Avvio app può mettere in evidenza visivamente le app gestite aggiungendo un badge di lavoro all'icona drawable. Per recuperare l'icona con badge, chiama getUserBadgedIcon().

Per scoprire come utilizzare la nuova funzionalità, consulta l'esempio di implementazione di BasicManagedProfile in questa release.

Proprietario del dispositivo

Android 5.0 introduce la possibilità di eseguire il deployment di un'app proprietaria del dispositivo. Un proprietario del dispositivo è un tipo specializzato di amministratore del dispositivo che ha la possibilità aggiuntiva di creare e rimuovere utenti secondari e di configurare le impostazioni globali sul dispositivo. L'app proprietaria del dispositivo può utilizzare i metodi della classe DevicePolicyManager per assumere un controllo granulare della configurazione, della sicurezza e delle app sui dispositivi gestiti. Un dispositivo può avere un solo proprietario attivo alla volta.

Per eseguire il deployment e attivare un device owner, devi eseguire un trasferimento di dati NFC da un'app di programmazione al dispositivo mentre quest'ultimo è in stato non sottoposto a provisioning. Questo trasferimento di dati invia le stesse informazioni dell'intent di provisioning descritto in Provisioning gestito.

Blocco su schermo

Android 5.0 introduce una nuova API di blocco su schermo che ti consente di impedire temporaneamente agli utenti di uscire dalla tua attività o di essere interrotti dalle notifiche. Ad esempio, se stai sviluppando un'app per l'istruzione per supportare i requisiti di valutazione con una quota elevata su Android o un'applicazione monofunzione o kiosk. Una volta che l'app attiva il blocco app su schermo, gli utenti non possono visualizzare le notifiche, accedere ad altre app o tornare alla schermata Home finché l'app non esce dalla modalità.

Esistono due modi per attivare il blocco su schermo:

  • Manualmente: gli utenti possono attivare il blocco su schermo in Impostazioni > Sicurezza > Blocco su schermo e selezionare le attività che vogliono fissare toccando l'icona a forma di puntina verde nella schermata Recenti.
  • In modo programmatico: per attivare il blocco su schermo in modo programmatico, chiama startLockTask() dalla tua app. Se l'app richiedente non è un device owner, all'utente viene chiesta conferma. Un'app proprietaria del dispositivo può chiamare il metodo setLockTaskPackages() per consentire il blocco delle app senza il passaggio di conferma dell'utente.

Quando il blocco delle attività è attivo, si verifica il seguente comportamento:

  • La barra di stato è vuota e le notifiche utente e le informazioni sullo stato sono nascoste.
  • I pulsanti Home e App recenti sono nascosti.
  • Altre app non possono avviare nuove attività.
  • L'app corrente può avviare nuove attività, purché non vengano create nuove attività.
  • Quando il blocco su schermo viene richiamato da un device owner, l'utente rimane bloccato sulla tua app finché l'app non chiama stopLockTask().
  • Se il blocco su schermo viene attivato da un'altra app che non è un device owner o direttamente dall'utente, quest'ultimo può uscire tenendo premuti i pulsanti Indietro e Recenti.

Framework di stampa

Esegui il rendering del PDF come bitmap

Ora puoi eseguire il rendering delle pagine dei documenti PDF in immagini bitmap per la stampa utilizzando la nuova classe PdfRenderer. Devi specificare un ParcelFileDescriptor ricercabile (ovvero i contenuti possono essere accessibili in modo casuale) su cui il sistema scrive i contenuti stampabili. La tua app può ottenere una pagina per il rendering con openPage(), quindi chiamare render() per trasformare il PdfRenderer.Page aperto in una bitmap. Puoi anche impostare parametri aggiuntivi se vuoi convertire solo una parte del documento in un'immagine bitmap (ad esempio, per implementare il rendering a riquadri per aumentare lo zoom sul documento).

Per un esempio di come utilizzare le nuove API, consulta l'esempio PdfRendererBasic.

Sistema

Statistiche sull'utilizzo di app

Ora puoi accedere alla cronologia di utilizzo delle app su un dispositivo Android con la nuova API android.app.usage. Questa API fornisce informazioni sull'utilizzo più dettagliate rispetto al metodo getRecentTasks() deprecato. Per utilizzare questa API, devi prima dichiarare l'autorizzazione "android.permission.PACKAGE_USAGE_STATS" nel manifest. L'utente deve anche attivare l'accesso per questa app tramite Impostazioni > Sicurezza > App con accesso ai dati d'uso.

Il sistema raccoglie i dati sull'utilizzo per ogni app, aggregandoli in intervalli giornalieri, settimanali, mensili e annuali. La durata massima per cui il sistema conserva questi dati è la seguente:

  • Dati giornalieri: 7 giorni
  • Dati settimanali: 4 settimane
  • Dati mensili: 6 mesi
  • Dati annuali: 2 anni

Per ogni app, il sistema registra i seguenti dati:

  • L'ultima volta che l'app è stata utilizzata
  • Il periodo di tempo totale in cui l'app è stata in primo piano per l'intervallo di tempo in questione (per giorno, settimana, mese o anno)
  • Timestamp che indica quando un componente (identificato da un nome di pacchetto e di attività) è stato spostato in primo piano o in background durante un giorno
  • Timestamp che acquisisce il momento in cui è stata modificata una configurazione dispositivo (ad esempio quando l'orientamento del dispositivo è cambiato a causa della rotazione)

Test e accessibilità

Miglioramenti ai test e all'accessibilità

Android 5.0 aggiunge il seguente supporto per i test e l'accessibilità:

  • I nuovi metodi getWindowAnimationFrameStats() e getWindowContentFrameStats() acquisiscono le statistiche dei frame per le animazioni e i contenuti delle finestre. Questi metodi ti consentono di scrivere test di instrumentazione per valutare se un'app esegue il rendering dei frame con una frequenza di aggiornamento sufficiente per offrire un'esperienza utente fluida.
  • Il nuovo metodo executeShellCommand() ti consente di eseguire comandi della shell dal test di instrumentazione. L'esecuzione del comando è simile all'esecuzione di adb shell da un host connesso al dispositivo, consentendoti di utilizzare strumenti basati su shell come dumpsys, am, content e pm.
  • I servizi di accessibilità e gli strumenti di test che utilizzano le API per l'accessibilità (come UiAutomator) ora possono recuperare informazioni dettagliate sulle proprietà delle finestre sullo schermo con cui gli utenti vedenti possono interagire. Per recuperare un elenco di oggetti AccessibilityWindowInfo, chiama il nuovo metodo getWindows().
  • La nuova classe AccessibilityNodeInfo.AccessibilityAction ti consente di definire azioni standard o azioni personalizzate da eseguire su un AccessibilityNodeInfo. La nuova classe AccessibilityNodeInfo.AccessibilityAction sostituisce le API relative alle azioni precedentemente disponibili in AccessibilityNodeInfo.
  • Android 5.0 offre un controllo più granulare sulla sintesi vocale nella tua app. La nuova classe Voice consente alla tua app di utilizzare profili vocali associati a impostazioni internazionali specifiche, valutazione della qualità e della latenza e parametri specifici del motore di sintesi vocale.

IME

Passaggio più semplice tra le lingue di inserimento

A partire da Android 5.0, gli utenti possono passare da un editor di metodi di immissione (IME) all'altro tra quelli supportati dalla piattaforma. L'esecuzione dell'azione di cambio designata (di solito il tocco di un'icona a forma di globo sulla tastiera su schermo) consente di scorrere tutti questi IME. Questa modifica del comportamento viene implementata dal metodo shouldOfferSwitchingToNextInputMethod().

Inoltre, il framework ora controlla se l'IME successivo include un meccanismo di passaggio (e, di conseguenza, se l'IME supporta il passaggio all'IME successivo). Un IME con un meccanismo di passaggio non passerà a un IME senza questo meccanismo. Questa modifica del comportamento viene implementata dal metodo switchToNextInputMethod().

Per un esempio di come utilizzare le API di cambio IME aggiornate, consulta l'esempio di implementazione della tastiera su schermo aggiornato in questa release. Per scoprire di più su come implementare il passaggio tra IME, consulta Creazione di un metodo di immissione.

Dichiarazioni del manifest

Funzionalità obbligatorie dichiarabili

I seguenti valori sono ora supportati nell'elemento <uses-feature>, così puoi assicurarti che la tua app venga installata solo su dispositivi che forniscono le funzionalità di cui ha bisogno.

Autorizzazioni dell'utente

La seguente autorizzazione è ora supportata nell'elemento <uses-permission> per dichiarare le autorizzazioni richieste dalla tua app per accedere a determinate API.

  • BIND_DREAM_SERVICE: se il livello API target è 21 e versioni successive, questa autorizzazione è richiesta da un servizio Daydream per garantire che solo il sistema possa associarsi.