1. Прежде чем начать
Что вы построите
В этом практическом занятии вы расширите существующее демонстрационное приложение Android Home API, используя базу знаний Home API и Gemini в Android Studio для автоматизации создания пользовательского интерфейса и интеграции API. Вы добавите интерфейс отладки, который позволит пользователям выводить логи и обобщать информацию о своей домашней сети для отладки и разработки.
Мощный дуэт: база знаний Home API + Gemini в Android Studio
Этот рабочий процесс основан на двух важнейших компонентах:
- База знаний Home API: тщательно подобранный документ (
google-home-api-knowledge-base.txt), который предоставляет Gemini информацию о конкретных технических ограничениях, моделях и методах, необходимых для взаимодействия с устройствами Google Home. - См.: https://developers.home.google.com/apis/android/knowledge-base
- Gemini в Android Studio: инструмент для совместной работы на основе искусственного интеллекта, который интегрируется непосредственно в вашу IDE. Он учитывает контекст вашего кода, ресурсов и терминала.
Что вы узнаете
- Как предоставить базу знаний Home API в качестве контекста для Gemini в Android Studio.
- Как использовать Vibe-code с Gemini в Android Studio для добавления новых функций в существующее демонстрационное приложение Home API.
2. Предварительные условия и настройка
Перед продолжением убедитесь, что выполнены следующие действия:
- Сборка и запуск демонстрационного приложения Home API для Android: Следуйте инструкциям по адресу https://developers.home.google.com/apis/android/sample-app/build#build_the_app, чтобы собрать и запустить демонстрационное приложение, на основе которого создан наш практический пример .
- Настройка среды
- Скачайте Android Studio: установите последнюю стабильную версию (Koala или новее) с официального сайта разработчиков .
- Включение Gemini: Откройте окно инструментов Gemini (обычно оно находится на правой боковой панели). Войдите в свою учетную запись Google и примите условия, чтобы активировать ИИ-помощника. Инструкции см. на странице https://developer.android.com/studio/gemini/get-started .
- Файл базы знаний: Убедитесь, что файл
google-home-api-knowledge-base.txtсохранен в каталоге вашего проекта. - Примечание: Если вы клонировали пример приложения с официального репозитория GitHub, этот файл уже находится в папке
tools/.
3. Создайте файл AGENTS.md.
Вместо того чтобы повторять инструкции в каждом чате, создайте постоянный «мозг» для Близнецов.
В корневой директории вашего проекта создайте новый файл с именем AGENTS.md и вставьте в него следующий текст:
**Role:** You are an expert Android Home API Developer.
**Context:** This project uses the Google Home APIs.
**Source of Truth:** Always reference tools/google-home-api-knowledge-base.txt for Home API patterns, data models (Structures, Automations), and debugging methods.
**Guidelines:** Prioritize Material 3 Compose components and ensure all code is compatible with the latest Home API SDK.
В разделе «Контекст» поставьте галочку рядом с AGENTS.md Files .
Давайте проверим, успешно ли прошла настройка. Отправьте Gemini следующее сообщение:
Can you see the Agents.md file? Do you know what file you need to check first before developing with Google Home API?
Вы должны увидеть результат, аналогичный приведенному ниже, с указанием на то, что программа считывает файл AGENTS.md и будет использовать файл базы знаний!
4. Создайте новую вкладку «Отладка».
Используйте Gemini + базу знаний, чтобы изменить файл HomeAppView.kt и добавить новый пункт навигации.
Прежде чем начать, вот как должно выглядеть ваше текущее демонстрационное приложение Home APIs:
Предложите Gemini использовать значок шестеренки для обозначения новой вкладки отладки.
Can you help to add a wheel icon as the third tab in the HomeAppView .
Ниже представлен пример диалога в формате «вопрос-ответ» с Gemini в Android Studio.
Теперь внизу появилась новая вкладка «Отладка»:
5. Создайте 2 новые кнопки для «Структуры дампа» и «Автоматизации дампа».
Подсказка для Близнецов:
Create two selectable buttons on the Debug page called "Dump Structure" and "Dump Automations".
Теперь на странице отладки добавлены 2 новые кнопки.
6. Реализуйте функциональность "Структура дампа".
Подсказка для Близнецов:
Implement the first button "Dump Structure" to call dumpStructure(structure: Structure) in Debugger.kt with current selected structure.
При нажатии кнопки "Выгрузить структуру" журналы структуры будут выгружены в LogCat.
7. Внедрить функционал "Автоматизация дампа".
Подсказка для Близнецов:
Now Implement the "Dump Automation" functionality to call dumpAutomationsInStructure(structure: Structure) in Debugger.kt with current selected structure.
При нажатии кнопки "Выгрузить автоматизацию" журналы автоматизации будут выгружены в LogCat.
8. Добавьте кнопку «Сводка по дому», которая будет отображать список текущих комнат и устройств.
Подсказка для Близнецов:
In Debug tab, add a button "Summarize Home" to find the current room and devices with Home API and show them on a dialog.
На странице отладки появилась новая кнопка «Краткое изложение главной страницы».
При нажатии на него отобразится актуальная сводка по комнатам и устройствам.
9. Просмотрите изменения.
Gemini также может помочь просмотреть изменения (или последний коммит в Git), выявить потенциальные проблемы и исправить их.
Подсказка для Близнецов:
Review the uncommitted changes and find potential issues.
10. Поздравляем!
Поздравляем! Вы успешно расширили функциональность своего демонстрационного приложения Android Home API, используя базу знаний Home API и Gemini для автоматизации создания пользовательского интерфейса и интеграции API! Теперь, когда вы знаете, как расширить функциональность демонстрационного приложения с помощью разработки на основе ИИ, вот еще несколько вещей, которые вы можете попробовать:
- Усовершенствуйте свой файл AGENTS.md : поэкспериментируйте с добавлением в файл
AGENTS.mdопределенных стандартов кодирования или рекомендаций по фирменному стилю, чтобы увидеть, как это повлияет на предлагаемый Gemini код. - Создайте собственную автоматизацию : используйте Gemini и базу знаний, чтобы написать скрипт, который запускает процедуру «Спокойной ночи», например, блокирует все двери и приглушает свет.
- Ознакомьтесь с официальным руководством по базе знаний Home API и посмотрите видео «Ускорьте разработку с помощью Gemini и базы знаний».