Главная 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 нажмите кнопку Run , чтобы собрать и запустить приложение. Когда приложение успешно запустится на вашем телефоне, вы увидите главную страницу Sample App.

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

Когда вы запускаете или отлаживаете приложение в Android Studio , оно автоматически генерирует отладочный сертификат, предназначенный для разработки и отладки. См. Android Studio: Sign your debug build для полного объяснения.

  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 .