Przykładowa aplikacja na Androida Home APIs

Aplikacja próbna prezentuje podstawowe możliwości interfejsów Google Home API na Androida.

Wymagania wstępne

Aby utworzyć, zainstalować i przetestować aplikację, musisz spełnić kilka wymagań wstępnych:

  • Android Studio w wersji 2024.2.1 („Ladybug”) lub nowszej. Pamiętaj, że wersje wcześniejsze niż ta mogą nie działać prawidłowo z pakietem SDK interfejsów Home API.

    Pobierz Android Studio

  • Debuger Androida (adb).

    Zainstaluj adb.

    Możesz to zrobić za pomocą menedżera pakietów SDK.

Aby przetestować interfejsy Home API, musisz mieć:

  • Urządzenie z Androidem 10 lub nowszym skonfigurowane za pomocą konta Google, którego zamierzasz używać do tworzenia aplikacji. Upewnij się, że zainstalowana jest aktualna wersja Android Studio i zaloguj się na konto programistyczne.
  • sieć Wi-Fi,
  • Aby uzyskać dostęp do urządzeń Matter i nimi sterować, potrzebujesz też centrali Google obsługującej interfejsy Home API. Więcej informacji znajdziesz w artykule Łączność na urządzeniach z Androidem .

  • Co najmniej jedno obsługiwane urządzenie w domu. Jeśli to urządzenie (lub inne, które chcesz przetestować) korzysta z Thread, hub musi być też routerem granicznym Thread. Aplikacja przykładowa na Androida obsługuje te typy urządzeń i traits:

    • Światło o regulowanej temperaturze barwowej (włączanie i wyłączanie, jasność)
    • Czujnik kontaktu (stan logiczny)
    • Światło z możliwością ściemniania (włączanie i wyłączanie, jasność)
    • Rozszerzone światło kolorowe (włączanie i wyłączanie, jasność)
    • Przełącznik ogólny
    • Aparat Google
    • Czujnik obecności (wykrywanie obecności)
    • Włączanie i wyłączanie światła (włączanie i wyłączanie, jasność)
    • Włącznik światła
    • Włącznik/wyłącznik (włączony i wyłączony)
    • Czujnik włączania/wyłączania

Pobieranie kodu źródłowego

Kod źródłowy przykładowej aplikacji jest dostępny na GitHubie.

Przejdź do miejsca, w którym chcesz zapisać projekt, a następnie go sklonuj:

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

Konfigurowanie pakietu SDK

Interfejsy API Home dla systemu Android w tej otwartej wersji beta nie są jeszcze częścią standardowych bibliotek udostępnianych przez Google na potrzeby rozwoju. Aby móc tworzyć aplikacje Android przy użyciu interfejsów API Home, musisz pobrać biblioteki i zainstalować je lokalnie.

Aby pobrać pakiet Home APIs Android SDK, musisz najpierw zalogować się w Google Home Developers.

Zaloguj się

Tworzenie aplikacji

  1. Otwórz Android Studio, a następnie otwórz folder projektu google-home-api-sample-app-android, który został sklonowany na komputer lokalny.

  2. Podczas pierwszej konfiguracji pobranie wszystkich zależności projektu i ukończenie kompilacji Gradle może potrwać do 10 minut.Android Studio

  3. Podłącz komputer do telefonu z systemem Android za pomocą kabla USB i włącz ADB w opcjach programistycznych. Sprawdź, czy Android Studio może połączyć się z telefonem z Androidem za pomocą ADB.

  4. Zmień nazwę pakietu dla aplikacji przykładowej na nową, która nie była wcześniej zarejestrowana, na przykład taką, która opiera się na nazwie Twojej organizacji:

    1. Otwórz projekt.
    2. Rozwiń hierarchię źródła.
    3. Wybierz część pakietu, którą chcesz zmienić, czylicom.example.
    4. Kliknij prawym przyciskiem myszy pakiet i wybierz Refactor (Refaktoryzacja) > Rename... (Zmień nazwę).Refaktoryzacja > Zmień nazwę
    5. Wpisz nową nazwę i kliknij Refactor (Refaktoryzuj).
    6. Edytuj plik build.gradle.kts, zmieniając android namespace i applicationId na nową nazwę pakietu.

  5. Po pobraniu wszystkich wymaganych bibliotek i zakończeniu synchronizacji Gradle kliknij przycisk Uruchom, aby skompilować i uruchomić aplikację. Gdy aplikacja będzie działać prawidłowo na telefonie, zobaczysz stronę główną aplikacji przykładowej.

Utwórz certyfikat podpisu

