Wear OS 5.1

Esplora la versione più recente di Wear OS, disponibile nell'emulatore ufficiale di Android Studio. Verifica che l'app funzioni come previsto dopo aver aggiornato la versione dell'SDK di destinazione.

Wear OS 5.1 è basato su Android 15 (livello API 35), pertanto devi testare le tue app che hanno già come target il livello API 34 per Wear OS 5.

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 sull'emulatore. Devi quindi creare un dispositivo virtuale che esegua questa immagine di sistema.

Scarica e installa l'immagine di sistema

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

  1. Se non l'hai ancora fatto, scarica e installa la release più recente di Android Studio Meerkat.
  2. In Android Studio, fai clic su Strumenti > Gestore SDK.

  3. Nella scheda Piattaforme SDK, espandi la sezione Android 15.0 ("VanillaIceCream") e seleziona Wear OS 5.1 - Preview ARM 64 v8a System Image o Wear OS 5.1 - Preview Intel x86_64 Atom System Image:

    "Le immagini di build dell'emulatore vengono visualizzate nel gruppo di immagini di build per Android API 35"

  4. Fai clic su OK. Quando viene visualizzata la finestra Conferma modifica, fai nuovamente 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, compila 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 del riquadro Gestione dispositivi, fai clic su 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 pari a 35.
  5. Fai clic su Avanti, quindi su Fine.

Testare l'app sull'emulatore

Per testare l'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. Fai clic su Esegui .
  3. Installa l'app sul dispositivo virtuale e naviga tra i diversi flussi di lavoro rivolti agli utenti utilizzati dalla tua app.

Modifiche che interessano tutte le app

Mentre testi la tua app su Wear OS 5.1, controlla come 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 vengono applicate in Wear OS 5.1:

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

A tale scopo, apri il file build.gradle o build.gradle.kts a livello di modulo e aggiornalo con i valori per Wear OS 5.1.

Il modo in cui formatti i valori nel file di compilazione dipende dalla versione del plug-in Android Gradle (AGP) in uso.

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:

Groovy

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:

Groovy

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.

Esplora le nuove funzionalità

Wear OS 5.1 introduce diverse funzionalità per migliorare la tua esperienza con le app Wear OS.

Ecco alcune funzionalità importanti da esplorare:

  • Supporto di Gestore delle credenziali:l'API Gestore delle credenziali fornisce una soluzione di autenticazione unificata che supporta i flussi di accesso che utilizzano password, passkey e identità federate (ad esempio Accedi con Google). Le credenziali di un utente vengono memorizzate in un fornitore di credenziali, che sincronizza le informazioni dell'account su tutti i dispositivi.
  • Riproduzione tramite altoparlante dello smartwatch: sui dispositivi che supportano la riproduzione di contenuti multimediali tramite lo speaker dello smartwatch, gli utenti possono selezionare questo speaker come opzione di output multimediale preferita se la tua app è integrata con il selettore di output Wear.

Note di rilascio

L'immagine di sistema disponibile nell'emulatore Wear OS 5.1 presenta le seguenti caratteristiche:

  • Data di uscita: 19 novembre 2024
  • ID build: AP4A.241205.004.F1

Problemi noti

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

  • L'emulatore non consente sempre all'utente di aggiungere un account durante il flusso di configurazione dopo il ripristino dei dati di fabbrica 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'attività fisica.