Aplikacja przykładowa interfejsów API Home na Androida

Przykładowa aplikacja demonstruje podstawowe funkcje interfejsów API Google Home na Androida.

Wymagania wstępne

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

  • Android Studio, wersja 2024.2.1 („Ladybug”) lub nowsza. Pamiętaj, że starsze wersje mogą nie działać prawidłowo z Home APIs SDK.

    Pobierz Android Studio

  • Debuger Androida (adb).

    Zainstaluj adb.

    Można to zrobić za pomocą Menedżera pakietu SDK.

Aby przetestować interfejsy API Home, musisz mieć:

  • urządzenie z Androidem 10 lub nowszym z kontem Google, którego zamierzasz używać do tworzenia aplikacji; Upewnij się, że masz zainstalowaną najnowszą wersję aplikacji Android Studio i że jesteś zalogowany(-a) na to konto deweloperskie.
  • sieć Wi-Fi,
  • Aby uzyskać dostęp do urządzeń Matter i nimi sterować, musisz też mieć centralę Google obsługującą interfejsy API Home. Więcej informacji znajdziesz w artykule Łączność na urządzeniach z Androidem .

  • co najmniej 1 obsługiwane urządzenie w domu; Jeśli to urządzenie (lub inne, które chcesz przetestować) korzysta z Thread, koncentrator musi też być routerem brzegowym Thread. Przykładowa aplikacja na Androida obsługuje te typy i traits urządzeń:

    • Temperatura barwy światła (włączanie i wyłączanie, jasność)
    • Czujnik kontaktowy (wartość logiczna)
    • Regulowane światło (włączanie i wyłączanie, jasność)
    • Extended Color Light (włączanie i wyłączanie, jasność)
    • Przełącznik ogólny
    • Czujnik obecności (wykrywanie obecności)
    • Włączanie i wyłączanie światła (włączanie i wyłączanie, jasność)
    • Włącznik światła włącz/wyłącz
    • Włącznik (włączanie i wyłączanie)
    • 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 potem go sklonuj:

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

Konfigurowanie pakietu SDK

Interfejsy Home API na Androida w ramach otwartych testów beta nie są jeszcze częścią standardowych bibliotek udostępnianych przez Google do programowania. Aby tworzyć aplikacje na Androida z użyciem interfejsów Home API, musisz pobrać i hostować biblioteki lokalnie.

Aby pobrać pakiet Android SDK interfejsów API Home, musisz najpierw zalogować się w Google jako deweloper Home.

Zaloguj się teraz

Kompilowanie aplikacji

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

  2. Podczas pierwszej konfiguracji Android Studio może minąć do 10 minut, zanim zostaną pobrane wszystkie zależności projektu i ukończone kompilowanie Gradle.

  3. Podłącz komputer do fizycznego telefonu z Androidem za pomocą kabla USB i włącz ADB w opcjach programisty. Upewnij się, że Android Studio może połączyć się z telefonem z Androidem przez ADB.

  4. Zmień nazwę pakietu przykładowej aplikacji na nową, która nie była wcześniej zarejestrowana, np. na nazwę organizacji:

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

  5. Po pobraniu wszystkich wymaganych bibliotek i ukończeniu synchronizacji Gradle kliknij przycisk Uruchom, aby skompilować i uruchomić aplikację. Gdy aplikacja uruchomi się na telefonie, zobaczysz stronę główną Sample App.

Tworzenie certyfikatu podpisywania

Gdy uruchamiasz aplikację lub debugujesz ją w Android Studio, automatycznie generuje ona certyfikat debugowania przeznaczony do programowania i debugowania. Pełne wyjaśnienia znajdziesz w artykule Android Studio: podpisywanie wersji debugowania.

  1. Wygeneruj certyfikat podpisywania aplikacji debugującej, uruchamiając aplikację w trybie Android Studio. Gdy uruchamiasz aplikację lub debugujesz ją w Android Studio, Android Studio automatycznie generuje certyfikat podpisywania aplikacji przeznaczony do tworzenia i debugowania. Pełne wyjaśnienia znajdziesz w artykule Android Studio: podpisywanie wersji debugowej.

    Połącz urządzenie mobilne z komputerem lokalnym. Android Studio wyświetli listę połączonych urządzeń według numeru modelu. Wybierz urządzenie z listy, a potem kliknij Uruchom projekt. Spowoduje to wygenerowanie i zainstalowanie przykładowej aplikacji na urządzeniu mobilnym.

    Szczegółowe instrukcje znajdziesz w artykule Uruchamianie aplikacji na urządzeniu z Androidem na stronie dla deweloperów aplikacji na Androida.

    Teraz zamknij uruchomioną aplikację.

  2. Aby uzyskać odcisk palca SHA-1 certyfikatu debugowania, wykonaj instrukcje podane w sekcji Zarządzanie klientami OAuth / Typy aplikacji / Aplikacje natywne / Android w Centrum pomocy Google Cloud Console.

  1. W konsoli Google Cloud otwórz panel wyboru projektu i wybierz projekt, którego chcesz użyć do utworzenia danych uwierzytelniających OAuth.
  2. Otwórz stronę Interfejsy API i usługi, a potem w menu nawigacyjnym kliknij Dane logowania.

  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 tej procedury. W przeciwnym razie 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 Wewnętrzny lub Zewnętrzny, a następnie kliknij Utwórz. Pojawi 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 Testowi użytkownicy.
    5. Kliknij kolejno Odbiorcy i przycisk + DODAJ UŻYTKOWNIKÓW.
    6. Wpisz adres e-mail testowego użytkownika i kliknij przycisk ZAPISZ.
    7. Kliknij Zapisz i kontynuuj. Pojawi się panel Podsumowanie.
    8. Zapoznaj się z informacjami na ekranie zgody OAuth, a potem kliknij Wróć do panelu.

Więcej informacji znajdziesz w artykule Konfigurowanie ekranu zgody OAuth w Centrum pomocy konsoli Google Cloud. Zanim przejdziesz dalej, dodaj co najmniej 1 użytkownika testowego.

Konfigurowanie danych logowania OAuth

  1. Zarejestruj przykładową aplikację do OAuth 2.0 i utwórz dane logowania OAuth, wykonując instrukcje podane w artykule Konfigurowanie OAuth 2.0.
    1. Wskazać typ aplikacji, czyli natywna aplikacja na Androida.
    2. Dodaj odcisk cyfrowy SHA-1 do klienta OAuth, wykonując instrukcje w artykule Konfigurowanie OAuth 2.0 / Aplikacje natywne / Android w Centrum pomocy Google Cloud Console. W trakcie procesu tworzenia aplikacji należy wygenerować klucz SHA-1 z domyślnego klucza Androida Studio.

Uruchamianie aplikacji

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

Po zainstalowaniu aplikacja będzie dostępna na urządzeniu mobilnym jako próbna aplikacja interfejsu Home API.