Cómo crear y ejecutar una app para wearables

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Las apps para Wear OS se ejecutan directamente en un reloj y proporcionan acceso a hardware como sensores y la GPU. Las apps para wearables son similares a otras que usan el SDK de Android, pero difieren en diseño y funcionalidad.

Una app para Wear OS debería funcionar de manera independiente (sin una para teléfonos) a fin de brindarles a los usuarios mayor flexibilidad en la elección de un teléfono. Si deseas obtener más información, consulta Apps para Wear OS independientes frente a no independientes.

Nota: Puedes probar tu app en un reloj real mediante USB, Wi-Fi o Bluetooth según se describe en Cómo depurar una app de Wear OS. La depuración de tu app en un reloj real te permite evaluar mejor la experiencia del usuario completa. También puedes usar el emulador de reloj en Android Studio para probar tu app con pantallas de diferentes tamaños y formas.

Desarrolla tu entorno

Instala la versión más reciente de Android Studio. Para obtener más información sobre cómo crear apps en Android Studio, consulta Descripción general de proyectos.

Usa SDK Manager para confirmar que tienes la versión más reciente de la plataforma de Android que admite Wear OS, Android 11 (nivel de API 30).

Si deseas que tus apps para Wear OS estén disponibles en China, consulta Cómo crear apps de Wear OS para China.

Cómo crear una app para Wear OS

Puedes crear una app para Wear OS mediante el asistente de New Project de Android Studio.

Cómo iniciar un proyecto de Wear OS

Para crear un proyecto en Android Studio, haz lo siguiente:

  1. Haz clic en File > New > New Project.
  2. En la ventana Project Template, haz clic en la pestaña Wear OS, selecciona Empty Compose Activity y haz clic en Next.
  3. En la ventana New Project, asigna un nombre a tu proyecto, completa su información básica y haz clic en Finish.

    Android Studio creará un proyecto con un módulo de app para tu proveedor de datos.

  4. En el archivo build.gradle para el módulo de la app:
    • En la sección android, confirma que la compileSdkVersion esté establecida en 33.
    • En la sección android, confirma que la targetSdkVersion esté establecida en 30.
    • Reemplaza la sección dependencies por dependencias específicas de Wear OS.
  5. En el archivo de manifiesto de Android, asegúrate de que esté definida la etiqueta <uses-feature>. Define android:name="android.hardware.type.watch" como se muestra en el siguiente ejemplo:
    <manifest>
    ...
      <uses-feature android:name="android.hardware.type.watch" />
    ...
    </manifest>
    
  6. Sincroniza tu proyecto de Android Studio. Para ejecutar el código en el nuevo módulo, consulta Cómo iniciar el emulador y ejecutar tu app para Wear OS.

Cómo iniciar el emulador y ejecutar tu app para Wear OS

Para usar el emulador, configura un dispositivo virtual de Android (AVD). Confirma que tienes la versión más reciente de las herramientas de la plataforma del SDK de Android de SDK Manager.

Configura un AVD y ejecuta tu app de la siguiente manera:

  1. En Android Studio, selecciona Tools > AVD Manager para abrir el Administrador de dispositivos virtuales de Android.
  2. Haz clic en Create Virtual Device.
  3. En el panel Category, selecciona Wear OS y elige un perfil de hardware. Haz clic en Next.
  4. Selecciona una imagen del sistema para descargar. Por ejemplo, selecciona la imagen con API level 30 y el Target "Android 11.0 (Wear OS)". Haz clic en Next y, luego, en Finish.
  5. Cierra el Administrador de dispositivos virtuales de Android.
  6. En la barra de herramientas de Android Studio, ve al menú desplegable del dispositivo de destino, selecciona el AVD que acabas de crear y luego haz clic en Run .

    Se iniciará el AVD y, luego de unos segundos, se ejecutará tu app y se mostrará el mensaje "Hello…".

Para obtener más información sobre cómo usar los AVD, consulta Cómo ejecutar apps en Android Emulator.

Cómo actualizar un proyecto de Wear OS

Si ya tienes un proyecto, es posible que debas actualizar el archivo settings.gradle. Asegúrate de usar google() para indicar el repositorio de Maven de Google. Para obtener información relacionada, consulta el repositorio de Maven de Google.

