Desarrolla una app de la API de Android Home con la base de conocimiento de la API de Home y Gemini

1. Antes de comenzar

Qué compilarás

En este codelab, extenderás una app de ejemplo de la API de Home existente con la base de conocimientos de la API de Home y Gemini en Android Studio para automatizar la creación de la IU y la integración de la API. Agregarás una interfaz de depuración que permita a los usuarios volcar registros y resumir su Home para la depuración y el desarrollo.

El dúo potente: Base de conocimientos de la API de Home + Gemini en Android Studio

Este flujo de trabajo se basa en dos componentes fundamentales:

  • Base de conocimientos de la API de Home: Es un archivo de documentación seleccionado (google-home-api-knowledge-base.txt) que proporciona a Gemini las restricciones técnicas, los modelos y los métodos específicos necesarios para interactuar con los dispositivos Google Home.
  • Consulta: https://developers.home.google.com/apis/android/knowledge-base
  • Gemini en Android Studio: Es un colaborador potenciado por IA que reside directamente en tu IDE. Tiene en cuenta el contexto de tu código, recursos y terminal.

Qué aprenderás

  • Cómo proporcionar la base de conocimientos de la API de Home como contexto a Gemini en Android Studio
  • Cómo usar vibe coding con Gemini en Android Studio para agregar funciones nuevas a la app de ejemplo de la API de Home existente

2. Requisitos previos y configuración

Asegúrate de que se haya completado lo siguiente antes de continuar:

  • Compila y ejecuta la app de ejemplo de las APIs de Home para Android: Sigue las instrucciones en https://developers.home.google.com/apis/android/sample-app/build#build_the_app para compilar y ejecutar la app de ejemplo en la que se basa nuestro codelab.
  • Configuración del entorno
  • Descarga Android Studio: Instala la versión estable más reciente (Koala o posterior) desde el sitio oficial para desarrolladores.
  • Habilita Gemini: Abre la ventana de herramientas Gemini (por lo general, en la tira del lado derecho). Accede con tu Cuenta de Google y acepta las condiciones para activar el asistente de IA. Consulta https://developer.android.com/studio/gemini/get-started para obtener instrucciones.
  • Archivo de la base de conocimientos: Asegúrate de tener el archivo google-home-api-knowledge-base.txt guardado en el directorio de tu proyecto.
  • Nota: Si clonaste la app de ejemplo desde la app de ejemplo oficial de GitHub, este archivo ya está incluido en la carpeta tools/.

3. Crea el archivo AGENTS.md

En lugar de repetir instrucciones en cada chat, crea un "cerebro" persistente para Gemini.

En la raíz de tu proyecto, crea un archivo nuevo llamado AGENTS.md y pega el siguiente contexto:

**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.

En "Context", marca la casilla junto a AGENTS.md Files.

2047b69244c9da6e.png

Verifiquemos si la configuración se realizó correctamente. Escribe instrucciones en Gemini para:

Can you see the Agents.md file? Do you know what file you need to check first before developing with Google Home API?

Deberías ver un resultado similar al siguiente, en el que se menciona que está leyendo el archivo AGENTS.md y que usará el archivo de la base de conocimientos.

830ef529169d47b.png

4. Crea una pestaña de depuración nueva

Usa Gemini + la base de conocimientos para modificar HomeAppView.kt y agregar un destino de navegación nuevo.

Antes de comenzar, así debería verse tu app de ejemplo de las APIs de Home actual:

981f74eb250a2552.png

Escribe instrucciones en Gemini para usar un ícono de rueda para representar la nueva pestaña de depuración.

Can you help to add a wheel icon as the third tab in the HomeAppView .

A continuación, se muestra un posible diálogo de instrucciones y respuestas con Gemini en Android Studio.

c9cf695cb6549fa3.png

Ahora podemos ver una nueva pestaña "Debug" en la parte inferior:

ac1e16cc6bcae224.png

5. Crea 2 botones nuevos para "Dump Structure" y "Dump Automation"

Escribe instrucciones en Gemini para:

Create two selectable buttons on the Debug page called "Dump Structure" and "Dump Automations".

Ahora tenemos 2 botones nuevos agregados en la página Debug.

451ad164998d527c.png

6. Implementa la función "Dump Structure"

Escribe instrucciones en Gemini para:

Implement the first button "Dump Structure" to call dumpStructure(structure: Structure) in Debugger.kt with current selected structure.

Cuando hagas clic en el botón "Dump Structure", los registros de estructura se volcarán a LogCat.

af7295a2ad999798.png

7. Implementa la función "Dump Automation"

Escribe instrucciones en Gemini para:

Now Implement the "Dump Automation" functionality to call dumpAutomationsInStructure(structure: Structure) in Debugger.kt with current selected structure.

Cuando hagas clic en el botón "Dump Automation", los registros de automatización se volcarán a LogCat.

d5ea7f17e29d9220.png

8. Implementa un botón "Summarize Home" que muestre las habitaciones y los dispositivos actuales

Escribe instrucciones en Gemini para:

In Debug tab, add a button "Summarize Home" to find the current room and devices with Home API and show them on a dialog.

Un nuevo botón "Summarize Home" en la página Debug

a4cf16a09f535f8b.png

Cuando hagas clic en él, se mostrará un resumen actual de las habitaciones y los dispositivos.

cd2dcccc60947445.png

9. Revisa los cambios

Gemini también puede ayudarte a revisar los cambios (o la última confirmación de Git), encontrar los posibles problemas y solucionarlos.

Escribe instrucciones en Gemini para:

Review the uncommitted changes and find potential issues.

816ea8380bffc14f.png

10. ¡Felicitaciones!

¡Felicitaciones! Extendiste correctamente tu app de ejemplo de la API de Home para Android con la base de conocimientos de la API de Home y Gemini para automatizar la creación de la IU y la integración de la API. Ahora que sabes cómo extender la app de ejemplo con el desarrollo basado en IA, puedes probar lo siguiente: