Cómo crear y ejecutar una app para wearables

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 kit de desarrollo de software (SDK) de Android, pero difieren en diseño y funcionalidad.

Una app para Wear debería funcionar de manera independiente (sin una complementaria para teléfonos) para 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 el 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, sigue estos pasos:

Haz clic en File > New > New Project.
En la ventana Project Template, haz clic en la pestaña Wear OS, selecciona Empty Compose Activity y haz clic en Next.
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.
En el archivo build.gradle del módulo de la app, haz lo siguiente:
- 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.
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>
```
Sincroniza tu proyecto de Android Studio. Para ejecutar el código en el nuevo módulo, consulta los pasos de la sección a continuación.

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 en SDK Manager.

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

En Android Studio, selecciona Tools > AVD Manager para abrir el Administrador de dispositivos virtuales de Android.
Haz clic en Create Virtual Device.
En el panel Category, selecciona Wear OS y elige un perfil de hardware. Haz clic en Next.
Selecciona una imagen del sistema para descargar. Por ejemplo, selecciona la imagen con nivel de API 30 y el Target "Android 11.0 (Wear OS)". Haz clic en Next y, luego, en Finish.
Cierra el Administrador de dispositivos virtuales de Android.
En la barra de herramientas de Android Studio, ve al menú del dispositivo de destino, selecciona el AVD que acabas de crear y, luego, haz clic en Run .
Se iniciará el AVD y, unos segundos después, se ejecutará tu app. Aparecerá un mensaje de bienvenida.

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.

En el archivo settings.gradle de tu proyecto de Android Studio, incluye lo siguiente:

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

Advertencia: El repositorio de JCenter se convirtió en uno de 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 de adb en el reloj de la siguiente manera:

Abre el menú de Configuración del reloj.
Desplázate hasta la parte inferior del menú. Si no aparece el elemento Opciones para desarrolladores, presiona System y, luego, About.
Presiona el número de compilación siete veces.
En el menú Settings, presiona Developer options.
Habilita ADB debugging.

Para conectar el reloj, sigue estos pasos:

Conecta el reloj a tu computadora mediante USB para poder instalar apps directamente en él.
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.

Configura un teléfono

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

Nota: Te recomendamos que las apps para Wear OS sean independientes y funcionen sin necesidad del teléfono. Sin embargo, si tu app para Wear OS depende de una app para dispositivos móviles, consulta la siguiente información para 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 by Google para relojes inteligentes. Presiona Actualizar para descargar la app e instalarla. Una vez hecho esto, confirma que esté seleccionada la opción Actualización automática. Consulta la sección Cómo actualizar apps para Android individuales automáticamente de Cómo actualizar apps 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. Para ello, sigue los pasos que se indican a continuación:

Desde 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 en el reloj. Comprueba que los códigos coincidan.
Presiona Pair para avanzar con el proceso de vinculación. Cuando el reloj se conecte al teléfono, aparecerá un mensaje de confirmación. En el teléfono, aparecerá una pantalla en la que se indiquen las cuentas conectadas a él.
Selecciona una Cuenta de Google para agregarla tu reloj y sincronizarla.
Confirma el bloqueo de pantalla e ingresa la contraseña para iniciar el copiado de la cuenta del teléfono al reloj.
Sigue las instrucciones del asistente para finalizar el proceso de sincronización.

App complementaria para iPhones

Hay una aplicación complementaria de iOS disponible para los teléfonos con iOS 8.2 o versiones posteriores. Para instalarla, haz lo siguiente:

En tu iPhone, ve a App Store para descargar e instalar la app complementaria de Wear OS by Google.
Sigue las instrucciones que aparecen en el reloj y el teléfono para iniciar la vinculación. Para obtener más información, consulta la página de solución de problemas de configuración en el reloj.

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 los dispositivos que ya se habían cuando se inician.

Para vincular dos dispositivos, sigue estos pasos:

Si todavía no lo hiciste, crea un emulador de Wear.
En el Administrador de dispositivos, haz clic en el ícono del menú ampliado junto al dispositivo que quieras vincular y selecciona Pair Wearable.

Figura 1: Menú desplegable de un dispositivo que se puede vincular con un emulador de Wear
Se iniciará el asistente de vinculación del emulador de Wear OS. Si seleccionaste Pair Wearable en la entrada de 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.
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.
Para vincular dispositivos en la app de Wear OS en el teléfono, haz clic en el menú ampliado 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 vincular un teléfono con el AVD de reloj y sincronizarla. Para ello, haz lo siguiente:

Sigue los pasos para configurar un teléfono.
En el teléfono, habilita Opciones para desarrolladores y Depuración por USB.
Conecta el teléfono a tu computadora mediante un puerto USB.
Reenvía el puerto de comunicación de AVD al teléfono conectado cada vez que se conecte mediante este comando:
adb -d forward tcp:5601 tcp:5601
En la app complementaria para Wear OS del teléfono, inicia el proceso de vinculación estándar. Por ejemplo, en la pantalla de bienvenida, presiona el botón Set it up. Como alternativa, si ya hay un reloj vinculado, presiona Add a New Watch en el menú de la parte superior izquierda.
En la app complementaria de Wear OS del teléfono, presiona el menú ampliado y, luego, Pair with Emulator.
Presiona el ícono Settings.
En Device Settings, presiona Emulator.
Presiona Cuentas y selecciona una Cuenta de Google. 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

Si deseas 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 vincular en el Administrador de dispositivos, haz clic en el menú ampliado 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 que te permita reutilizar el código de tu app para dispositivos móviles.

Cómo crear 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:

Haz clic en File > New > New Module.
En la ventana New Module, selecciona Wear OS Module y haz clic en Next.
En Configure the new module, ingresa lo siguiente:
- Application/Library Name: El título del ícono de selector de apps para el nuevo módulo
- Module Name: El nombre de la carpeta con el código de fuente y los archivos de recursos
- Package Name: el espacio de nombres de Java para el código de tu módulo. La string se agrega como el atributo package en el archivo de manifiesto de Android del módulo.
- Minimum SDK: La versión más antigua de la plataforma que admita el módulo de la app. Por ejemplo, selecciona nivel de API 26: Android 8.0. Este valor establece el atributo minSdkVersion en el archivo build.gradle, que podrás editar más adelante.
Haz clic en Next. Verás varias opciones de plantillas de código. Selecciona Blank Wear OS Activity y, luego, haz clic en Next.
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 la carpeta donde se encuentra, 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:

En la sección android, configura los valores de compileSdkVersion en 33 y de targetSdkVersion en 30.
Agrega las dependencias que necesitas. Para obtener más información, consulta Cómo declarar dependencias.
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 incluir bibliotecas

Nota: Usa Android Studio en el desarrollo de Wear OS, ya que ofrece 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. Consulta la siguiente información 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 una IU para Wear OS

Compose es nuestro enfoque recomendado de compilación de interfaces de usuario de apps para Wear OS. Compose para Wear OS ofrece más de 20 componentes diseñados para adaptarse al factor de forma de Wear OS, 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 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, lo primero que vea será la app.

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

Las apps para reloj que pueden pasar al modo ambiente se denominan apps siempre encendidas. 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 Cómo mantener tu app visible en Wear OS.