Aplikacja przykładowa interfejsów API Home na Androida

Aplikacja przykładowa 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.

    Pobieranie 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. Sprawdź, czy masz zainstalowaną aktualną wersję Android Studio i czy jesteś zalogowany na to konto dewelopera.
  • 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 Androidzie .

  • W domu musi być co najmniej 1 obsługiwane urządzenie. Jeśli to urządzenie (lub inne, które chcesz przetestować) korzysta z Thread, hub musi być również routerem granicznym Thread. Przykładowa aplikacja 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
    • 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 Home API na Androida w ramach tych otwartych testów beta nie są jeszcze częścią standardowych bibliotek udostępnianych przez Google na potrzeby programowania. Aby tworzyć aplikacje na Androida za pomocą interfejsów Home API, musisz pobrać i hostować biblioteki 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 potem 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 fizycznego telefonu z Androidem za pomocą kabla USB i włącz ADB w opcjach programisty. Sprawdź, czy Android Studio może połączyć się z telefonem z Androidem za pomocą ADB.

  4. Zmień nazwę pakietu aplikacji przykładowej na nową, która nie została wcześniej zarejestrowana, np. na nazwę opartą 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.

Tworzenie certyfikatu podpisywania

Gdy uruchamiasz lub debugujesz aplikację w Android Studio, automatycznie generuje ona certyfikat debugowania przeznaczony do tworzenia i debugowania. Szczegółowe 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 debugowania.

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

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

    Teraz zatrzymaj uruchomioną aplikację.

  2. Uzyskaj odcisk SHA-1 certyfikatu debugowania, postępując zgodnie z instrukcjami podanymi w artykule Zarządzanie klientami OAuth / typami aplikacji / aplikacjami natywnymi / Androidem w Centrum pomocy Google Cloud Console.

  1. W konsoli Google Cloud otwórz panel wyboru projektu i wybierz projekt, w którym chcesz utworzyć dane uwierzytelniające OAuth.
  2. Otwórz stronę Interfejsy API i usługi i 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, wykonując te czynności. W przeciwnym razie przejdź do następnej sekcji.

    1. Kliknij Skonfiguruj ekran zgody. Wyświetli się strona Ekran zgody OAuth.
    2. W zależności od przypadku użycia wybierz Wewnętrzny lub Zewnętrzny, a potem 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 potem przycisk + DODAJ UŻYTKOWNIKÓW.
    6. Wpisz adres e-mail użytkownika testowego i kliknij przycisk ZAPISZ.
    7. Kliknij Zapisz i kontynuuj. Wyświetli 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 Centrum pomocy konsoli Google Cloud. Zanim przejdziesz dalej, dodaj co najmniej jednego użytkownika testowego.

Konfigurowanie danych logowania OAuth

  1. Zarejestruj przykładową aplikację w OAuth 2.0 i utwórz dane logowania OAuth, postępując zgodnie z instrukcjami w artykule Konfigurowanie 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. Podczas całego procesu tworzenia aplikacji należy generować klucz SHA-1 z domyślnego klucza Androida Studio.

Uruchamianie aplikacji

  1. Gdy urządzenie mobilne będzie połączone z komputerem lokalnym, ponownie kliknij Uruchom projekt, aby uruchomić aplikację przykładową na urządzeniu mobilnym.

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