Wear OS 5.1

Wear OS 5.1 è disponibile su alcuni dispositivi e nell'emulatore ufficiale in Android Studio. Verifica che l'app funzioni come previsto dopo aver aggiornato la versione dell'SDK target.

Wear OS 5.1 è basato su Android 15 (livello API 35), il che significa che devi testare le 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 OTA (over-the-air). Puoi anche aggiornare manualmente il dispositivo in uno dei seguenti modi:

• Nell'app Impostazioni, vai a Sistema > Aggiornamenti di sistema.
• Dopo aver attivato le opzioni sviluppatore, installa un'immagine software specifica sui dispositivi che supportano una connessione dati USB (cablata). Ad esempio, puoi eseguire il flashing di un'immagine del produttore 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 eseguita sull'emulatore. Dopodiché, devi 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, svolgi i seguenti passaggi:

1. Scarica e installa l'ultima release di Android Studio Ladybug Feature Drop o versioni successive, se non l'hai già 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. Quindi, seleziona either Wear OS 5.1 ARM 64 v8a System Image or 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 esegua questa immagine di sistema nell'emulatore ufficiale, svolgi i seguenti passaggi:

1. In Android Studio, apri Gestione dispositivi selezionando Strumenti > Gestione dispositivi. Viene visualizzato il riquadro Gestione dispositivi.
2. Nella barra degli strumenti all'interno del riquadro Gestione dispositivi, 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, quindi su Fine.

Testare l'app sull'emulatore

Per testare l'app sul dispositivo virtuale che hai creato, svolgi i seguenti passaggi:

1. Vai alla barra degli strumenti di Android Studio e seleziona il dispositivo virtuale.
2. Tocca Esegui .
3. Installa l'app sul dispositivo virtuale e naviga tra i diversi workflow rivolti agli utenti utilizzati dall'app.

Modifiche che interessano tutte le app

Durante il test dell'app su Wear OS 5.1, verifica in che modo l'app gestisce le modifiche al 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 hanno effetto in Wear OS 5.1:

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

Aggiornare la versione dell'SDK target dell'app

Puoi migliorare la compatibilità dell'app con Wear OS 5.1 aggiornando la versione dell'SDK target dell'app al livello API 35. (Questo è lo 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.

Il modo in cui formatti i 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 dell'app con i seguenti valori per Wear OS 5.1:

Alla moda

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

Kotlin

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 dell'app con i seguenti valori per Wear OS 5.1:

Alla moda

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

Kotlin

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 target 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.

Nuove funzionalità

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

Nota: prima di aggiungere queste funzionalità all'app, preparala per gestire le modifiche al comportamento introdotte da Wear OS 5.1.

Di seguito sono riportate alcune funzionalità importanti da esplorare:

• Supporto di API 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 archiviate in un provider di credenziali, che sincronizza le informazioni dell'account su tutti i dispositivi.
• Riproduzione dell'altoparlante dello smartwatch: sui dispositivi che supportano la riproduzione dei contenuti multimediali tramite l'altoparlante dello smartwatch, gli utenti possono selezionare questo altoparlante come opzione di output multimediale preferita se l'app è integrata 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:

Data di rilascio	18 marzo 2025 per Google Pixel Watch 3 LTE, Google Pixel Watch 2 LTE e Google Pixel Watch (Bluetooth/Wi-Fi e LTE) 4 marzo 2025 per Google Pixel Watch 3 Bluetooth/Wi-Fi e Google Pixel Watch 2 Bluetooth/Wi-Fi
Build	BP1A.250305.019.W3 su Google Pixel Watch 3 e Google Pixel Watch 2 BP1A.250305.019.W2 su Google Pixel Watch AP4A.241205.004.F4 sull'emulatore
Supporto dell'emulatore	x86 (64 bit), ARM (v8-A)

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 la reimpostazione del dispositivo.
• Quando si tocca 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'eccezione SecurityException. Per risolvere il 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.