App de ejemplo de Android para las APIs de Home

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, deberás cumplir con algunos requisitos previos:

  • Android Studio, versión 2024.2.1 (“Mariquita”) o posterior. Ten en cuenta que las versiones anteriores a esta podrían no funcionar 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 una versión posterior configurado con una Cuenta de Google que piensas usar para el desarrollo Asegúrate de que esté instalada una versión actualizada de Android Studio y de que hayas accedido con esta cuenta de desarrollo.
  • Una red Wi-Fi
  • Para acceder a los dispositivos Matter y controlarlos, también necesitas una unidad central 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, la unidad central también debe ser un router de borde Thread. La app de ejemplo para Android admite los siguientes tipos y rasgos de dispositivos:

    • Luz de temperatura de color (encendido y apagado, brillo)
    • Sensor de contacto (estado booleano)
    • Luz regulable (encendido y apagado, brillo)
    • Luz de color extendida (encendida y apagada, brillo)
    • Cambio genérico
    • 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 activada/desactivada (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.

Accede 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 la fuente.
    3. Selecciona la parte del paquete que deseas 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 y cambia android namespace y applicationId por el nuevo nombre del paquete.

  5. Después de descargar todas las bibliotecas necesarias y completar la sincronización de Gradle, haz clic en el botón Ejecutar 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: Firma tu compilación de depuración para obtener una explicación completa.

  1. Genera un certificado de firma de la app de depuración ejecutando la app en Android Studio. Cuando ejecutas o depuras una app en Android Studio, Android Studio genera automáticamente un certificado de firma de la app destinado al desarrollo y la depuración. Consulta Android Studio: cómo firmar tu compilación de depuración para obtener una explicación completa.

    Conecta tu dispositivo móvil a la 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. Esto compila e 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 Administrar clientes de OAuth / Tipos de aplicaciones / Aplicaciones nativas / 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 deseas usar para crear credenciales de OAuth.
  2. Ve a la página APIs y servicios y haz clic en Credenciales 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 Configurar pantalla de consentimiento. 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 Configurar pantalla de consentimiento. Se mostrará la página Pantalla de consentimiento de OAuth.
    2. Según tu caso de uso, selecciona Interna o Externa y, luego, haz clic en Crear. Se muestra el panel Pantalla de consentimiento de OAuth.
    3. Ingresa la información en la página de información de la app según las instrucciones en pantalla y, luego, haz clic en Guardar y continuar. Aparecerá el panel Scopes.
    4. No es necesario que agregues ningún alcance, así que haz clic en Guardar y continuar. Aparecerá el panel Usuarios de prueba.
    5. Haz clic en Público y, luego, en el botón + AGREGAR USUARIOS.
    6. Ingresa la dirección de correo electrónico del usuario de prueba y haz clic en el botón GUARDAR.
    7. Haga clic en Guardar y continuar. Aparecerá el panel Resumen.
    8. Revisa la información de la pantalla de consentimiento de OAuth y, luego, haz clic en Volver al panel.

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. Agrega la huella digital SHA-1 al cliente de OAuth siguiendo las instrucciones que se indican en Configuración de OAuth 2.0 / Aplicaciones nativas / Android en el sitio de ayuda de Google Cloud Console. Debes generar la clave SHA-1 a partir de 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.