App de ejemplo de las APIs de Home para Android

La app de ejemplo muestra las capacidades básicas de las APIs de Google Home para Android.

Requisitos previos

Para compilar, instalar y probar la app, debes cumplir con algunos requisitos previos:

  • Android Studio, versión 2024.2.1 ("Ladybug") o posterior. Ten en cuenta que es posible que las versiones anteriores no funcionen correctamente con el SDK de las APIs de Home.

    Descarga Android Studio

  • El depurador de Android (adb).

    Instala adb.

    Esto se puede hacer con el SDK Manager.

Para probar las APIs de Home, necesitarás lo siguiente:

  • Un dispositivo Android con Android 10 o versiones posteriores configurado con una Cuenta de Google que piensas usar para el desarrollo. Asegúrate de que esté instalada una versión actualizada de la Android Studio y que hayas accedido con esta cuenta de desarrollo.
  • Una red Wi-Fi
  • Para acceder a los dispositivos Matter y controlarlos, también necesitas un concentrador de Google que admita las APIs de Home. Consulta Conectividad en Android para obtener más detalles.

  • Al menos un dispositivo compatible en la casa. Si este dispositivo (o cualquier otro que quieras probar) usa Thread, el concentrador también debe ser un router de borde de Thread. La app de ejemplo para Android admite los siguientes tipos de dispositivos y atributos:

    • Luz de temperatura de color (encendido y apagado, brillo)
    • Sensor de contacto (estado booleano)
    • Luz regulable (encendido y apagado, brillo)
    • Luz de color extendida (encendido y apagado, brillo)
    • Interruptor genérico
    • Router de borde de Google
    • Cámara de Google
    • Sensor de ocupación (detección de ocupación)
    • Luz de encendido/apagado (encendido y apagado, brillo)
    • Interruptor de luz de encendido/apagado
    • Unidad de conexión de encendido/apagado (encendido y apagado)
    • Sensor de encendido/apagado

Descarga el código fuente

El código fuente de la app de ejemplo está disponible en GitHub.

Navega hasta donde quieras guardar el proyecto y, luego, clónalo:

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

Configura el SDK

Las APIs de Home para Android en esta versión beta abierta aún no forman parte de las bibliotecas estándar que proporciona Google para el desarrollo. Para desarrollar aplicaciones para Android con las APIs de Home, debes descargar y alojar las bibliotecas de forma local.

Para descargar el SDK de las APIs de Home para Android, primero debes acceder a Google Home Developers.

Acceder ahora

Compila la app

  1. Abre Android Studio y, luego, abre la carpeta del proyecto google-home-api-sample-app-android que se clonó en tu máquina local.

  2. Durante la primera configuración, Android Studio puede tardar hasta 10 minutos en descargar todas las dependencias del proyecto y completar la compilación de Gradle.

  3. Conecta tu computadora a un teléfono Android físico con un cable USB y habilita ADB en las opciones para desarrolladores. Asegúrate de que Android Studio pueda conectarse al teléfono Android a través de ADB.

  4. Cambia el nombre del paquete de la app de ejemplo por uno nuevo que no se haya registrado antes, como uno basado en el nombre de tu organización:

    1. Abre el proyecto.
    2. Expande la jerarquía de origen.
    3. Selecciona la parte del paquete que quieres cambiar, es decir, com.example.
    4. Haz clic con el botón derecho en el paquete y selecciona Refactor > Rename... Menú Refactor > Rename
    5. Ingresa el nombre nuevo y haz clic en Refactor.
    6. Edita el archivo build.gradle.kts, cambia el android namespace y el applicationId al nombre del paquete nuevo.

  5. Después de descargar todas las bibliotecas necesarias y completar la sincronización de Gradle, haz clic en el botón Run para compilar y ejecutar la app. Cuando la app se ejecute correctamente en tu teléfono, verás la página principal de la app de ejemplo.

Crea un certificado de firma

Cuando ejecutas o depuras una app en Android Studio, se genera automáticamente un certificado de depuración destinado al desarrollo y la depuración. Consulta Android Studio: Sign your debug build para obtener una explicación completa.

  1. Para generar un certificado de firma de app de depuración, ejecuta la app en Android Studio. Cuando ejecutas o depuras una app en Android Studio, Android Studio genera automáticamente un certificado de firma de app destinado al desarrollo y la depuración. Consulta Android Studio: Sign your debug build para obtener una explicación completa.

    Conecta tu dispositivo móvil a tu máquina local. Android Studio mostrará tus dispositivos conectados por número de modelo. Selecciona tu dispositivo de la lista y, luego, haz clic en Run project. De esta manera, se compila y se instala la app de ejemplo en tu dispositivo móvil.

    Para obtener instrucciones más detalladas, consulta Cómo ejecutar apps en un dispositivo de hardware en el sitio para desarrolladores de Android.

    Ahora, detén la app en ejecución.

  2. Para obtener la huella digital SHA-1 de tu certificado de depuración, sigue las instrucciones que se detallan en Manage OAuth Clients / Application Types / Native applications / Android en el sitio de ayuda de la consola de Google Cloud.

  1. En la consola de Google Cloud, ve al panel del selector de proyectos y selecciona el proyecto que quieres usar para crear credenciales de OAuth.
  2. Ve a la página APIs and Services y haz clic en Credentials en el menú de navegación.

  3. Si aún no configuraste la pantalla de consentimiento para este proyecto de Google Cloud, aparecerá el botón Configure consent screen. En ese caso, configura la pantalla de consentimiento con el siguiente procedimiento. De lo contrario, continúa con la siguiente sección.

    1. Haz clic en Configure consent screen. Se mostrará la página OAuth consent screen.
    2. Según tu caso de uso, selecciona Internal o External y, luego, haz clic en Create. Se mostrará el panel OAuth consent screen.
    3. Ingresa la información en la página App information según las instrucciones en pantalla y, luego, haz clic en Save and continue. Se mostrará el panel Scopes.
    4. No es necesario agregar ningún permiso, así que haz clic en Save and continue. Se mostrará el panel Test users.
    5. Haz clic en Audience y, luego, en el botón + ADD USERS.
    6. Ingresa la dirección de correo electrónico del usuario de prueba y haz clic en el botón SAVE.
    7. Haz clic en Save and continue. Se mostrará el panel Summary.
    8. Revisa la información de la pantalla de consentimiento de OAuth y, luego, haz clic en Back to dashboard.

Consulta Configura tu pantalla de consentimiento de OAuth en el sitio de ayuda de la consola de Google Cloud para obtener todos los detalles. Asegúrate de agregar al menos un usuario de prueba antes de continuar.

Configura las credenciales de OAuth

  1. Registra la app de ejemplo para OAuth 2.0 y crea credenciales de OAuth siguiendo las instrucciones que se proporcionan en Configura OAuth 2.0.
    1. Indica el tipo de aplicación, que es app nativa/para Android.
    2. Para agregar la huella digital SHA-1 al cliente de OAuth, sigue las instrucciones que se indican en Configura OAuth 2.0 / Aplicaciones nativas / Android en el sitio de ayuda de la consola de Google Cloud. Debes generar la clave SHA-1 desde la clave predeterminada de Android Studio durante todo el proceso de desarrollo.

Ejecuta la app

  1. Con el dispositivo móvil conectado a tu máquina local, vuelve a hacer clic en Run project para ejecutar la app de ejemplo en tu dispositivo móvil.

Una vez instalada, la app estará disponible en tu dispositivo móvil como Home API Sample App.