Beispiel-App für Smart-Home-APIs für Android

Die Beispiel-App zeigt die grundlegenden Funktionen der Google Home APIs für Android.

Vorbereitung

Damit Sie die App erstellen, installieren und testen können, müssen einige Voraussetzungen erfüllt sein:

  • Android Studio, Version 2024.2.1 („Ladybug“) oder höher. Beachten Sie, dass ältere Versionen möglicherweise nicht richtig mit dem Home APIs SDK funktionieren.

    Android Studio herunterladen

  • Der Android-Debugger (adb).

    Installieren Sie adb.

    Dazu können Sie den SDK-Manager verwenden.

Zum Testen der Home APIs benötigen Sie Folgendes:

  • Ein Android-Gerät mit Android 10 oder höher, das mit einem Google-Konto eingerichtet ist, das Sie für die Entwicklung verwenden möchten. Achten Sie darauf, dass eine aktuelle Version von Android Studio installiert ist und Sie mit diesem Entwicklerkonto angemeldet sind.
  • Ein WLAN
  • Wenn du auf Matter-Geräte zugreifen und sie steuern möchtest, benötigst du außerdem einen Google-Hub, der die Home-APIs unterstützt. Weitere Informationen finden Sie unter Konnektivität auf Android .

  • Mindestens ein unterstütztes Gerät im Zuhause. Wenn dieses Gerät (oder ein anderes, das du testen möchtest) Thread verwendet, muss der Hub auch ein Thread-Border-Router sein. Die Android-Beispiel-App unterstützt die folgenden Gerätetypen und Traits:

    • Farbtemperatur des Lichts (ein/aus, Helligkeit)
    • Kontaktsensor (boolescher Status)
    • Dimmbares Licht (ein/aus, Helligkeit)
    • Erweitertes Farblicht (an und aus, Helligkeit)
    • Generischer Schalter
    • Anwesenheitssensor (Anwesenheitserkennung)
    • Ein/Aus-Licht (Ein/Aus, Helligkeit)
    • Ein/Aus-Lichtschalter
    • Ein/Aus-Steckdosenmodul (Ein und Aus)
    • Ein-/Aus-Sensor

Quellcode herunterladen

Der Quellcode für die Beispielanwendung ist auf GitHub verfügbar.

Gehen Sie zum gewünschten Speicherort und klonen Sie das Projekt:

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

SDK einrichten

Die Home APIs für Android in dieser offenen Beta sind noch nicht Teil der Standardbibliotheken, die Google für die Entwicklung bereitstellt. Wenn Sie Android-Anwendungen mit den Home APIs entwickeln möchten, müssen Sie die Bibliotheken herunterladen und lokal hosten.

Wenn Sie das Home APIs Android SDK herunterladen möchten, müssen Sie zuerst in Google Home Developers angemeldet sein.

Jetzt anmelden

App erstellen

  1. Öffnen Sie Android Studio und dann den Projektordner google-home-api-sample-app-android, der auf Ihren lokalen Computer geklont wurde.

  2. Bei der ersten Einrichtung kann es bis zu 10 Minuten dauern, bis Android Studio alle Projektabhängigkeiten heruntergeladen und den Gradle-Build abgeschlossen hat.

  3. Verbinden Sie Ihren Computer über ein USB-Kabel mit einem physischen Android-Smartphone und aktivieren Sie ADB in den Entwickleroptionen. Prüfe, ob Android Studio über ADB eine Verbindung zum Android-Smartphone herstellen kann.

  4. Ändern Sie den Paketnamen der Beispiel-App in einen neuen Namen, der noch nicht registriert wurde, z. B. einen Namen, der auf dem Namen Ihrer Organisation basiert:

    1. Öffnen Sie das Projekt.
    2. Maximieren Sie die Quellhierarchie.
    3. Wählen Sie den Teil des Pakets aus, den Sie ändern möchten, also com.example.
    4. Klicken Sie mit der rechten Maustaste auf das Paket und wählen Sie Refactor > Rename... (Umgestalten > Umbenennen...) aus. „Refactor“ > „Rename“ (Umgestalten > Umbenennen)
    5. Geben Sie den neuen Namen ein und klicken Sie auf Refactor (Umgestalten).
    6. Bearbeiten Sie die Datei build.gradle.kts und ändern Sie android namespace und applicationId in den neuen Paketnamen.

  5. Nachdem alle erforderlichen Bibliotheken heruntergeladen und die Gradle-Synchronisierung abgeschlossen ist, klicken Sie auf die Schaltfläche Ausführen, um die App zu erstellen und auszuführen. Wenn die App erfolgreich auf Ihrem Smartphone ausgeführt wird, sehen Sie die Hauptseite der Beispiel-App.

Signaturzertifikat erstellen

