Wear OS 5.1

Esplora l'ultima versione di Wear OS, disponibile su alcuni dispositivi e nell'emulatore ufficiale di Android Studio. Verifica che la tua app funzioni come previsto dopo aver aggiornato la versione dell'SDK target.

Wear OS 5.1 si basa su Android 15 (livello API 35), il che richiede di testare le tue app che hanno già come target il livello API 34 per Wear OS 5.

Preparare un dispositivo supportato per i test

Wear OS 5.1 può essere eseguito sui seguenti dispositivi:

• Google Pixel Watch 3
• Google Pixel Watch 2
• Google Pixel Watch

Il dispositivo dovrebbe ricevere un aggiornamento software over-the-air (OTA). Puoi anche aggiornare manualmente il dispositivo eseguendo una delle seguenti operazioni:

• Dall'app Impostazioni, vai a Sistema > Aggiornamenti di sistema.
• Dopo aver attivato le opzioni sviluppatore, carica un'immagine software specifica sui dispositivi che supportano una connessione dati USB (cablata). Ad esempio, puoi installare un'immagine di fabbrica o un'immagine OTA completa.

Preparare l'emulatore per i test

Per eseguire Wear OS 5.1 nell'emulatore ufficiale, devi prima scaricare e installare l'immagine di sistema che viene eseguita nell'emulatore. Devi quindi creare un dispositivo virtuale che esegua questa immagine di sistema.

Scaricare e installare l'immagine di sistema

Per scaricare e installare l'immagine di sistema corretta, completa i seguenti passaggi:

1. Scarica e installa l'ultima release di Android Studio Ladybug Feature Drop o versioni successive, se non l'hai ancora fatto.
2. In Android Studio, vai a Strumenti > SDK Manager.

3. Nella scheda Piattaforme SDK, seleziona Mostra dettagli pacchetto ed espandi la sezione Android 15.0 ("VanillaIceCream") che contiene gli artefatti per il livello API 35-ext15. Poi, seleziona Wear OS 5.1 ARM 64 v8a System Image o Wear OS 5.1 Intel x86_64 Atom System Image:

   

4. Fai clic su OK. Quando viene visualizzata la finestra Conferma modifica, fai di nuovo clic su Ok.

5. Attendi che Android Studio scarichi e installi l'immagine di sistema, quindi fai clic su Fine.

Creare un dispositivo virtuale

Per creare un dispositivo virtuale che esegue questa immagine di sistema nell'emulatore ufficiale, completa questi passaggi:

1. In Android Studio, apri Device Manager selezionando Strumenti > Device Manager. Viene visualizzato il riquadro Gestione dispositivi.
2. Nella barra degli strumenti del riquadro Device Manager, tocca Aggiungi un nuovo dispositivo > Crea dispositivo virtuale.
3. Nel riquadro Fattore di forma, seleziona Wear OS e scegli un profilo hardware. Fai clic su Avanti.
4. Seleziona un'immagine di sistema Wear OS 5.1 da utilizzare. L'immagine di sistema deve avere un livello API di 35.
5. Fai clic su Avanti e poi su Fine.

Testare l'app sull'emulatore

Per testare la tua app su questo dispositivo virtuale che hai creato, completa i seguenti passaggi:

1. Vai alla barra degli strumenti di Android Studio e seleziona il dispositivo virtuale.
2. Tocca Corsa .
3. Installa l'app sul dispositivo virtuale e naviga nei diversi flussi di lavoro rivolti agli utenti utilizzati dall'app.

Modifiche che interessano tutte le app

Durante il test dell'app su Wear OS 5.1, verifica come gestisce i cambiamenti di comportamento del sistema che interessano tutte le app in Android 15, che utilizza lo stesso livello API di Wear OS 5.1.

Diverse modifiche al comportamento non vengono applicate in Wear OS 5.1:

• Gli spazi privati non sono supportati in Wear OS 5.1.
• Le animazioni predittive per Indietro potrebbero non essere visualizzate.

Aggiornare la versione dell'SDK target dell'app

Puoi migliorare la compatibilità della tua app con Wear OS 5.1 aggiornando la versione SDK target dell'app al livello API 35. (Si tratta dello stesso livello API utilizzato da Android 15).

Per farlo, apri il file build.gradle o build.gradle.kts a livello di modulo e aggiornali con i valori per Wear OS 5.1.

La modalità di formattazione dei valori nel file di build dipende dalla versione del plug-in Android per Gradle (AGP) che stai utilizzando.

AGP 7.0.0 o versioni successive

Se utilizzi AGP 7.0.0 o versioni successive, aggiorna il file build.gradle o build.gradle.kts della tua app con i seguenti valori per Wear OS 5.1:

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

AGP 4.2.0 o versioni precedenti

Se utilizzi AGP 4.2.0 o versioni precedenti, aggiorna il file build.gradle o build.gradle.kts della tua app con i seguenti valori per Wear OS 5.1:

android {
    compileSdkVersion "35"
    ...
    defaultConfig {
        targetSdkVersion "35"
    }
}

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "35"
    }
}

Modifiche che interessano solo le app che hanno come target il livello API 35

Dopo aver aggiornato la versione dell'SDK di destinazione al livello API 35, gestisci le modifiche per le app che hanno come target Android 15, che utilizza lo stesso livello API di Wear OS 5.1.

Esplora le nuove funzionalità

Wear OS 5.1 introduce diverse funzionalità per migliorare l'esperienza con le app Wear OS.

Ecco alcune funzionalità importanti da esplorare:

• Supporto di Credential Manager:l'API Credential Manager fornisce una soluzione di autenticazione unificata che supporta i flussi di accesso tramite password, passkey e identità federata (ad esempio Accedi con Google). Le credenziali di un utente vengono memorizzate in un provider di credenziali, che sincronizza le informazioni dell'account su tutti i dispositivi.
• Riproduzione tramite l'altoparlante dello smartwatch:sui dispositivi che supportano la riproduzione di contenuti multimediali tramite l'altoparlante dello smartwatch, gli utenti possono selezionare questo altoparlante come opzione di output multimediale preferita se la tua app si integra con Wear Output Switcher.

Note di rilascio

L'ultima immagine di sistema per Wear OS 5.1, disponibile sui dispositivi supportati e sull'emulatore, presenta le seguenti caratteristiche:

Problemi noti

L'immagine di sistema che contiene Wear OS 5.1 presenta i seguenti problemi noti:

• L'emulatore non sempre consente all'utente di aggiungere un account durante il flusso di configurazione dopo il ripristino del dispositivo.
• Quando tocchi una notifica, l'app che l'ha inviata non si apre finché l'utente non scorre lo schermo.
• A volte Wear Health Services non riesce ad avviare un allenamento.
• Se accedi alle librerie androidx.wear.tiles o androidx.wear:wear-phone-interactions all'interno di un'app che ha come target il livello API 35, potrebbe verificarsi un SecurityException. Per risolvere questo problema, esegui l'upgrade a androidx.wear.tiles 1.5.0-alpha05 o versioni successive oppure a androidx.wear:wear-phone-interactions 1.1.0 o versioni successive.