App di esempio per Android per le API Home

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

Prerequisiti

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

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

    Scaricare Android Studio

  • Il debugger Android (adb).

    Installa adb.

    Questa operazione può essere eseguita con SDK Manager.

Per testare le API Home, ti serviranno:

  • 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 di aver eseguito l'accesso con questo account di sviluppo.
  • Una rete Wi-Fi.
  • Un hub Google che supporta le API Home.

  • 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. L'app di esempio per Android supporta i seguenti tipi di dispositivi e trait:

    • Luce temperatura colore (accesa e spenta, luminosità)
    • Sensore di contatto (stato booleano)
    • Luce dimmerabile (on e off, luminosità)
    • Luce a colori estesa (on e off, luminosità)
    • Switch generico
    • Sensore di presenza (rilevamento della presenza)
    • Luce On/Off (accesa e spenta, luminosità)
    • Interruttore della luce on/off
    • Unità plug-in On/Off (on e off)
    • Sensore On/Off

  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 del consenso per questo progetto Google Cloud, viene visualizzato il pulsante Configura schermata del consenso. In questo caso, configura la schermata del consenso utilizzando la procedura riportata di seguito. In caso contrario, vai alla sezione successiva.

    1. Fai clic su Configura schermata di consenso. Viene visualizzata la pagina della schermata per il consenso OAuth.
    2. A seconda del caso d'uso, seleziona Interno o Esterno e 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 e poi fai clic su Salva e continua. Viene visualizzato il riquadro Ampi dello spettro.
    4. Non devi aggiungere ambiti, quindi fai clic su Salva e continua. Viene visualizzato il riquadro Utenti di test.
    5. Se vuoi aggiungere utenti per testare l'accesso alla tua app, fai clic su Aggiungi utenti. Viene visualizzato il riquadro Aggiungi utenti. Gli utenti di test hanno il privilegio di concedere le autorizzazioni nella tua app.
    6. Nel campo vuoto, aggiungi uno o più indirizzi email dell'Account Google, poi fai clic su Aggiungi.
    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 informazioni dettagliate, consulta la sezione Configurare la schermata per il consenso OAuth sul sito di assistenza della console Google Cloud.

Scarica il codice sorgente

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

Vai alla posizione in cui vuoi salvare il progetto e poi clonalo:

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

Configura l'SDK

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

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

Accedi ora.

Crea ed esegui

  1. Apri Android Studio, quindi la cartella del progetto google-home-api-sample-app-android che è stata clonata sulla tua macchina locale.
  2. Durante la prima configurazione, Android Studio potrebbe richiedere fino a 10 minuti per scaricare tutte le dipendenze del progetto e completare la compilazione di Gradle.
    • Se durante questo passaggio viene visualizzato un errore, ad esempio Gradle Sync Failed, fai clic su Riprova per riavviare la sincronizzazione.
  3. 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 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 Rifactoring > Rinomina….
    5. Fai clic su Tutte le directory.
    6. Inserisci il nuovo nome e fai clic su Ristruttura.
    7. Modifica il file build.gradle.kts sostituendo android namespace e applicationId con il nuovo nome del pacchetto.
    8. Modifica il file AndroidManifest.xml e cambia il pacchetto con il nuovo nome del pacchetto ovunque si presenti nel file.

  4. Genera una chiave OAuth eseguendo l'app in Android Studio. Quando esegui o esegui il debug di un'app in Android Studio, Android Studio genera automaticamente una chiave OAuth destinata allo sviluppo e al debug. Per una spiegazione completa, consulta Android Studio: firma la build di debug.

    Collega il dispositivo mobile al computer locale. Android Studio elenca i dispositivi collegati in base al numero di modello. Seleziona il tuo dispositivo dall'elenco e poi fai clic su Esegui progetto. In questo modo, viene compilata 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 interrompi l'app in esecuzione.

  5. Ottieni la impronta SHA-1 del certificato OAuth seguendo le istruzioni dettagliate riportate in Configurazione di OAuth 2.0 / app native / Android sul sito di assistenza della console Google Cloud.

  6. Registra l'app di esempio per OAuth 2.0 e crea le credenziali OAuth seguendo le istruzioni riportate in 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 / app native / Android sul sito di assistenza della console Google Cloud. Devi generare la chiave SHA-1 dalla chiave Android Studio predefinita durante il processo di sviluppo.
    3. Aggiungi utenti di test. Gli utenti di test hanno il privilegio di concedere le autorizzazioni nell'app di esempio.

  7. Con il dispositivo mobile connesso al computer 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 per l'API Home.