El archivo settings.gradle de tu proyecto de Android Studio debe incluir lo siguiente:

  dependencyResolutionManagement {
      ...
      repositories {
          google()
          jcenter()
      }
  }

Advertencia: El repositorio de JCenter se convirtió en solo lectura el 31 de marzo de 2021. Para obtener más información, consulta la Actualización del servicio de JCenter.

Configura un reloj

La implementación de una app en un reloj es similar a la de un teléfono.

En esta sección, se supone que tu reloj tiene un puerto USB. Si no lo tiene, consulta las instrucciones para conectar tu reloj mediante Wi-Fi o Bluetooth.

Habilita la depuración por adb en el reloj de la siguiente manera:

  1. Abre el menú de Configuración en el reloj.
  2. Desplázate hasta la parte inferior del menú. Si no aparece el elemento Opciones para desarrolladores, presiona Sistema y, luego, Información.
  3. Presiona el número de versión de compilación 7 veces.
  4. En el menú Configuración, presiona Opciones para desarrolladores.
  5. Habilita Depuración ADB.

Para conectar el reloj, haz lo siguiente:

  1. Conecta el reloj a tu máquina mediante USB de manera que puedas instalar directamente apps en el reloj.
  2. En el reloj, presiona Permitir siempre para esta computadora y haz clic en Aceptar.

Después de conectar el reloj, ejecuta tu app seleccionando un objetivo de implementación según se describe en Cómo compilar y ejecutar tu app.

Cómo configurar un teléfono

En esta sección, se incluye información para configurar un teléfono complementario con una app complementaria de Wear OS.

Nota: Las apps para Wear OS deberían ser independientes y funcionar sin un teléfono. Sin embargo, si tu app depende de una app para teléfonos, consulta la información que aparece debajo sobre cómo actualizar un teléfono con la versión más reciente de la app complementaria de Wear OS.

Cómo usar la versión de Android de la app complementaria

En un teléfono Android, ve a la ficha de la app de Wear OS. Presiona Actualizar para descargar e instalar la app. Después de la instalación, confirma que la opción Actualización automática esté seleccionada para la app (consulta la sección "Configurar actualizaciones automáticas para apps específicas" de Actualizar aplicaciones descargadas). Presiona Abrir para iniciar la app.

Sincroniza un teléfono Android con un reloj

Después de instalar la app complementaria en un teléfono, desvincula cualquier sincronización de reloj obsoleta, si es necesario. Luego, sincroniza el teléfono con un reloj que tenga una imagen nueva:

  1. En el teléfono, selecciona el nombre de tu dispositivo en la lista correspondiente. Se mostrará un código de vinculación en el teléfono y el reloj. Asegúrate de que ambos coincidan.
  2. Presiona Vincular para avanzar con el proceso de vinculación. Cuando se conecta el reloj al teléfono, se muestra un mensaje de confirmación. En el teléfono, aparece una pantalla en la que se indican las cuentas de este.
  3. Selecciona una Cuenta de Google para agregarla tu reloj y sincronizarla con él.
  4. Confirma el bloqueo de pantalla y, luego, ingresa la contraseña para iniciar el copiado de la cuenta del teléfono al reloj.
  5. Sigue las instrucciones del asistente para finalizar el proceso de vinculación.

App complementaria para iPhones

Hay una app complementaria de iOS disponible, pero el teléfono en el que se instale debe ejecutar iOS 8.2 o una versión posterior:

  1. En tu iPhone, visita la App Store para descargar e instalar la app complementaria de Wear OS.
  2. Sigue las instrucciones que aparecen en el reloj y el teléfono para iniciar la vinculación. Si deseas obtener información adicional, consulta la Página de ayuda relacionada.

Cómo vincular dispositivos con un emulador de reloj

Puedes vincular dispositivos con tu dispositivo virtual de Android (AVD) de reloj o el emulador de forma manual, o bien con el asistente de vinculación del emulador de Wear OS.

Cómo usar el asistente de vinculación del emulador de Wear OS

Nota: Tu teléfono debe ejecutar Android 11 (nivel de API 30) o versiones posteriores y tener Google Play Store instalado para usar el asistente de vinculación del emulador de Wear OS. Además, asegúrate de que tus emuladores de Wear ejecuten el nivel de API 28 o versiones posteriores para usar las funciones más recientes del asistente. A fin de actualizar las imágenes del sistema para tus dispositivos emulados, usa SDK Manager.