Gdy uruchamiasz lub debugujesz aplikację w Android Studio, automatycznie generuje ona certyfikat debugowania przeznaczony do tworzenia i debugowania. Pełne wyjaśnienie znajdziesz w artykule Android Studio: podpisywanie kompilacji debugowania.

  1. Wygeneruj certyfikat podpisywania aplikacji do debugowania, uruchamiając aplikację w Android Studio. Gdy uruchamiasz lub debugujesz aplikację w Android Studio, Android Studio automatycznie generuje certyfikat podpisywania aplikacji przeznaczony do programowania i debugowania. Pełne wyjaśnienie znajdziesz w artykule Android Studio: Podpisywanie kompilacji debugowej.

    Podłącz urządzenie mobilne do komputera lokalnego. Android Studio wyświetli listę podłączonych urządzeń według numeru modelu. Wybierz urządzenie z listy, a następnie kliknij Uruchom projekt. Spowoduje to zbudowanie i zainstalowanie przykładowej aplikacji na Twoim urządzeniu mobilnym.

    Bardziej szczegółowe instrukcje znajdziesz w artykule Uruchamianie aplikacji na urządzeniu sprzętowym w witrynie dla programistów Androida.

    Teraz zatrzymaj działającą aplikację.

  2. Uzyskaj odcisk palca SHA-1 certyfikatu debugowania, postępując zgodnie z instrukcjami podanymi w sekcji Zarządzanie klientami OAuth / Typy aplikacji / Aplikacje natywne / Android w witrynie pomocy Google Cloud Console.

  1. W konsoli Google Cloud przejdź do panelu wyboru projektu i wybierz projekt, którego chcesz użyć do utworzenia poświadczeń OAuth.
  2. Przejdź do strony Interfejsy API i usługi i kliknij Dane uwierzytelniające w menu nawigacyjnym.

  3. Jeśli nie masz jeszcze skonfigurowanego ekranu zgody w tym projekcie Google Cloud, pojawi się przycisk Skonfiguruj ekran zgody. W takim przypadku skonfiguruj ekran zgody, korzystając z następującej procedury. W przeciwnym wypadku przejdź do następnej sekcji.

    1. Kliknij Skonfiguruj ekran zgody. Wyświetla się strona Ekran zgody OAuth.
    2. W zależności od przypadku użycia wybierz opcję Wewnętrzny lub Zewnętrzny, a następnie kliknij Utwórz. Wyświetli się panel Ekran zgody OAuth.
    3. Wpisz informacje na stronie z informacjami o aplikacji zgodnie z instrukcjami wyświetlanymi na ekranie, a potem kliknij Zapisz i kontynuuj. Pojawi się panel Zakresy.
    4. Nie musisz dodawać żadnych zakresów, więc kliknij Zapisz i kontynuuj. Wyświetli się panel Użytkownicy testowi.
    5. Kliknij Odbiorcy, a następnie kliknij przycisk + DODAJ UŻYTKOWNIKÓW.
    6. Wpisz adres e-mail użytkownika testowego i kliknij przycisk ZAPISZ.
    7. Kliknij Zapisz i kontynuuj. Wyświetla się panel Podsumowanie.
    8. Sprawdź informacje na ekranie zgody OAuth, a potem kliknij Wróć do panelu.

Szczegółowe informacje znajdziesz w artykule Konfigurowanie ekranu zgody OAuth w witrynie pomocy Google Cloud Console. Przed kontynuowaniem pamiętaj o dodaniu co najmniej jednego użytkownika testowego.

Skonfiguruj dane uwierzytelniające OAuth

  1. Zarejestruj przykładową aplikację dla protokołu OAuth 2.0 i utwórz dane uwierzytelniające protokołu OAuth, postępując zgodnie z instrukcjami podanymi w artykule Konfigurowanie protokołu OAuth 2.0.
    1. Wskaż typ aplikacji, czyli aplikacja natywna/na Androida.
    2. Dodaj odcisk cyfrowy SHA-1 do klienta OAuth, postępując zgodnie z instrukcjami w artykule Konfigurowanie OAuth 2.0 / Aplikacje natywne / Android w Centrum pomocy konsoli Google Cloud. W trakcie całego procesu tworzenia oprogramowania należy generować klucz SHA-1 na podstawie domyślnego klucza Android Studio.

Uruchamianie aplikacji

  1. Po podłączeniu urządzenia mobilnego do komputera lokalnego kliknij ponownie Uruchom projekt, aby uruchomić przykładową aplikację na urządzeniu mobilnym.

Po zainstalowaniu aplikacja będzie dostępna na Twoim urządzeniu mobilnym jako Home API Sample App.