Wenn Sie eine App in Android Studio ausführen oder debuggen, wird automatisch ein Debug-Zertifikat für die Entwicklung und das Debugging generiert. Eine ausführliche Erklärung finden Sie unter Android Studio: Sign your debug build.

  1. Generieren Sie ein Debug-App-Signaturzertifikat, indem Sie die App in Android Studio ausführen. Wenn Sie eine App in Android Studio ausführen oder debuggen, wird von Android Studio automatisch ein App-Signaturzertifikat für die Entwicklung und das Debugging generiert. Eine vollständige Erklärung finden Sie unter Android Studio: Sign your debug build.

    Verbinden Sie Ihr Mobilgerät mit Ihrem lokalen Computer. Unter Android Studio werden Ihre verbundenen Geräte nach Modellnummer aufgeführt. Wählen Sie Ihr Gerät aus der Liste aus und klicken Sie auf Projekt ausführen. Dadurch wird die Beispiel-App erstellt und auf Ihrem Mobilgerät installiert.

    Eine ausführliche Anleitung finden Sie auf der Website für Android-Entwickler unter Run apps on a hardware device.

    Beenden Sie nun die laufende App.

  2. Rufen Sie den SHA-1-Fingerabdruck Ihres Debug-Zertifikats ab. Folgen Sie dazu der Anleitung unter OAuth-Clients / Anwendungstypen / Native Anwendungen / Android verwalten auf der Hilfeseite zur Google Cloud Console.

  1. Rufen Sie in der Google Cloud Console das Dashboard für die Projektauswahl auf und wählen Sie das Projekt aus, das Sie zum Erstellen von OAuth-Anmeldedaten verwenden möchten.
  2. Rufen Sie die Seite APIs und Dienste auf und klicken Sie im Navigationsmenü auf Anmeldedaten.

  3. Wenn Sie den Zustimmungsbildschirm für dieses Google Cloud-Projekt noch nicht konfiguriert haben, wird die Schaltfläche Zustimmungsbildschirm konfigurieren angezeigt. Konfigurieren Sie in diesem Fall den Zustimmungsbildschirm mit der folgenden Anleitung. Fahren Sie andernfalls mit dem nächsten Abschnitt fort.

    1. Klicken Sie auf Zustimmungsbildschirm konfigurieren. Die Seite OAuth-Zustimmungsbildschirm wird angezeigt.
    2. Wählen Sie je nach Anwendungsfall Intern oder Extern aus und klicken Sie dann auf Erstellen. Der Bereich OAuth-Zustimmungsbildschirm wird angezeigt.
    3. Geben Sie auf der Seite App-Informationen Informationen gemäß der Anleitung auf dem Bildschirm ein und klicken Sie dann auf Speichern und fortfahren. Der Bereich Bereiche wird angezeigt.
    4. Sie müssen keine Bereiche hinzufügen. Klicken Sie daher auf Speichern und fortfahren. Der Bereich Testnutzer wird angezeigt.
    5. Klicken Sie auf Zielgruppe und dann auf die Schaltfläche + NUTZER HINZUFÜGEN.
    6. Geben Sie die E‑Mail-Adresse des Testnutzers ein und klicken Sie auf die Schaltfläche SPEICHERN.
    7. Klicken Sie auf Speichern und fortfahren. Der Bereich Zusammenfassung wird angezeigt.
    8. Prüfen Sie die Informationen auf dem OAuth-Zustimmungsbildschirm und klicken Sie dann auf Zurück zum Dashboard.

Weitere Informationen finden Sie in der Google Cloud Console-Hilfe unter OAuth-Zustimmungsbildschirm einrichten. Fügen Sie mindestens einen Testnutzer hinzu, bevor Sie fortfahren.

OAuth-Anmeldedaten einrichten

  1. Registrieren Sie die Beispiel-App für OAuth 2.0 und erstellen Sie OAuth-Anmeldedaten. Folgen Sie dazu der Anleitung unter OAuth 2.0 einrichten.
    1. Geben Sie den Anwendungstyp an, der native/Android-App ist.
    2. Fügen Sie den SHA‑1-Fingerabdruck dem OAuth-Client hinzu. Folgen Sie dazu der Anleitung unter OAuth 2.0 einrichten / Native Anwendungen / Android auf der Google Cloud Console-Hilfeseite. Sie sollten den SHA-1-Schlüssel während des gesamten Entwicklungsprozesses aus dem Standardschlüssel von Android Studio generieren.

Anwendung ausführen

  1. Klicken Sie noch einmal auf Projekt ausführen, um die Beispiel-App auf Ihrem Mobilgerät auszuführen, während dieses mit Ihrem lokalen Computer verbunden ist.

Nach der Installation ist die App auf Ihrem Mobilgerät als Home API Sample App verfügbar.