Android-Beispiel-App für Gebäude-APIs

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

Vorbereitung

Zum Erstellen, Installieren und Testen der App müssen einige Voraussetzungen erfüllt sein:

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

    Android Studio herunterladen

  • Der Android-Debugger (adb).

    Install adb

    Dies kann mit dem SDK Manager erfolgen.

Zum Testen der Home APIs benötigen Sie außerdem:

  • 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 Entwicklungskonto angemeldet sind.
  • Ein WLAN.
  • Um auf Matter Geräte zuzugreifen und sie zu steuern, benötigen Sie 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 Sie testen möchten) Thread verwendet, muss der Hub auch ein Thread-Border-Router sein. Die folgenden Gerätetypen und Merkmale werden von der Android-Beispiel-App unterstützt:

    • Farbtemperatur-Licht (ein/aus, Helligkeit)
    • Kontaktsensor (boolescher Status)
    • Dimmbares Licht (ein/aus, Helligkeit)
    • Erweitertes Farblicht (ein/aus, Helligkeit)
    • Allgemeiner Schalter
    • Google Kamera
    • Anwesenheitssensor (Anwesenheit im Zuhause)
    • Ein/Aus-Licht (ein/aus, Helligkeit)
    • Ein/Aus-Lichtschalter
    • Ein/Aus-Steckdose (ein/aus)
    • Ein/Aus-Sensor

Quellcode herunterladen

Der Quell code für die Beispiel-App ist auf GitHub verfügbar.

Gehen Sie zu dem Speicherort, an dem Sie das Projekt speichern möchten, und klonen Sie es:

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 von Google für die Entwicklung bereitgestellt werden. Wenn Sie Android-Anwendungen mit den Home APIs entwickeln möchten, müssen Sie die Bibliotheken lokal herunterladen und hosten.

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

Jetzt anmelden

App erstellen

  1. Öffnen Sie Android Studio, und öffnen Sie dann den google-home-api-sample-app-android Projektordner, 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. Achten Sie darauf, dass Android Studio über ADB eine Verbindung zum Android-Smartphone herstellen kann.

  4. Ändern Sie den Paketnamen für die 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, d. h. com.example.
    4. Klicken Sie mit der rechten Maustaste auf das Paket und wählen Sie Refactor > Rename... aus. „Refactor“ > „Rename“ (Umgestalten > Umbenennen)
    5. Geben Sie den neuen Namen ein und klicken Sie auf Refactor.
    6. Bearbeiten Sie die Datei build.gradle.kts und ändern Sie den android namespace und die 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, wird die Hauptseite der Beispiel-App angezeigt.

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 vollständige Erklärung finden Sie unter Android Studio: Debug-Build signieren.

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

    Verbinden Sie Ihr Mobilgerät mit Ihrem lokalen Computer. Android Studio listet Ihre verbundenen Geräte nach Modell nummer auf. Wählen Sie Ihr Gerät in der Liste aus und klicken Sie dann auf Projekt ausführen. Dadurch wird die Beispiel-App auf Ihrem Mobilgerät erstellt und installiert.

    Eine detailliertere Anleitung finden Sie auf der Website für Android-Entwickler unter Apps auf einem Hardware gerät ausführen.

    Beenden Sie jetzt 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 auf der Google Cloud Console-Hilfeseite.

  1. Rufen Sie in der Google Cloud Console das Dashboard der Projektauswahl auf und wählen Sie das Projekt aus, mit dem Sie OAuth-Anmeldedaten erstellen 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. Andernfalls fahren Sie 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 die 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 also 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 Ihres 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 zum OAuth-Zustimmungsbildschirm und klicken Sie dann auf Zurück zum Dashboard.

Eine vollständige Anleitung finden Sie auf der Google Cloud Console-Hilfeseite unter OAuth-Zustimmungs bildschirm 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: native/Android-App.
    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. Wenn Ihr Mobilgerät mit Ihrem lokalen Computer verbunden ist, klicken Sie noch einmal auf Projekt ausführen , um die Beispiel-App auf Ihrem Mobilgerät auszuführen.

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