El asistente de vinculación del emulador de Wear OS facilita la administración y conexión de los emuladores de Wear. Puedes vincular varios dispositivos Wear con un solo teléfono virtual o físico. Android Studio también recuerda y vuelve a vincular dispositivos que se vincularon anteriormente cuando se inician.

Para vincular dos dispositivos, sigue estos pasos:

  1. Si todavía no lo hiciste, crea un emulador de Wear.
  2. En el Administrador de dispositivos, presiona el ícono del menú desplegable "overflow" de uno de los dispositivos que quieras vincular y selecciona Pair Wearable.

    Figura 1: Menú desplegable de un dispositivo que se puede vincular con un emulador de Wear

  3. Se iniciará el asistente de vinculación del emulador de Wear OS. Si hiciste clic en Pair Wearable en un teléfono, verás una lista de dispositivos para Wear disponibles. Si comenzaste con un dispositivo para Wear, verás una lista de teléfonos disponibles. Selecciona el dispositivo que quieras vincular y haz clic en Next.
  4. Android Studio podría tardar unos minutos en iniciar y preparar los dispositivos. Si tu teléfono no tiene instalada la app complementaria de Wear OS, sigue las instrucciones para acceder a Play Store, instalarla y configurarla.
  5. Para vincular dispositivos en la app de Wear OS en el teléfono, haz clic en el menú de tres puntos y selecciona Pair with emulator.

Una vez que tus dispositivos se hayan vinculado correctamente, el Administrador de dispositivos mostrará íconos pequeños junto a ellos. También puedes hacer clic en el menú desplegable "overflow" y seleccionar View Details para ver una lista de dispositivos vinculados.

Figura 2: En la ventana de herramientas Paired Devices, se muestran los dispositivos vinculados con el dispositivo seleccionado.

Cómo sincronizar un teléfono con el AVD de reloj

Si quieres tener una Cuenta de Google en el AVD del reloj durante el desarrollo, puedes sincronizar un teléfono con el AVD de reloj y vincular una.

  1. Sigue los pasos para configurar un teléfono.
  2. En el teléfono, habilita Opciones para desarrolladores y Depuración por USB.
  3. Conecta el teléfono a tu computadora a través de un puerto USB.
  4. Envía el puerto de comunicación del AVD al teléfono conectado (cada vez que se conecte el teléfono):
    adb -d forward tcp:5601 tcp:5601
  5. En el teléfono, desde la app de Wear OS, inicia el proceso de sincronización estándar. Por ejemplo, en la pantalla de bienvenida, presiona el botón Configurar. De manera alternativa, si ya se sincronizó un reloj existente, en el menú desplegable de la esquina superior izquierda, presiona Agregar un reloj nuevo.
  6. En el teléfono, desde la app de Wear OS, presiona el botón de contenido adicional y, luego, Sincronizar con emulador.
  7. Presiona el ícono de Configuración.
  8. En Configuración del dispositivo, presiona Emulador.
  9. Presiona Cuentas, selecciona una Cuenta de Google y sigue los pasos del asistente para sincronizar la cuenta con el emulador. Si es necesario, escribe la contraseña de bloqueo de pantalla del dispositivo y la contraseña de la Cuenta de Google para iniciar la sincronización de la cuenta.

Cómo conectar un teléfono a varios dispositivos para Wear

A fin de conectar un segundo dispositivo para Wear a un teléfono virtual o físico, sigue los mismos pasos que para la vinculación inicial: busca el teléfono o el dispositivo para Wear que quieras sincronizar en el Administrador de dispositivos, haz clic en el menú desplegable y, luego, en Pair Wearable.

Cómo agregar un módulo de Wear OS a tu proyecto

Puedes agregar un módulo para un dispositivo Wear OS a tu proyecto existente en Android Studio, lo que te permitirá volver a usar el código de tu app para dispositivos móviles (teléfono).

Cómo proporcionar un módulo de Wear OS en tu proyecto existente

