Главная API Пример приложения для Android

Пример приложения демонстрирует основные возможности API Google Home для Android.

Предпосылки

Чтобы создать, установить и протестировать приложение, вам необходимо выполнить несколько предварительных условий:

  • Android Studio версии 2024.2.1 («Ladybug») или более поздней. Обратите внимание, что версии, более ранние, могут работать некорректно с Home APIs SDK.

    Загрузить Android-студию

  • Отладчик Android ( adb ).

    Установить adb .

    Это можно сделать с помощью SDK Manager .

Для тестирования API Home вам понадобится:

  • Устройство Android под управлением Android 10 или более поздней версии, настроенное с учётной записью Google, которую вы планируете использовать для разработки. Убедитесь, что установлена ​​актуальная версия Android Studio и выполнен вход с этой учётной записью разработки.
  • Сеть Wi-Fi.
  • Для доступа и управления устройствами Matter вам также понадобится Google Hub, поддерживающий Home API . Подробности см. в разделе Connectivity on Android .

  • Как минимум одно поддерживаемое устройство в доме. Если это устройство (или любое другое, которое вы хотите протестировать) использует Thread, концентратор также должен быть граничным маршрутизатором Thread. Пример приложения для Android поддерживает следующие типы устройств и характеристики:

    • Цветовая температура света (вкл. и выкл., яркость)
    • Контактный датчик (булевое состояние)
    • Регулируемый свет (включение и выключение, яркость)
    • Расширенная цветовая подсветка (вкл./выкл., яркость)
    • Универсальный коммутатор
    • Датчик присутствия (определение присутствия)
    • Вкл./Выкл. Свет (вкл. и выкл., яркость)
    • Переключатель вкл/выкл света
    • Вставной блок включения/выключения (вкл. и выкл.)
    • Датчик вкл/выкл

Загрузить исходный код

Исходный код примера приложения доступен на GitHub.

Перейдите туда, где вы хотите сохранить проект, затем клонируйте его:

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

Настройте SDK

API Home для Android в этой открытой бета-версии пока не входят в стандартные библиотеки, предоставляемые Google для разработки. Для разработки приложений Android с использованием API Home необходимо загрузить и разместить библиотеки локально.

Чтобы загрузить Android SDK Home API, вам необходимо сначала войти в систему Google Home Developers.

Войдите сейчас!

Создайте приложение

  1. Откройте Android Studio , затем откройте папку проекта google-home-api-sample-app-android клонированную на локальный компьютер.

  2. Во время первой настройки Android Studio может потребоваться до 10 минут для загрузки всех зависимостей проекта и завершения сборки Gradle.

  3. Подключите компьютер к физическому телефону Android через USB-кабель и включите ADB в параметрах разработчика . Убедитесь, что Android Studio может подключаться к телефону Android через ADB.

  4. Измените имя пакета для примера приложения на новое, которое ранее не было зарегистрировано, например, на имя, основанное на названии вашей организации:

    1. Откройте проект.
    2. Раскройте иерархию источников.
    3. Выберите часть пакета, которую вы хотите изменить, другими словами, com.example .
    4. Щелкните правой кнопкой мыши по пакету и выберите Рефакторинг > Переименовать... Рефакторинг > Переименовать меню
    5. Введите новое имя и нажмите «Рефакторинг» .
    6. Отредактируйте файл build.gradle.kts , изменив android namespace и applicationId на новое имя пакета.

  5. После загрузки всех необходимых библиотек и завершения синхронизации Gradle нажмите кнопку «Запустить» , чтобы собрать и запустить приложение. После успешного запуска приложения на вашем телефоне вы увидите главную страницу приложения Sample App.

Создать сертификат подписи

При запуске или отладке приложения в Android Studio автоматически генерируется отладочный сертификат, предназначенный для разработки и отладки. Подробное описание см. в статье Android Studio: Подписание отладочной сборки .

  1. Создайте сертификат подписи отладочного приложения, запустив его в Android Studio . При запуске или отладке приложения в Android Studio , Android Studio автоматически генерирует сертификат подписи приложения, предназначенный для разработки и отладки. Подробное описание см. в статье Android Studio: Подписание отладочной сборки .

    Подключите мобильное устройство к локальному компьютеру. Android Studio отобразит список подключенных устройств по номеру модели. Выберите устройство из списка и нажмите «Запустить проект» . Это позволит собрать и установить пример приложения на ваше мобильное устройство.

    Более подробные инструкции см. в разделе Запуск приложений на аппаратном устройстве на сайте разработчиков Android.

    Теперь остановите работающее приложение.

  2. Получите отпечаток SHA-1 вашего отладочного сертификата, следуя инструкциям, подробно описанным в разделе Управление клиентами OAuth / Типы приложений / Собственные приложения / Android на сайте справки Google Cloud Console.

  1. В консоли Google Cloud перейдите на панель выбора проектов и выберите проект, который вы хотите использовать для создания учетных данных OAuth.
  2. Перейдите на страницу API и сервисы и нажмите «Учетные данные» в меню навигации.

  3. Если вы ещё не настроили экран согласия для этого проекта Google Cloud, появится кнопка «Настроить экран согласия» . В этом случае настройте экран согласия, следуя следующей процедуре. В противном случае перейдите к следующему разделу.

    1. Нажмите Настроить экран согласия . Отобразится страница экрана согласия OAuth .
    2. В зависимости от вашего варианта использования выберите Внутренний или Внешний , а затем нажмите Создать . Отобразится панель экрана согласия OAuth .
    3. Введите информацию на странице информации о приложении в соответствии с инструкциями на экране, а затем нажмите Сохранить и продолжить . Отобразится панель областей .
    4. Вам не нужно добавлять какие-либо области, поэтому нажмите Сохранить и продолжить . Отобразится панель Тестовые пользователи .
    5. Нажмите «Аудитория» и нажмите кнопку + ДОБАВИТЬ ПОЛЬЗОВАТЕЛЕЙ .
    6. Введите адрес электронной почты тестового пользователя и нажмите кнопку СОХРАНИТЬ .
    7. Нажмите Сохранить и продолжить . Отобразится панель Сводка .
    8. Проверьте информацию на экране согласия OAuth, а затем нажмите « Назад на панель управления» .

Подробную информацию см. в разделе Настройка экрана согласия OAuth на сайте справки Google Cloud Console. Перед продолжением обязательно добавьте хотя бы одного тестового пользователя.

Настройте учетные данные OAuth

  1. Зарегистрируйте пример приложения для OAuth 2.0 и создайте учетные данные OAuth, следуя инструкциям в разделе Настройка OAuth 2.0 .
    1. Укажите тип приложения: собственное/Android-приложение .
    2. Добавьте отпечаток SHA-1 в клиент OAuth, следуя инструкциям в разделе «Настройка OAuth 2.0 / Нативные приложения / Android» на сайте справки Google Cloud Console. Ключ SHA-1 следует генерировать на основе ключа Android Studio по умолчанию в процессе разработки.

Запустите приложение

  1. Подключив мобильное устройство к локальному компьютеру, снова нажмите «Запустить проект» , чтобы запустить пример приложения на мобильном устройстве.

После установки приложение станет доступно на вашем мобильном устройстве как пример приложения Home API .