App di esempio per 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 Home APIs.

    Scarica Android Studio

  • Il debugger Android (adb).

    Installa adb.

    Questa operazione può essere eseguita con SDK Manager.

Per testare le API Home, avrai bisogno di:

  • 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 sia stato eseguito l'accesso con questo account sviluppatore.
  • Una rete Wi-Fi.
  • Per accedere e controllare i dispositivi Matter, devi anche avere un hub Google che supporti le API Home. Per maggiori dettagli, vedi 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 trait 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 colorata estesa (on/off, luminosità)
    • Generic Switch
    • Sensore di presenza (rilevamento della presenza)
    • Luce accesa/spenta (accensione e spegnimento, luminosità)
    • Interruttore della luce on/off
    • Unità plug-in on/off (accesa e spenta)
    • Sensore di accensione/spegnimento

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 per Android con le API per la casa, devi scaricare e ospitare le librerie localmente.

Per scaricare l'SDK Android per le API Home, devi prima accedere 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 è stata clonata sulla tua macchina locale.

  2. Durante la prima configurazione, il download di tutte le dipendenze del progetto e il completamento della build Gradle potrebbero richiedere fino a 10 minuti.Android Studio

  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 uno nuovo che non sia stato registrato in precedenza, ad esempio uno basato sul nome della tua organizzazione:

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

  5. Una volta scaricate tutte le librerie richieste e completata la sincronizzazione di Gradle, fai clic sul pulsante Esegui per creare ed eseguire l'app. Quando l'app viene eseguita correttamente sullo smartphone, visualizzerai 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. Consulta Android Studio: Sign your debug build per una spiegazione completa.

  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 genera automaticamente un certificato di firma dell'app destinato allo sviluppo e al debug. Consulta Android Studio: firma la build di debug per una spiegazione completa.

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

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

    Ora arresta l'app in esecuzione.

  2. Ottieni l'impronta SHA-1 del certificato di debug seguendo le istruzioni descritte in Gestire client OAuth / tipi di applicazioni / applicazioni native / Android nel 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. Altrimenti, vai alla sezione successiva.

    1. Fai clic su Configura schermata di consenso. Viene visualizzata la pagina Schermata per il consenso OAuth.
    2. A seconda del caso d'uso, seleziona Interno o Esterno e poi fai clic su Crea. Viene visualizzato il riquadro Schermata per il consenso OAuth.
    3. Inserisci le informazioni nella pagina delle 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. Rivedi le informazioni della schermata per il consenso OAuth, quindi fai clic su Torna alla dashboard.

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

Configurare le credenziali OAuth

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

Esegui l'app

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

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