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 starsze wersje mogą nie działać prawidłowo z pakietem SDK interfejsów Home API.

    Pobierz Android Studio

  • Debugger Androida (adb).

    Zainstaluj adb.

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

Aby przetestować interfejsy Home API, musisz mieć:

  • Urządzenie z Androidem 10 lub nowszym skonfigurowane za pomocą konta Google, którego chcesz używać do programowania. Upewnij się, że masz zainstalowaną aktualną wersję Android Studio i że jesteś zalogowany(-a) na to konto dewelopera.
  • Sieć Wi-Fi.
  • Aby uzyskać dostęp do urządzeń Matter i nimi sterować, potrzebujesz też huba Google, który obsługuje interfejsy Home API. Więcej informacji znajdziesz w artykule Łączność na Androidzie .

  • Co najmniej 1 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 próbna na Androida obsługuje te typy urządzeń i cechy:

    • Ś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ść)
    • Światło o rozszerzonej palecie barw (włączanie i wyłączanie, jasność)
    • Przełącznik ogólny
    • Aparat Google
    • Czujnik obecności (wykrywanie obecności)
    • Światło z włącznikiem (włączanie i wyłączanie, jasność)
    • Włącznik światła
    • Gniazdko z włącznikiem (włączanie i wyłączanie)
    • Czujnik włączania i wyłączania

Pobieranie kodu źródłowego

Kod źródłowy aplikacji próbnej jest dostępny na GitHubie.

Przejdź do miejsca, w którym chcesz zapisać projekt, a potem go skopiuj:

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

Konfigurowanie pakietu SDK

Interfejsy Home API na Androida w tej otwartej wersji 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ę teraz

Tworzenie aplikacji

  1. Otwórz Android Studio, a potem otwórz folder projektu google-home-api-sample-app-android, który został skopiowany na Twój komputer.

  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. Upewnij się, że Android Studio może połączyć się z telefonem z Androidem przez ADB.

  4. Zmień nazwę pakietu aplikacji próbnej na nową, która nie została jeszcze zarejestrowana, np. na podstawie nazwy 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 > Rename... Refaktoryzacja > Zmień nazwę
    5. Wpisz nową nazwę i kliknij Refactor.
    6. Edytuj plik build.gradle.kts, zmieniając android namespace i applicationId na nową nazwę pakietu.

  5. Gdy wszystkie wymagane biblioteki zostaną pobrane i synchronizacja Gradle się zakończy, kliknij przycisk Uruchom , aby utworzyć i uruchomić aplikację. Gdy aplikacja będzie działać prawidłowo na telefonie, zobaczysz stronę główną aplikacji próbnej.

Tworzenie certyfikatu podpisywania

Gdy uruchamiasz lub debugujesz aplikację w Android Studio, automatycznie generuje ona certyfikat debugowania przeznaczony do programowania i debugowania. Pełne wyjaśnienie znajdziesz w artykule Android Studio: Sign your debug build (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: Sign your debug build (Android Studio: podpisywanie kompilacji do debugowania).

    Podłącz urządzenie mobilne do komputera. Android Studio wyświetli listę podłączonych urządzeń według numeru modelu. Wybierz urządzenie z listy, a potem kliknij Uruchom projekt. Spowoduje to utworzenie i zainstalowanie aplikacji próbnej na urządzeniu mobilnym.

    Bardziej szczegółowe instrukcje znajdziesz na stronie dla deweloperów aplikacji na Androida w artykule Run apps on a hardware device (Uruchamianie aplikacji na urządzeniu sprzętowym).

    Teraz zatrzymaj działającą aplikację.

  2. Uzyskaj odcisk palca SHA-1 certyfikatu debugowania, postępując zgodnie z instrukcjami podanymi w Manage OAuth Clients / Application Types / Native applications / Android na stronie pomocy konsoli Google Cloud.

  1. W konsoli Google Cloud otwórz panel wyboru projektu i wybierz projekt, którego chcesz użyć do utworzenia danych logowania 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 dla tego projektu 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. Na stronie informacji o aplikacji wpisz informacje zgodnie z instrukcjami wyświetlanymi na ekranie, a potem kliknij Zapisz i kontynuuj. Wyświetli 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 kliknij 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.

Pełne informacje znajdziesz na stronie pomocy konsoli Google Cloud w artykule Setting up your OAuth consent screen (Konfigurowanie ekranu zgody OAuth). Zanim przejdziesz dalej, dodaj co najmniej 1 użytkownika testowego.

Konfigurowanie danych logowania OAuth

  1. Zarejestruj aplikację próbną w OAuth 2.0 i utwórz dane logowania OAuth, postępując zgodnie z instrukcjami podanymi w Konfigurowanie OAuth 2.0.
    1. Wskaż typ aplikacji, czyli aplikacja natywna/na Androida.
    2. Dodaj odcisk palca SHA-1 do klienta OAuth, postępując zgodnie z instrukcjami podanymi na stronie pomocy konsoli Google Cloud w artykule Setting up OAuth 2.0 / Native applications / Android (Konfigurowanie OAuth 2.0 / Aplikacje natywne / Android). Podczas całego procesu programowania należy generować klucz SHA-1 z domyślnego klucza Android Studio.

Uruchamianie aplikacji

  1. Gdy urządzenie mobilne jest podłączone do komputera, kliknij ponownie Uruchom projekt , aby uruchomić aplikację próbną na urządzeniu mobilnym.

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