Para crear un módulo de Wear OS, abre tu proyecto de Android Studio existente y haz lo siguiente:

  1. Haz clic en File > New > New Module.
  2. En la ventana New Module, selecciona Wear OS Module y haz clic en Next.
  3. En Configure the new module, ingresa lo siguiente:
    • Application/Library Name: Esta string corresponde al título de tu ícono de selector de apps para el nuevo módulo.
    • Module Name: Esta string corresponde al nombre de la carpeta para tu código fuente y tus archivos de recursos.
    • Package Name: Esta string corresponde al espacio de nombres de Java para el código en tu módulo. La string se agrega como el atributo package en el archivo de manifiesto de Android del módulo.
    • Minimum SDK: Selecciona la versión más antigua de la plataforma que admita el módulo de la app. Por ejemplo, selecciona API 26: Android 8.0 (Oreo). Este valor establece el atributo minSdkVersion en el archivo build.gradle, que podrás editar más adelante.
  4. Haz clic en Next. Verás varias opciones de plantillas de código. Haz clic en Blank Wear OS Activity y, luego, en Next.
  5. En la ventana Configure Activity, ingresa o acepta los valores predeterminados para Activity Name, Layout Name y Source Language. Haz clic en Finish.

Android Studio crea y sincroniza los archivos para el nuevo módulo. Además, agrega las dependencias obligatorias para Wear OS en el archivo de compilación del nuevo módulo. El nuevo módulo aparece en la ventana Project del lado izquierdo de la pantalla. Si no ves esta carpeta, asegúrate de que en la ventana se muestre la vista de Android.

Incluye lo siguiente en el archivo build.gradle para el nuevo módulo de Wear OS:

Cómo incluir bibliotecas

Nota: Te recomendamos que uses Android Studio a fin de desarrollar contenido para Wear OS, ya que proporciona funciones de configuración de proyectos, inclusión de bibliotecas y empaquetado.

Cuando usas el Asistente de proyectos de Android Studio, este importa las dependencias en el archivo build.gradle del módulo adecuado. Sin embargo, las dependencias no son obligatorias para todas las apps; por lo tanto, revisa la información que aparece debajo sobre las dependencias.

Para actualizar un proyecto de Wear OS existente a la versión más reciente del SDK, usa la configuración que se incluye en la sección Cómo iniciar un proyecto de Wear OS.

Notificaciones

Si quieres obtener información sobre las dependencias para notificaciones, consulta Cómo crear una notificación en Wear.

Cómo compilar IUs para Wear OS

Compose es nuestro enfoque recomendado para compilar interfaces de usuario de apps de Wear OS. Compose para Wear OS ofrece más de 20 componentes diseñados para el factor de forma de Wear OS, que es mucho más que la cantidad de componentes disponibles para diseños basados en vistas. Estos componentes se diseñaron para ayudarte a crear experiencias del usuario que cumplan con los lineamientos más recientes de Material Design para Wear OS. Sin embargo, si prefieres compilar con vistas, agrega una dependencia en la biblioteca de la IU de Wear OS. Para obtener más información, consulta Cómo compilar IU basadas en vistas en Wear OS.

APIs de Data Layer para wearables y de Servicios de Play

Si tu app depende de los Servicios de Google Play, ya sea para sincronizarse y enviar datos (mediante las APIs de Data Layer), o bien para otros fines, necesitarás la versión más reciente de los Servicios de Google Play. Si no usas estas APIs, debes quitar la dependencia.

Cómo ahorrar batería en el reloj

Un reloj pasa del modo interactivo al modo ambiente cuando está inactivo o cuando el usuario cubre la pantalla con la palma de la mano.

Para ahorrar batería en un reloj, evita usar el modo ambiente. Si el reloj pasa al modo ambiente del sistema mientras la app está activa y el usuario interactúa de nuevo con el reloj dentro de un período específico, se mostrará la app como el primer elemento que vea.

Es posible que quieras anular el modo ambiente en tu app para casos de uso específicos. Por ejemplo, si el usuario realiza un seguimiento de una carrera y necesita ver la hora en todo momento.

Las apps para reloj que pueden pasar al modo ambiente se denominan apps siempre activadas. A continuación, se describen los dos modos de operación de este tipo de apps:

Interactivo
Usa una animación fluida a todo color en este modo. Además, la app reacciona a las entradas.
Ambiente
Renderiza la pantalla con gráficos en blanco y negro, y no presentes indicaciones visuales en este modo. Solo se admite en dispositivos que ejecutan Android 5.1 o versiones posteriores.

Para obtener más información y las prácticas recomendadas, consulta la página Cómo mantener tu app visible en Wear OS.