App di esempio Android per le API Home

L'app di esempio mostra le funzionalità di base delle API Google Home per Android.

Prerequisiti

Per creare, installare e testare l'app, devi soddisfare alcuni prerequisiti:

  • Android Studio, versione 2024.2.1 ("Ladybug") o successive. Tieni presente che le versioni precedenti potrebbero non funzionare correttamente con l'SDK delle API Home.

    Scarica Android Studio

  • Il debugger Android (adb).

    Installa adb.

    Puoi farlo con SDK Manager.

Per testare le API Home, ti servono anche:

  • Un dispositivo Android con Android 10 o versioni successive configurato con un Account Google che intendi utilizzare per lo sviluppo. Assicurati che sia installata una versione aggiornata di Android Studio e che tu abbia eseguito l'accesso con questo account di sviluppo.
  • Una rete Wi-Fi.
  • Per accedere ai dispositivi Matter e controllarli, devi anche avere un hub Google che supporti le API Home. Per maggiori dettagli, consulta Connettività su Android .

  • Almeno un dispositivo supportato in casa. Se questo dispositivo (o qualsiasi altro che vuoi testare) utilizza Thread, l'hub deve essere anche un router di confine Thread. I seguenti tipi di dispositivi e tratti sono supportati dall'app di esempio per Android:

    • Luce a temperatura di colore (on/off, luminosità)
    • Sensore di contatto (stato booleano)
    • Luce dimmerabile (on/off, luminosità)
    • Luce a gamma cromatica estesa (on/off, luminosità)
    • Interruttore generico
    • Google Fotocamera
    • Sensore di presenza (rilevamento della presenza)
    • Luce on/off (on/off, luminosità)
    • Interruttore della luce on/off
    • Unità plug-in on/off (on/off)
    • Sensore on/off

scarica il codice sorgente

Il codice sorgente dell'app di esempio è disponibile su GitHub.

Vai alla posizione in cui vuoi salvare il progetto, quindi clonalo:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

Configura l'SDK

Le API Home per Android in questa beta aperta non fanno ancora parte delle librerie standard fornite da Google per lo sviluppo. Per sviluppare applicazioni Android con le API Home, devi scaricare e ospitare le librerie localmente.

Per scaricare l'SDK Android delle API Home, devi prima aver eseguito l'accesso a Google Home Developers.

Accedi ora.

Crea l'app

  1. Apri Android Studio, quindi apri la cartella del progetto google-home-api-sample-app-android che hai clonato sulla tua macchina locale.

  2. Durante la prima configurazione, Android Studio potrebbe impiegare fino a 10 minuti per scaricare tutte le dipendenze del progetto e completare la creazione di Gradle.

  3. Collega il computer a uno smartphone Android fisico tramite un cavo USB e attiva ADB nelle opzioni sviluppatore. Assicurati che Android Studio possa connettersi allo smartphone Android tramite ADB.

  4. Modifica il nome del pacchetto dell'app di esempio con un nuovo nome che non è stato registrato in precedenza, ad esempio uno basato sul nome della tua organizzazione:

    1. Apri il progetto.
    2. Espandi la gerarchia delle origini.
    3. Seleziona la parte del pacchetto che vuoi modificare, in altre parole com.example.
    4. Fai clic con il tasto destro del mouse sul pacchetto e seleziona Refactor > Rename... Refactor > Rename menu
    5. Inserisci il nuovo nome e fai clic su Refactor.
    6. Modifica il file build.gradle.kts, modificando android namespace e applicationId con il nuovo nome del pacchetto.

  5. Dopo aver scaricato tutte le librerie richieste e completato la sincronizzazione di Gradle, fai clic sul pulsante Esegui per creare ed eseguire l'app. Quando l'app viene eseguita correttamente sullo smartphone, vedrai la pagina principale dell'app di esempio.

Crea un certificato di firma

Quando esegui o esegui il debug di un'app in Android Studio, viene generato automaticamente un certificato di debug destinato allo sviluppo e al debug. Per una spiegazione completa, consulta Android Studio: Sign your debug build.

  1. Genera un certificato di firma dell'app di debug eseguendo l'app in Android Studio. Quando esegui o esegui il debug di un'app in Android Studio, Android Studio viene generato automaticamente un certificato di firma dell'app destinato allo sviluppo e al debug. Per una spiegazione completa, consulta Android Studio: Sign your debug build.

    Collega il dispositivo mobile alla macchina locale. Android Studio elencherà i dispositivi collegati in base al numero di modello. Seleziona il tuo dispositivo dall'elenco, quindi fai clic su Esegui progetto. In questo modo, l'app di esempio viene creata e installata sul tuo dispositivo mobile.

    Per istruzioni più dettagliate, consulta Eseguire app su un dispositivo hardware sul sito per sviluppatori Android.

    Ora arresta l'app in esecuzione.

  2. Recupera l'impronta digitale SHA-1 del certificato di debug seguendo le istruzioni dettagliate in Gestire i client OAuth / i tipi di applicazioni / le applicazioni native / Android sul sito di assistenza della console Google Cloud.

  1. Nella console Google Cloud, vai alla dashboard del selettore di progetti e seleziona il progetto che vuoi utilizzare per creare le credenziali OAuth.
  2. Vai alla pagina API e servizi e fai clic su Credenziali nel menu di navigazione.

  3. Se non hai ancora configurato la schermata per il consenso per questo progetto Google Cloud, viene visualizzato il pulsante Configura schermata per il consenso. In questo caso, configura la schermata per il consenso utilizzando la seguente procedura. In caso contrario, vai alla sezione successiva.

    1. Fai clic su Configura schermata per il consenso. Viene visualizzata la pagina Schermata per il consenso OAuth.
    2. A seconda del tuo caso d'uso, seleziona Interno o Esterno, quindi fai clic su Crea. Viene visualizzato il riquadro Schermata per il consenso OAuth.
    3. Inserisci le informazioni nella pagina Informazioni sull'app seguendo le istruzioni sullo schermo, quindi fai clic su Salva e continua. Viene visualizzato il riquadro Ambiti.
    4. Non devi aggiungere ambiti, quindi fai clic su Salva e continua. Viene visualizzato il riquadro Utenti di test.
    5. Fai clic su Pubblico e poi sul pulsante + AGGIUNGI UTENTI.
    6. Inserisci l'indirizzo email dell'utente di test e fai clic sul pulsante SALVA.
    7. Fai clic su Salva e continua. Viene visualizzato il riquadro Riepilogo.
    8. Esamina le informazioni della schermata per il consenso OAuth, quindi fai clic su Torna alla dashboard.

Per tutti i dettagli, consulta Configurare la schermata per il consenso OAuth sul sito di assistenza della console Google Cloud. Prima di continuare, assicurati di aggiungere almeno un utente di test.

Configura le credenziali OAuth

  1. Registra l'app di esempio per OAuth 2.0 e crea le credenziali OAuth seguendo le istruzioni fornite in Configurare OAuth 2.0.
    1. Indica il tipo di applicazione, ovvero app per Android.
    2. Aggiungi l'impronta digitale SHA-1 al client OAuth seguendo le istruzioni riportate in Configurare OAuth 2.0 / Applicazioni native / Android sul sito di assistenza della console Google Cloud. Durante la procedura di sviluppo, devi generare la chiave SHA-1 dalla chiave predefinita di Android Studio.

Esegui l'app

  1. Con il dispositivo mobile collegato alla macchina locale, fai di nuovo clic su Esegui progetto per eseguire l'app di esempio sul dispositivo mobile.

Una volta installata, l'app è disponibile sul tuo dispositivo mobile come App di esempio delle API Home.