Livello API: 18
Android 4.3 (JELLY_BEAN_MR2)
è un aggiornamento della release Jelly Bean 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.3 e la piattaforma SDK da SDK Manager il prima possibile. Se non hai un dispositivo con Android 4.3 su cui testare la tua app, utilizza l'immagine di sistema di Android 4.3 per testare l'app sull'emulatore Android. Quindi, crea le tue app per la piattaforma Android 4.3 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.3,
devi impostare targetSdkVersion su
"18", installarla su un'immagine di sistema Android 4.3,
testarla e poi pubblicare un aggiornamento con questa modifica.
Puoi utilizzare le API in Android 4.3 supportando al contempo le versioni precedenti aggiungendo
condizioni al codice che controllano il livello API di sistema prima di eseguire
le API non supportate da minSdkVersion.
Per scoprire di più su come mantenere la compatibilità con le versioni precedenti, leggi Supporto di diverse versioni della piattaforma.
Nella Android Support Library sono disponibili anche varie API che ti consentono di implementare nuove funzionalità nelle versioni precedenti 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.3.
Se la tua app utilizza intent impliciti…
La tua app potrebbe non funzionare correttamente in un ambiente con profilo limitato.
Gli utenti in un ambiente con profilo limitato potrebbero non avere a disposizione tutte le app per Android standard. Ad esempio, un profilo limitato potrebbe avere il browser web e l'app della fotocamera disattivati. Pertanto, la tua app non deve fare supposizioni su quali app sono
disponibili, perché se chiami startActivity() senza
verificare se un'app è disponibile per gestire Intent,
la tua app potrebbe arrestarsi in modo anomalo in un profilo limitato.
Quando utilizzi un intent implicito, devi sempre verificare che sia disponibile un'app per gestire l'intent chiamando resolveActivity() o queryIntentActivities(). Ad esempio:
Kotlin
val intent = Intent(Intent.ACTION_SEND) ... if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } else { Toast.makeText(context, R.string.app_not_available, Toast.LENGTH_LONG).show() }
Java
Intent intent = new Intent(Intent.ACTION_SEND); ... if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } else { Toast.makeText(context, R.string.app_not_available, Toast.LENGTH_LONG).show(); }
Se la tua app dipende da account…
La tua app potrebbe non funzionare correttamente in un ambiente con profilo limitato.
Per impostazione predefinita, gli utenti in un ambiente con profilo limitato non hanno accesso agli account utente.
Se la tua app dipende da un Account, potrebbe arrestarsi in modo anomalo o comportarsi in modo imprevisto se utilizzata in un profilo limitato.
Se vuoi impedire del tutto ai profili con limitazioni di utilizzare la tua app perché quest'ultima dipende da informazioni sensibili dell'account, specifica l'attributo android:requiredAccountType nell'elemento <application> del manifest.
Se vuoi consentire ai profili limitati di continuare a utilizzare la tua app anche se non possono creare i propri account, puoi disattivare le funzionalità dell'app che richiedono un account o consentire ai profili limitati di accedere agli account creati dall'utente principale. Per saperne di più, consulta la sezione di seguito relativa al supporto degli account in un profilo limitato.
Se la tua app utilizza VideoView…
Il video potrebbe apparire più piccolo su Android 4.3.
Nelle versioni precedenti di Android, il widget VideoView calcolava erroneamente
il valore "wrap_content" per layout_height e layout_width in modo che fosse uguale a "match_parent". Pertanto, sebbene l'utilizzo di "wrap_content" per l'altezza o la larghezza potrebbe aver fornito in precedenza il layout video desiderato,
ciò potrebbe comportare un video molto più piccolo su Android 4.3 e versioni successive. Per risolvere il problema, sostituisci "wrap_content" con "match_parent" e verifica che il video venga visualizzato come previsto su Android 4.3 e versioni precedenti.
Profili limitati
Sui tablet Android, gli utenti ora possono creare profili limitati in base all'utente principale. Quando gli utenti creano un profilo limitato, possono attivare limitazioni, ad esempio quali app sono disponibili per il profilo. Un nuovo insieme di API in Android 4.3 ti consente anche di creare impostazioni di limitazione granulari per le app che sviluppi. Ad esempio, utilizzando le nuove API, puoi consentire agli utenti di controllare il tipo di contenuti disponibili nella tua app quando viene eseguita in un ambiente con profilo limitato.
La UI che consente agli utenti di controllare le limitazioni che hai creato è gestita dall'applicazione Impostazioni del sistema. Per mostrare all'utente le impostazioni di limitazione dell'app,
devi dichiarare le limitazioni fornite dall'app creando un BroadcastReceiver che riceve l'intent ACTION_GET_RESTRICTION_ENTRIES. Il sistema richiama questo intent per eseguire query su tutte le app per le limitazioni disponibili, quindi crea l'interfaccia utente per consentire all'utente principale di gestire le limitazioni per ogni profilo limitato.
Nel metodo onReceive() di BroadcastReceiver, devi creare un RestrictionEntry per ogni limitazione fornita dalla tua app. Ogni RestrictionEntry definisce un titolo e una descrizione della limitazione e uno dei seguenti tipi di dati:
TYPE_BOOLEANper una limitazione che è true o false.TYPE_CHOICEper una limitazione che ha più scelte che si escludono a vicenda (scelte dei pulsanti di opzione).TYPE_MULTI_SELECTper una limitazione che ha più opzioni che non si escludono a vicenda (opzioni di caselle di controllo).
Poi inserisci tutti gli oggetti RestrictionEntry in un ArrayList e inserisci quest'ultimo nel risultato del broadcast receiver come valore per l'extra EXTRA_RESTRICTIONS_LIST.
Il sistema crea l'interfaccia utente per le limitazioni della tua app nell'app Impostazioni e salva ogni
limitazione con la chiave univoca che hai fornito per ogni oggetto
RestrictionEntry. Quando l'utente apre la tua app, puoi eseguire una query per verificare la presenza di eventuali limitazioni attuali chiamando getApplicationRestrictions().
Viene restituito un Bundle contenente le coppie chiave-valore per ogni limitazione
definita con gli oggetti RestrictionEntry.
Se vuoi fornire limitazioni più specifiche che non possono essere gestite da valori booleani, a scelta singola e a scelta multipla, puoi creare un'attività in cui l'utente può specificare le limitazioni e consentire agli utenti di aprire l'attività dalle impostazioni delle limitazioni. Nel tuo broadcast receiver, includi l'extra EXTRA_RESTRICTIONS_INTENT nel risultato Bundle. Questo extra deve specificare un Intent che indica la classe Activity da avviare (utilizza il metodo putParcelable() per passare EXTRA_RESTRICTIONS_INTENT con l'intent).
Quando l'utente principale accede alla tua attività per impostare limitazioni personalizzate, l'attività deve restituire un risultato contenente i valori delle limitazioni in un extra utilizzando la chiave EXTRA_RESTRICTIONS_LIST o EXTRA_RESTRICTIONS_BUNDLE, a seconda che tu specifichi rispettivamente oggetti RestrictionEntry o coppie chiave-valore.
Supporto degli account in un profilo limitato
Tutti gli account aggiunti all'utente principale sono disponibili per un profilo limitato, ma non sono accessibili dalle API AccountManager per impostazione predefinita.
Se provi ad aggiungere un account con AccountManager mentre utilizzi un profilo
limitato, riceverai un risultato di errore. A causa di queste limitazioni, hai le seguenti tre opzioni:
Per accedere a un account da un profilo limitato, devi aggiungere l'attributo android:restrictedAccountType al tag <application>:
<application ... android:restrictedAccountType="com.example.account.type" >
Attenzione: l'attivazione di questo attributo consente alla tua app di accedere agli account dell'utente principale dai profili limitati. Pertanto, dovresti consentire questa opzione solo se le informazioni visualizzate dalla tua app non rivelano informazioni che consentono l'identificazione personale (PII) considerate sensibili. Le impostazioni di sistema informeranno l'utente principale che la tua app concede profili limitati ai suoi account, quindi dovrebbe essere chiaro all'utente che l'accesso all'account è importante per la funzionalità della tua app. Se possibile, devi anche fornire controlli di limitazione adeguati per l'utente principale che definiscano il livello di accesso all'account consentito nella tua app.
Se vuoi utilizzare gli account, ma non sono effettivamente necessari per la funzionalità principale della tua app, puoi verificare la disponibilità degli account e disattivare le funzionalità quando non sono disponibili.
Per prima cosa, controlla se è disponibile un account esistente. In caso contrario, verifica se è possibile creare un nuovo account chiamando getUserRestrictions() e controlla l'extra DISALLOW_MODIFY_ACCOUNTS nel risultato. Se è true,
devi disattivare qualsiasi funzionalità della tua app che richieda l'accesso agli account.
Ad esempio:
Kotlin
val um = context.getSystemService(Context.USER_SERVICE) as UserManager val restrictions: Bundle = um.userRestrictions if (restrictions.getBoolean(UserManager.DISALLOW_MODIFY_ACCOUNTS, false)) { // cannot add accounts, disable some functionality }
Java
UserManager um = (UserManager) context.getSystemService(Context.USER_SERVICE); Bundle restrictions = um.getUserRestrictions(); if (restrictions.getBoolean(UserManager.DISALLOW_MODIFY_ACCOUNTS, false)) { // cannot add accounts, disable some functionality }
Nota: in questo scenario, non devi dichiarare nuovi attributi nel file manifest.
Se invece è importante che la tua app non sia disponibile per i profili limitati perché
dipende da informazioni personali sensibili in un account (e perché i profili limitati
al momento non possono aggiungere nuovi account), aggiungi
l'attributo android:requiredAccountType al tag <application>:
<application ... android:requiredAccountType="com.example.account.type" >
Ad esempio, l'app Gmail utilizza questo attributo per disattivarsi per i profili limitati, perché l'email personale del proprietario non deve essere disponibile per i profili limitati.
Wireless e connettività
Bluetooth Low Energy (Smart Ready)
Android ora supporta Bluetooth Low Energy (LE) con nuove API in android.bluetooth.
Con le nuove API, puoi creare app per Android che comunicano con periferiche Bluetooth Low Energy, come cardiofrequenzimetri e pedometri.
Poiché Bluetooth LE è una funzionalità hardware non disponibile su tutti i dispositivi Android, devi dichiarare nel file manifest un elemento <uses-feature> per "android.hardware.bluetooth_le":
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />
Se hai già familiarità con le API Bluetooth Classic di Android, tieni presente che l'utilizzo delle API Bluetooth LE presenta alcune differenze. La cosa più importante è che ora esiste una classe BluetoothManager che dovresti utilizzare per alcune operazioni di alto livello, come l'acquisizione di un BluetoothAdapter, il recupero di un elenco di dispositivi connessi e il controllo dello stato di un dispositivo. Ad esempio, ecco come dovresti ottenere
BluetoothAdapter:
Kotlin
val bluetoothManager = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager bluetoothAdapter = bluetoothManager.adapter
Java
final BluetoothManager bluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE); bluetoothAdapter = bluetoothManager.getAdapter();
Per rilevare le periferiche Bluetooth LE, chiama startLeScan() su BluetoothAdapter, passando un'implementazione dell'interfaccia BluetoothAdapter.LeScanCallback. Quando l'adattatore Bluetooth rileva una periferica Bluetooth LE, l'implementazione di BluetoothAdapter.LeScanCallback riceve una chiamata al metodo onLeScan(). Questo metodo fornisce un oggetto BluetoothDevice che rappresenta il dispositivo rilevato, il valore RSSI del dispositivo e un array di byte contenente il record di annuncio del dispositivo.
Se vuoi eseguire la scansione solo di tipi specifici di periferiche, puoi invece chiamare startLeScan() e includere un array di oggetti UUID che specificano i servizi GATT supportati dalla tua app.
Nota: puoi cercare solo dispositivi Bluetooth LE o dispositivi Bluetooth Classic utilizzando le API precedenti. Non puoi cercare contemporaneamente dispositivi Bluetooth LE e Classic.
Per connetterti a una periferica Bluetooth LE, chiama connectGatt() sull'oggetto BluetoothDevice corrispondente, passandogli un'implementazione di BluetoothGattCallback. La tua implementazione di BluetoothGattCallback riceve callback relativi allo stato della connettività con il dispositivo e ad altri eventi. È durante il callback onConnectionStateChange()
che puoi iniziare a comunicare con il dispositivo se il metodo passa STATE_CONNECTED come nuovo stato.
L'accesso alle funzionalità Bluetooth su un dispositivo richiede inoltre che l'app richieda determinate autorizzazioni dell'utente Bluetooth. Per saperne di più, consulta la guida alle API Bluetooth Low Energy.
Modalità di sola scansione Wi-Fi
Quando tenta di identificare la posizione dell'utente, Android potrebbe utilizzare il Wi-Fi per determinare la posizione eseguendo la scansione dei punti di accesso nelle vicinanze. Tuttavia, gli utenti spesso tengono il Wi-Fi disattivato per risparmiare batteria, il che si traduce in dati sulla posizione meno accurati. Android ora include una modalità di sola scansione che consente al Wi-Fi del dispositivo di scansionare i punti di accesso per ottenere la posizione senza connettersi a un punto di accesso, riducendo così notevolmente l'utilizzo della batteria.
Se vuoi acquisire la posizione dell'utente, ma il Wi-Fi è attualmente disattivato, puoi chiedere all'utente di attivare la modalità di sola scansione Wi-Fi chiamando startActivity() con l'azione ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE.
Configurazione Wi-Fi
Le nuove API WifiEnterpriseConfig consentono ai servizi orientati alle aziende di automatizzare la configurazione Wi-Fi per i dispositivi gestiti.
Risposta rapida per le chiamate in arrivo
A partire da Android 4.0, una funzionalità chiamata "Risposta rapida" consente agli utenti di rispondere alle chiamate in arrivo con un messaggio immediato, senza dover rispondere alla chiamata o sbloccare il dispositivo.
Fino ad ora, questi messaggi rapidi venivano sempre gestiti dall'app di messaggistica predefinita. Ora qualsiasi app può dichiarare la propria capacità di gestire questi messaggi creando un Service con un filtro per intent per ACTION_RESPOND_VIA_MESSAGE.
Quando l'utente risponde a una chiamata in arrivo con una risposta rapida, l'app Telefono invia l'intent ACTION_RESPOND_VIA_MESSAGE con un URI che descrive il destinatario (il chiamante) e l'extra EXTRA_TEXT con il messaggio che l'utente vuole inviare. Quando il servizio riceve l'intent, deve recapitare il messaggio e interrompersi immediatamente (l'app non deve mostrare un'attività).
Per ricevere questo intent, devi dichiarare l'autorizzazione SEND_RESPOND_VIA_MESSAGE.
Multimediali
Miglioramenti di MediaExtractor e MediaCodec
Android ora semplifica la scrittura di player Dynamic Adaptive Streaming over HTTP (DASH) personalizzati in conformità allo standard ISO/IEC 23009-1, utilizzando le API esistenti in MediaCodec e MediaExtractor. Il framework alla base di queste API è stato aggiornato per supportare l'analisi dei file MP4 frammentati, ma l'app è comunque responsabile dell'analisi dei metadati MPD e del passaggio dei singoli stream a MediaExtractor.
Se vuoi utilizzare DASH con contenuti criptati, tieni presente che il metodo getSampleCryptoInfo() restituisce i metadati MediaCodec.CryptoInfo che descrivono la struttura di ogni campione multimediale criptato. Inoltre, il metodo getPsshInfo() è stato aggiunto a MediaExtractor per consentirti di accedere ai metadati PSSH per i tuoi contenuti multimediali DASH.
Questo metodo restituisce una mappa di oggetti UUID in byte, con UUID che specifica lo schema di crittografia e i byte che rappresentano i dati specifici di questo schema.
DRM multimediale
La nuova classe MediaDrm fornisce una soluzione modulare per la gestione dei diritti digitali (DRM) con i tuoi contenuti multimediali, separando i problemi relativi al DRM dalla riproduzione dei contenuti multimediali. Ad esempio, questa separazione delle API ti consente di riprodurre contenuti criptati con Widevine senza dover utilizzare il formato multimediale Widevine. Questa soluzione DRM supporta anche DASH Common Encryption, così puoi utilizzare una serie di schemi DRM con i tuoi contenuti in streaming.
Puoi utilizzare MediaDrm per ottenere messaggi di richiesta di chiave opachi ed elaborare i messaggi di risposta di chiave dal server per l'acquisizione e il provisioning delle licenze. La tua app è responsabile della gestione della comunicazione di rete con i server; la classe MediaDrm fornisce solo la possibilità di generare ed elaborare i messaggi.
Le API MediaDrm sono destinate a essere utilizzate insieme alle API MediaCodec introdotte in Android 4.1 (livello API 16), tra cui MediaCodec per la codifica e la decodifica dei contenuti, MediaCrypto per la gestione dei contenuti criptati e MediaExtractor per l'estrazione e il demux dei contenuti.
Devi prima creare gli oggetti MediaExtractor e MediaCodec. Puoi quindi accedere al UUID che identifica lo schema DRM, in genere dai metadati nei contenuti, e utilizzarlo per creare un'istanza di un oggetto MediaDrm con il relativo costruttore.
Codifica video da una superficie
Android 4.1 (livello API 16) ha aggiunto la classe MediaCodec per la codifica e la decodifica di basso livello dei contenuti multimediali. Durante la codifica dei video, Android 4.1 richiedeva di fornire
i contenuti multimediali con un array ByteBuffer, ma Android 4.3 ora consente di utilizzare un Surface come input per un codificatore. Ad esempio, questo ti consente di codificare l'input da un file video esistente o utilizzando i frame generati da OpenGL ES.
Per utilizzare un Surface come input per l'encoder, chiama prima configure() per il tuo MediaCodec.
Poi chiama createInputSurface() per ricevere l'oggetto Surface su cui puoi riprodurre in streaming i tuoi contenuti multimediali.
Ad esempio, puoi utilizzare l'oggetto Surface fornito come finestra per un contesto OpenGL passandolo a eglCreateWindowSurface(). Poi, durante il rendering della superficie, chiama eglSwapBuffers() per passare il frame a MediaCodec.
Per iniziare la codifica, chiama start() su MediaCodec. Al termine, chiama signalEndOfInputStream() per terminare la codifica e chiama release() su Surface.
Muxing dei contenuti multimediali
La nuova classe MediaMuxer consente il multiplexing tra uno stream audio
e uno stream video. Queste API fungono da controparte della classe MediaExtractor aggiunta in Android 4.2 per il demultiplexing (demuxing) dei contenuti multimediali.
I formati di output supportati sono definiti in MediaMuxer.OutputFormat. Al momento, MP4 è l'unico formato di output supportato e MediaMuxer supporta un solo stream audio e/o un solo stream video alla volta.
MediaMuxer è progettato principalmente per funzionare con MediaCodec,
in modo da poter eseguire l'elaborazione video tramite MediaCodec e poi salvare l'output in un file MP4 tramite MediaMuxer. Puoi anche utilizzare MediaMuxer in combinazione con MediaExtractor per eseguire l'editing di contenuti multimediali senza doverli codificare o decodificare.
Avanzamento della riproduzione e scrubbing per RemoteControlClient
In Android 4.0 (livello API 14), è stato aggiunto RemoteControlClient per attivare i controlli di riproduzione multimediale dai client di controllo remoto, come i controlli disponibili nella schermata di blocco. Android 4.3 ora offre la possibilità di visualizzare la posizione di riproduzione e i controlli per lo scrubbing della riproduzione. Se hai attivato il controllo remoto per la tua app multimediale con le API RemoteControlClient, puoi consentire lo scrubbing della riproduzione implementando due nuove interfacce.
Innanzitutto, devi attivare il flag FLAG_KEY_MEDIA_POSITION_UPDATE passandolo a setTransportControlsFlags().
Poi implementa le seguenti due nuove interfacce:
RemoteControlClient.OnGetPlaybackPositionListener- Ciò include il callback
onGetPlaybackPosition(), che richiede la posizione corrente dei tuoi contenuti multimediali quando il telecomando deve aggiornare l'avanzamento nella sua UI. RemoteControlClient.OnPlaybackPositionUpdateListener- È incluso il callback
onPlaybackPositionUpdate(), che comunica alla tua app il nuovo timecode dei contenuti multimediali quando l'utente scorre la riproduzione con l'interfaccia utente del telecomando.Una volta aggiornata la riproduzione con la nuova posizione, chiama
setPlaybackState()per indicare il nuovo stato, la nuova posizione e la nuova velocità di riproduzione.
Una volta definite queste interfacce, puoi impostarle per RemoteControlClient chiamando rispettivamente setOnGetPlaybackPositionListener() e
setPlaybackPositionUpdateListener().
Grafica
Supporto per OpenGL ES 3.0
Android 4.3 aggiunge interfacce Java e il supporto nativo per OpenGL ES 3.0. Le nuove funzionalità principali fornite in OpenGL ES 3.0 includono:
- Accelerazione degli effetti visivi avanzati
- Compressione delle texture ETC2/EAC di alta qualità come funzionalità standard
- Una nuova versione del linguaggio di shading GLSL ES con supporto di numeri interi e rappresentazione in virgola mobile a 32 bit
- Rendering avanzato delle texture
- Standardizzazione più ampia delle dimensioni delle texture e dei formati dei buffer di rendering
L'interfaccia Java per OpenGL ES 3.0 su Android è fornita con GLES30.
Quando utilizzi OpenGL ES 3.0, assicurati di dichiararlo nel file manifest con il tag <uses-feature> e l'attributo android:glEsVersion. Ad esempio:
<manifest>
<uses-feature android:glEsVersion="0x00030000" />
...
</manifest>Ricorda di specificare il contesto OpenGL ES chiamando setEGLContextClientVersion() e passando 3 come versione.
Per saperne di più sull'utilizzo di OpenGL ES, incluso come controllare la versione di OpenGL ES supportata dal dispositivo in fase di runtime, consulta la guida all'API OpenGL ES.
Mipmapping per i drawable
L'utilizzo di una mipmap come origine per la bitmap o l'elemento drawable è un modo semplice per fornire un'immagine di qualità e varie scale di immagini, il che può essere particolarmente utile se prevedi che l'immagine venga ridimensionata durante un'animazione.
Android 4.2 (livello API 17) ha aggiunto il supporto per i mipmap nella classe Bitmap: Android scambia le immagini mip nel tuo Bitmap quando hai fornito un'origine mipmap e hai attivato setHasMipMap(). Ora, in Android 4.3, puoi attivare i mipmap anche per un oggetto BitmapDrawable, fornendo un asset mipmap e impostando l'attributo android:mipMap in un file di risorse bitmap o chiamando hasMipMap().
Interfaccia utente
Visualizza overlay
La nuova classe ViewOverlay fornisce un livello trasparente sopra un View su cui puoi aggiungere contenuti visivi e che non influisce sulla gerarchia del layout. Puoi ottenere un ViewOverlay per qualsiasi View chiamando il numero getOverlay(). L'overlay ha sempre le stesse dimensioni e la stessa posizione della visualizzazione host (la visualizzazione da cui è stato creato), consentendoti di aggiungere contenuti che vengono visualizzati davanti alla visualizzazione host, ma che non possono estendere i limiti della visualizzazione host.
L'utilizzo di un ViewOverlay è particolarmente utile quando vuoi creare animazioni come lo scorrimento di una visualizzazione all'esterno del relativo contenitore o lo spostamento di elementi sullo schermo senza influire sulla gerarchia di oggetti View. Tuttavia, poiché l'area utilizzabile di un overlay è limitata alla stessa area della vista host, se vuoi animare una vista che si sposta al di fuori della sua posizione nel layout, devi utilizzare un overlay di una vista genitore con i limiti di layout desiderati.
Quando crei un overlay per una visualizzazione widget come Button, puoi aggiungere oggetti Drawable all'overlay chiamando add(Drawable). Se chiami getOverlay() per una visualizzazione layout, ad esempio RelativeLayout, l'oggetto restituito è un ViewGroupOverlay. La classe ViewGroupOverlay è una sottoclasse di ViewOverlay che consente anche di aggiungere oggetti View chiamando add(View).
Nota: tutti gli elementi drawable e le visualizzazioni che aggiungi a un overlay sono solo visivi. Non possono ricevere eventi di attivazione o di input.
Ad esempio, il seguente codice anima una vista che scorre verso destra posizionandola nell'overlay della vista genitore, quindi eseguendo un'animazione di traslazione su quella vista:
Kotlin
val view: View? = findViewById(R.id.view_to_remove) val container: ViewGroup? = view?.parent as ViewGroup container?.apply { overlay.add(view) ObjectAnimator.ofFloat(view, "translationX", right.toFloat()) .start() }
Java
View view = findViewById(R.id.view_to_remove); ViewGroup container = (ViewGroup) view.getParent(); container.getOverlay().add(view); ObjectAnimator anim = ObjectAnimator.ofFloat(view, "translationX", container.getRight()); anim.start();
Layout dei limiti ottici
Per le visualizzazioni che contengono immagini di sfondo nine-patch, ora puoi specificare che devono essere allineate alle visualizzazioni adiacenti in base ai limiti "ottici" dell'immagine di sfondo anziché ai limiti "clip" della visualizzazione.
Ad esempio, le figure 1 e 2 mostrano lo stesso layout, ma la versione nella figura 1 utilizza i limiti di ritaglio (il comportamento predefinito), mentre la figura 2 utilizza i limiti ottici. Poiché le immagini nine-patch utilizzate per il pulsante e la cornice della foto includono una spaziatura interna attorno ai bordi, non sembrano allinearsi tra loro o con il testo quando si utilizzano i limiti di ritaglio.
Nota: lo screenshot nelle figure 1 e 2 ha l'impostazione sviluppatore "Mostra limiti layout" attivata. Per ogni visualizzazione, le linee rosse indicano i limiti ottici, le linee blu indicano i limiti di ritaglio e il rosa indica i margini.
Figura 1. Layout che utilizza i limiti di ritaglio (impostazione predefinita).
Figura 2. Layout che utilizza i limiti ottici.
Per allineare le visualizzazioni in base ai relativi limiti ottici, imposta l'attributo android:layoutMode su "opticalBounds" in uno dei layout principali. Ad esempio:
<LinearLayout android:layoutMode="opticalBounds" ... >
Figura 3. Visualizzazione ingrandita del nine-patch del pulsante Holo con limiti ottici.
Affinché ciò funzioni, le immagini nine-patch applicate allo sfondo delle visualizzazioni devono specificare i limiti ottici utilizzando linee rosse lungo la parte inferiore e il lato destro del file nine-patch (come mostrato nella figura 3). Le linee rosse indicano la regione che deve essere sottratta dai limiti di ritaglio, lasciando i limiti ottici dell'immagine.
Quando attivi i limiti ottici per un ViewGroup nel layout, tutte le visualizzazioni discendenti ereditano la modalità di layout dei limiti ottici, a meno che non la sostituisci per un gruppo impostando android:layoutMode su "clipBounds". Inoltre, tutti gli elementi di layout rispettano i limiti ottici delle relative viste secondarie, adattando i propri limiti in base ai limiti ottici delle viste al loro interno. Tuttavia, gli elementi di layout (sottoclassi di ViewGroup)
al momento non supportano i limiti ottici per le immagini nine-patch applicate al proprio sfondo.
Se crei una visualizzazione personalizzata creando una sottoclasse di View, ViewGroup o di una qualsiasi delle relative sottoclassi, la visualizzazione erediterà questi comportamenti dei limiti ottici.
Nota: tutti i widget supportati dal tema Holo sono stati aggiornati con i limiti ottici, inclusi Button, Spinner, EditText e altri. Pertanto, puoi trarre vantaggio immediatamente impostando l'attributo android:layoutMode su "opticalBounds" se la tua app applica un tema Holo (Theme.Holo, Theme.Holo.Light e così via).
Per specificare i limiti ottici per le tue immagini nine-patch con lo strumento Draw 9-patch, tieni premuto Control quando fai clic sui pixel del bordo.
Animazione per i valori Rect
Ora puoi animare tra due valori Rect con il nuovo RectEvaluator. Questa nuova classe è un'implementazione di TypeEvaluator che puoi passare a ValueAnimator.setEvaluator().
Listener di collegamento e attivazione della finestra
In precedenza, se volevi ascoltare quando la visualizzazione veniva collegata/scollegata dalla finestra o quando lo stato attivo cambiava, dovevi eseguire l'override della classe View per implementare rispettivamente onAttachedToWindow() e onDetachedFromWindow() o onWindowFocusChanged().
Ora, per ricevere gli eventi di collegamento e scollegamento, puoi implementare ViewTreeObserver.OnWindowAttachListener e impostarlo su una visualizzazione con
addOnWindowAttachListener().
Per ricevere eventi di stato attivo, puoi implementare ViewTreeObserver.OnWindowFocusChangeListener e impostarlo su una visualizzazione con addOnWindowFocusChangeListener().
Supporto dell'overscan della TV
Per assicurarti che la tua app riempia l'intero schermo su ogni TV, ora puoi attivare l'overscan per il layout dell'app. La modalità overscan è determinata dal flag FLAG_LAYOUT_IN_OVERSCAN, che puoi attivare con i temi della piattaforma come
Theme_DeviceDefault_NoActionBar_Overscan o attivando lo stile
windowOverscan in un tema personalizzato.
Orientamento schermo
L'attributo screenOrientation del tag <activity> ora supporta valori aggiuntivi per rispettare la preferenza dell'utente per la rotazione automatica:
"userLandscape"- Si comporta come
"sensorLandscape", tranne se l'utente disattiva la rotazione automatica, nel qual caso si blocca nell'orientamento orizzontale normale e non si capovolge. "userPortrait"- Si comporta come
"sensorPortrait", tranne per il fatto che se l'utente disattiva la rotazione automatica, il dispositivo si blocca nell'orientamento verticale normale e non si capovolge. "fullUser"- Si comporta come
"fullSensor"e consente la rotazione in tutte e quattro le direzioni, a meno che l'utente non disattivi la rotazione automatica, nel qual caso si blocca nell'orientamento preferito dell'utente.
Inoltre, ora puoi anche dichiarare "locked" per bloccare l'orientamento della tua app nell'orientamento corrente dello schermo.
Animazioni di rotazione
Il nuovo campo rotationAnimation in WindowManager ti consente di scegliere tra tre animazioni da utilizzare quando il sistema cambia l'orientamento dello schermo. Le tre animazioni sono:
Nota: queste animazioni sono disponibili solo se hai impostato l'attività in modo che utilizzi la modalità "fullscreen", che puoi attivare con temi come Theme.Holo.NoActionBar.Fullscreen.
Ad esempio, ecco come attivare l'animazione "dissolvenza incrociata":
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val params: WindowManager.LayoutParams = window.attributes params.rotationAnimation = WindowManager.LayoutParams.ROTATION_ANIMATION_CROSSFADE window.attributes = params ... }
Java
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); WindowManager.LayoutParams params = getWindow().getAttributes(); params.rotationAnimation = WindowManager.LayoutParams.ROTATION_ANIMATION_CROSSFADE; getWindow().setAttributes(params); ... }
Input dell'utente
Nuovi tipi di sensori
Il nuovo sensore TYPE_GAME_ROTATION_VECTOR ti consente di rilevare le rotazioni del dispositivo senza preoccuparti delle interferenze magnetiche. A differenza del sensore TYPE_ROTATION_VECTOR, il sensore TYPE_GAME_ROTATION_VECTOR non si basa sul nord magnetico.
I nuovi sensori TYPE_GYROSCOPE_UNCALIBRATED e TYPE_MAGNETIC_FIELD_UNCALIBRATED forniscono dati dei sensori non elaborati senza
considerare le stime di bias. In altre parole, i sensori TYPE_GYROSCOPE e TYPE_MAGNETIC_FIELD esistenti forniscono dati dei sensori che tengono conto della deviazione stimata rispettivamente dalla deriva del giroscopio e dal ferro duro nel dispositivo. Le nuove versioni "non calibrate" di questi sensori, invece, forniscono i dati dei sensori non elaborati e offrono i valori di bias stimati separatamente. Questi sensori ti consentono di fornire una calibrazione personalizzata per i dati dei sensori migliorando la distorsione stimata con dati esterni.
Listener di notifica
Android 4.3 aggiunge una nuova classe di servizio, NotificationListenerService, che consente alla tua app di ricevere informazioni sulle nuove notifiche man mano che vengono pubblicate dal sistema.
Se la tua app attualmente utilizza le API del servizio di accessibilità per accedere alle notifiche di sistema, devi aggiornarla in modo che utilizzi queste API.
Provider di contatti
Query per "contattabili"
La nuova query del Provider di contatti, Contactables.CONTENT_URI, fornisce un modo efficiente per ottenere un Cursor che contiene tutti gli indirizzi email e i numeri di telefono appartenenti a tutti i contatti corrispondenti alla query specificata.
Esegui query per i delta dei contatti
Al Provider di contatti sono state aggiunte nuove API che ti consentono di eseguire query in modo efficiente sulle modifiche recenti ai dati dei contatti. In precedenza, la tua app poteva ricevere una notifica quando qualcosa nei dati dei contatti cambiava, ma non sapevi esattamente cosa fosse cambiato e dovevi recuperare tutti i contatti e poi scorrerli per scoprire la modifica.
Per monitorare le modifiche agli inserimenti e agli aggiornamenti, ora puoi includere il parametro CONTACT_LAST_UPDATED_TIMESTAMP nella selezione per eseguire query solo sui contatti che sono stati modificati dall'ultima volta che hai eseguito una query sul provider.
Per monitorare i contatti eliminati, la nuova tabella ContactsContract.DeletedContacts fornisce un log dei contatti eliminati (ma ogni contatto eliminato viene conservato in questa tabella per un periodo di tempo limitato). Analogamente a CONTACT_LAST_UPDATED_TIMESTAMP, puoi utilizzare il nuovo parametro di selezione CONTACT_DELETED_TIMESTAMP per verificare quali contatti sono stati eliminati dall'ultima volta che hai eseguito una query sul provider. La tabella contiene anche la costante DAYS_KEPT_MILLISECONDS contenente il numero di giorni (in millisecondi) per i quali verrà conservato il log.
Inoltre, il Provider di contatti ora trasmette l'azione CONTACTS_DATABASE_CREATED quando l'utente
cancella lo spazio di archiviazione dei contatti tramite il menu delle impostazioni di sistema, ricreando di fatto il
database del Provider di contatti. Lo scopo è segnalare alle app che devono eliminare tutti i dati di contatto memorizzati e ricaricarli con una nuova query.
Per un codice campione che utilizza queste API per verificare la presenza di modifiche ai contatti, consulta l'esempio ApiDemos disponibile nel download degli esempi dell'SDK.
Localizzazione
Supporto migliorato per il testo bidirezionale
Le versioni precedenti di Android supportano le lingue e il layout con scrittura da destra a sinistra (RTL),
ma a volte non gestiscono correttamente il testo con direzione mista. Per questo motivo, Android 4.3 aggiunge le API BidiFormatter che ti aiutano a formattare correttamente il testo con contenuti con direzione opposta senza alterarne alcuna parte.
Ad esempio, se vuoi creare una frase con una variabile stringa, come "Volevi dire
15 Bay Street, Laurel, CA?", normalmente passi una risorsa stringa localizzata e la variabile a
String.format():
Kotlin
val suggestion = String.format(resources.getString(R.string.did_you_mean), address)
Java
Resources res = getResources(); String suggestion = String.format(res.getString(R.string.did_you_mean), address);
Tuttavia, se le impostazioni internazionali sono l'ebraico, la stringa formattata viene visualizzata in questo modo:
האם התכוונת ל 15 Bay Street, Laurel, CA?
Questo è sbagliato perché "15" dovrebbe essere a sinistra di "Bay Street". La soluzione è utilizzare BidiFormatter e il relativo metodo unicodeWrap(). Ad esempio, il codice riportato sopra diventa:
Kotlin
val bidiFormatter = BidiFormatter.getInstance() val suggestion = String.format( resources.getString(R.string.did_you_mean), bidiFormatter.unicodeWrap(address) )
Java
Resources res = getResources(); BidiFormatter bidiFormatter = BidiFormatter.getInstance(); String suggestion = String.format(res.getString(R.string.did_you_mean), bidiFormatter.unicodeWrap(address));
Per impostazione predefinita, unicodeWrap() utilizza l'euristica di stima della direzionalità first-strong, che può commettere errori se il primo indicatore della direzione del testo non rappresenta la direzione appropriata per i contenuti nel loro complesso.
Se necessario, puoi specificare un'euristica diversa passando una delle costanti TextDirectionHeuristic da TextDirectionHeuristics
a unicodeWrap().
Nota: Queste nuove API sono disponibili anche per le versioni precedenti di Android tramite la libreria di supporto Android , con la classe BidiFormatter e le API correlate.
Servizi di accessibilità
Gestisci gli eventi chiave
Un AccessibilityService ora può ricevere un callback per gli eventi di input da tastiera con il metodo di callback onKeyEvent(). In questo modo, il servizio di accessibilità può gestire l'input per i dispositivi di input basati su tasti, come una tastiera, e tradurre questi eventi in azioni speciali che in precedenza potevano essere possibili solo con l'input tocco o il tastierino direzionale del dispositivo.
Seleziona il testo e copialo/incollalo
AccessibilityNodeInfo ora fornisce API che consentono a un AccessibilityService di selezionare, tagliare, copiare e incollare il testo in un nodo.
Per specificare la selezione di testo da tagliare o copiare, il tuo servizio di accessibilità può utilizzare la nuova azione ACTION_SET_SELECTION, passando con questa la posizione di inizio e di fine della selezione con ACTION_ARGUMENT_SELECTION_START_INT e ACTION_ARGUMENT_SELECTION_END_INT.
In alternativa, puoi selezionare il testo manipolando la posizione del cursore utilizzando l'azione esistente, ACTION_NEXT_AT_MOVEMENT_GRANULARITY (in precedenza solo per spostare la posizione del cursore), e aggiungendo l'argomento ACTION_ARGUMENT_EXTEND_SELECTION_BOOLEAN.
Puoi quindi tagliare o copiare con ACTION_CUT,
ACTION_COPY, quindi incollare in un secondo momento con
ACTION_PASTE.
Nota: queste nuove API sono disponibili anche per le versioni precedenti di Android tramite la libreria di supporto Android, con la classe AccessibilityNodeInfoCompat.
Dichiara le funzioni di accessibilità
A partire da Android 4.3, un servizio di accessibilità deve dichiarare le funzionalità di accessibilità nel file di metadati per poter utilizzare determinate funzioni di accessibilità. Se la funzionalità non viene richiesta nel file di metadati, non verrà eseguita alcuna operazione. Per dichiarare le funzionalità di accessibilità del tuo servizio, devi utilizzare attributi XML che corrispondono alle varie costanti "capability" nella classe AccessibilityServiceInfo.
Ad esempio, se un servizio non richiede la funzionalità flagRequestFilterKeyEvents,
non riceverà gli eventi chiave.
Test e debug
Test automatici della UI
La nuova classe UiAutomation fornisce API che ti consentono di simulare le azioni degli utenti per l'automazione dei test. Utilizzando le API AccessibilityService della piattaforma, le API UiAutomation
ti consentono di ispezionare i contenuti dello schermo e inserire eventi touch e da tastiera arbitrari.
Per ottenere un'istanza di UiAutomation, chiama Instrumentation.getUiAutomation(). Affinché questa operazione funzioni, devi fornire l'opzione -w con il comando instrument quando esegui InstrumentationTestCase da adb shell.
Con l'istanza UiAutomation, puoi eseguire eventi arbitrari per testare la tua app chiamando executeAndWaitForEvent(), passando un Runnable da eseguire, un periodo di timeout per l'operazione e un'implementazione dell'interfaccia UiAutomation.AccessibilityEventFilter. È all'interno dell'implementazione di UiAutomation.AccessibilityEventFilter che riceverai una chiamata che ti consente di filtrare gli eventi che ti interessano e determinare l'esito positivo o negativo di un determinato scenario di test.
Per osservare tutti gli eventi durante un test, crea un'implementazione di UiAutomation.OnAccessibilityEventListener e passala a setOnAccessibilityEventListener().
L'interfaccia del listener riceve quindi una chiamata a onAccessibilityEvent()
ogni volta che si verifica un evento, ricevendo un oggetto AccessibilityEvent
che descrive l'evento.
Esistono diverse altre operazioni che le API UiAutomation espongono a un livello molto basso per incoraggiare lo sviluppo di strumenti di test dell'interfaccia utente come uiautomator. Ad esempio, UiAutomation può anche:
- Inserisci eventi di input
- Modificare l'orientamento dello schermo
- Acquisire screenshot
Inoltre, cosa più importante per gli strumenti di test della UI, le API UiAutomation funzionano
oltre i confini delle applicazioni, a differenza di quelle in Instrumentation.
Eventi Systrace per le app
Android 4.3 aggiunge la classe Trace con due metodi statici,
beginSection() e endSection(),
che ti consentono di definire blocchi di codice da includere nel report di Systrace. Creando sezioni di codice tracciabile nella tua app, i log di systrace ti forniscono un'analisi molto più dettagliata di dove si verificano i rallentamenti all'interno dell'app.
Per informazioni sull'utilizzo dello strumento Systrace, leggi Analisi della visualizzazione e delle prestazioni con Systrace.
Sicurezza
Archivio chiavi Android per le chiavi private delle app
Android ora offre un provider di sicurezza Java personalizzato nella funzionalità KeyStore, chiamato Android Key Store, che ti consente di generare e salvare chiavi private che possono essere visualizzate e utilizzate solo dalla tua app. Per caricare Android Key Store, passa "AndroidKeyStore" a KeyStore.getInstance().
Per gestire le credenziali private della tua app nell'Android Key Store, genera una nuova chiave con
KeyPairGenerator con KeyPairGeneratorSpec. Innanzitutto,
recupera un'istanza di KeyPairGenerator chiamando getInstance(). Poi chiama initialize(), passando un'istanza di KeyPairGeneratorSpec, che puoi ottenere utilizzando KeyPairGeneratorSpec.Builder.
Infine, ottieni il tuo KeyPair chiamando generateKeyPair().
Archivio credenziali hardware
Ora Android supporta anche l'archiviazione con integrazione hardware per le tue credenziali KeyChain, offrendo una maggiore sicurezza rendendo le chiavi non disponibili per l'estrazione. In altre parole, una volta che le chiavi si trovano in un archivio chiavi con integrazione hardware (Secure Element, TPM o TrustZone), possono essere utilizzate per operazioni crittografiche, ma il materiale della chiave privata non può essere esportato. Nemmeno il kernel del sistema operativo può accedere a questo materiale della chiave. Sebbene non tutti i dispositivi Android supportino l'archiviazione su hardware, puoi verificare in fase di runtime se è disponibile l'archiviazione con crittografia hardware chiamando KeyChain.IsBoundKeyAlgorithm().
Dichiarazioni del manifest
Funzionalità obbligatorie dichiarabili
I seguenti valori sono ora supportati nell'elemento <uses-feature>, in modo da garantire che la tua app venga installata solo sui dispositivi che forniscono le funzionalità di cui ha bisogno.
FEATURE_APP_WIDGETS- Dichiara che la tua app fornisce un widget dell'app e deve essere installata solo su dispositivi che includono una schermata Home o una posizione simile in cui gli utenti possono incorporare i widget dell'app.
Esempio:
<uses-feature android:name="android.software.app_widgets" android:required="true" />
FEATURE_HOME_SCREEN- Dichiara che la tua app si comporta come un sostituto della schermata Home e deve essere installata solo su
dispositivi che supportano app per la schermata Home di terze parti.
Esempio:
<uses-feature android:name="android.software.home_screen" android:required="true" />
FEATURE_INPUT_METHODS- Dichiara che la tua app fornisce un metodo di immissione personalizzato (una tastiera creata con
InputMethodService) e deve essere installata solo su dispositivi che supportano metodi di immissione di terze parti. Esempio:<uses-feature android:name="android.software.input_methods" android:required="true" />
FEATURE_BLUETOOTH_LE- Dichiara che la tua app utilizza le API Bluetooth Low Energy e deve essere installata solo su dispositivi
in grado di comunicare con altri dispositivi tramite Bluetooth Low Energy.
Esempio:
<uses-feature android:name="android.software.bluetooth_le" android:required="true" />
Autorizzazioni dell'utente
I seguenti valori sono ora supportati in <uses-permission> per dichiarare le autorizzazioni richieste dalla tua app per accedere a determinate API.
BIND_NOTIFICATION_LISTENER_SERVICE- Obbligatorio per utilizzare le nuove API
NotificationListenerService. SEND_RESPOND_VIA_MESSAGE- Obbligatorio per ricevere l'intent
ACTION_RESPOND_VIA_MESSAGE.
Per una visualizzazione dettagliata di tutte le modifiche alle API in Android 4.3, consulta il report sulle differenze delle API.