Preparare l'app per i cambiamenti del comportamento in Wear OS 4

Wear OS 4 è basato su Android 13 (livello API 33), che è di diverse versioni superiore a quella su cui è basato Wear OS 3, Android 11 (livello API 30). Di conseguenza, quando prepari la tua app Wear OS per l'utilizzo su Wear OS 4, devi gestire le modifiche del comportamento del sistema che vengono applicate a tutte le app in Android 12 e Android 13.

Puoi migliorare ulteriormente la compatibilità della tua app con questa versione di Wear OS scegliendo come target Android 13 (livello API 33).

Modifiche alle autorizzazioni

Le seguenti modifiche relative alle autorizzazioni hanno maggiori probabilità di interessare la tua app Wear OS su un dispositivo con Wear OS 4.

Autorizzazione alle notifiche

L'opzione Consenti è il primo pulsante nella finestra di dialogo
Figura 1. La finestra di dialogo delle autorizzazioni di sistema che chiede agli utenti di consentire alla tua app Wear OS di pubblicare notifiche. Gli utenti possono scegliere tra Consenti e Non consentire.

Nella maggior parte dei casi, gli utenti devono concedere un'autorizzazione di runtime per le notifiche alla tua app, anche quando l'app pubblica notifiche relative alle attività in corso.

Nota : l'autorizzazione alle notifiche non si applica alle notifiche in modalità bridge, così come a diversi casi d'uso specifici esenti, ad esempio quelli relativi alle sessioni multimediali.

Quando gli utenti installano la tua app su un dispositivo con Wear OS 4, le notifiche dell'app sono disattivate per impostazione predefinita. Prima di pubblicare una notifica locale o di avviare un'attività in corso, controlla se la tua app può pubblicare notifiche chiamando areNotificationsEnabled(). Se questo metodo restituisce true, la tua app può mostrare le notifiche. Se l'app non dispone dell'autorizzazione appropriata, queste notifiche vengono disattivate silenziosamente senza la generazione di eccezioni di runtime.

Quando richiedi l'autorizzazione POST_NOTIFICATIONS nell'app, gli utenti visualizzano la finestra di dialogo delle autorizzazioni di sistema che appare nella figura 1.

Autorizzazione sensori del corpo in background

Su un dispositivo con Wear OS 4, gli utenti devono concedere alla tua app l'autorizzazione a ricevere in background informazioni dai sensori del corpo più comuni, come la frequenza cardiaca.

Scopri di più nella guida su come richiedere l'accesso in background ai dati dei sensori del corpo.

Autorizzazione di accesso alla posizione approssimativa

Su un dispositivo con Wear OS 4, gli utenti possono richiedere che la tua app recuperi solo informazioni sulla posizione approssimative, anche quando richiede l'autorizzazione di ACCESS_FINE_LOCATION runtime.

Verifica che la tua app sia comunque in grado di soddisfare i suoi casi d'uso principali, ad esempio la visualizzazione di un percorso in esecuzione, se l'utente concede solo la posizione approssimativa. In particolare, quando utilizzi Health Services su Wear OS, prendi in considerazione gli errori di posizione.

Scopri di più su come l'utente può concedere solo la posizione approssimativa.

Modifiche ai componenti delle app e alla navigazione

Le seguenti modifiche relative ai componenti dell'app e alla navigazione hanno maggiori probabilità di influire sulla tua app per Wear OS su un dispositivo con Wear OS 4.

I filtri per intent bloccano gli intent non corrispondenti

Quando la tua app invia un intent a un componente esportato di un'altra app che ha come target Android 13 o versioni successive, questo intent viene pubblicato solo se corrisponde a un elemento <intent-filter> nell'app ricevente.

Scopri come associare gli intent ai filtri per intent di altre app.

Comportamento attività Avvio app root

Un'attività di avvio è la principale di un'attività se dichiara un filtro per intent che include sia ACTION_MAIN sia CATEGORY_LAUNCHER.

Se l'utente abbandona questo tipo di attività di Avvio applicazioni alla schermata precedente, il sistema non termina l'attività di Avvio applicazioni. L'attività di avvio viene mostrata invece in background.

Scopri di più su questa modifica alle attività di avvio applicazioni root e al ciclo di vita delle attività.

Il sistema apporta diverse modifiche alla modalità di verifica dei link per app Android. In particolare, il sistema applica una sintassi più rigida dei filtri per intent per dimostrare che gli URL di un determinato dominio devono aprire i contenuti direttamente nell'app. Queste modifiche migliorano l'affidabilità dell'esperienza di collegamento delle app, offrendo maggiore controllo agli sviluppatori di app e agli utenti finali.

Per testare l'affidabilità delle tue dichiarazioni, richiama manualmente la verifica del dominio.

L'UI della finestra di avviso del sistema è stata rimossa

Wear OS 4 rimuove l'interfaccia utente di sistema per concedere l'autorizzazione SYSTEM_ALERT_WINDOW. Questa UI è disponibile su alcuni dispositivi con Wear OS 3 e versioni precedenti.

Se utilizzi ACTION_MANAGE_OVERLAY_PERMISSION per indirizzare gli utenti a una pagina delle impostazioni, dove potrebbero mostrare la tua app rispetto ad altre app, aggiorna la logica dell'app. Ad esempio, se utilizzi le finestre di avviso di sistema per mostrare i messaggi importanti, utilizza invece le notifiche.

Modifiche alla gestione dell'alimentazione e dei dati

È molto probabile che le seguenti modifiche relative all'alimentazione e alla gestione dei dati influiscano sulla tua app per Wear OS su un dispositivo con Wear OS 4.

Bucket app in standby limitato

Il sistema inserisce la tua app nel bucket di standby dell'app"limitato" se non viene utilizzata per un periodo di tempo prolungato o se richiama un numero eccessivo di trasmissioni e associazioni.

Ibernazione dell'app

Se l'utente non interagisce con la tua app per alcuni mesi, il sistema mette la tua app in stato di ibernazione.

Backup e ripristino

A partire da Wear OS 4, se un dispositivo Wear OS specifico supporta il backup sul cloud, gli utenti possono eseguire il backup dei dati sul cloud per trasferirli al di fuori del dispositivo e ripristinare i dati dal cloud per trasferirli su un nuovo dispositivo Wear OS.