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 Blank Activity y, luego, 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 28.
    • En la sección android, confirma que la targetSdkVersion esté establecida en 28.
    • 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 la opción Release Name Pie, API Level 28 y Target "Android 9.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 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.

Nota: También puedes usar el asistente de sincronización del emulador de Wear OS para vincular un teléfono físico o virtual con un AVD de reloj. El teléfono debe ejecutar Android 11 o una versión posterior y tener Google Play Store instalado. Además, esta herramienta solo está disponible en Android Studio Arctic Fox (2021.3.1) beta y versiones posteriores. Consulta Cómo usar el asistente de sincronización del emulador de Wear OS.

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.

Configura un teléfono

En esta sección, se incluye información sobre cómo 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 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.

Biblioteca de la IU de Wear OS

Se recomiendan los componentes en la biblioteca de la IU de Wear OS porque ejemplifican las prácticas recomendadas de apps para reloj. Por lo tanto, te recomendamos que agregues una dependencia en la biblioteca de la IU de Wear OS. Para obtener más información, consulta las siguientes páginas:

Otras bibliotecas de Jetpack

Wear OS migró de la biblioteca de compatibilidad a Jetpack. Puedes encontrar una lista completa de todas las clases nuevas en nuestras notas de la versión. Estas son algunas de las características destacadas:

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.

Diferencias entre apps para teléfono y reloj

A continuación, se muestran algunas de las diferencias entre las apps para teléfono y reloj:

  • Las apps para reloj usan APIs específicas de relojes, según corresponda (p. ej., para diseños circulares, paneles laterales de wearables, modo ambiente, etc.).
  • Las apps para reloj tienen un modelo de UX diferente.
  • Las apps para reloj contienen una funcionalidad apropiada para un reloj.
  • Las apps para reloj pueden acceder a varias APIs de Android estándares, pero no admiten lo siguiente:

    Antes de usar una API, puedes llamar a hasSystemFeature() para verificar si un reloj admite una función.

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.

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

Nota: Tu teléfono debe ejecutar Android 11 o una versión posterior y tener instalada Google Play Store para que puedas usar el asistente de vinculación del emulador de Wear OS.

  1. En el menú desplegable de dispositivos en Android Studio, haz clic en Wear OS emulator pairing assistant.
  2. Selecciona un teléfono y un AVD de Wear para vincularlos. Si no hay ninguno disponible, haz clic en View AVD Manager para configurar un teléfono o un AVD de reloj. Luego, haz clic en Next.

    Android Studio intenta iniciar y configurar un puente entre los dos dispositivos. Si no tienes instalada la app de Wear OS en el teléfono, se te pedirá que descargues la app complementaria desde Play Store.

  3. Si se te solicita, abre la app complementaria una vez que se descargue.
  4. 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. Como alternativa, si ya se sincronizó un reloj existente, en el menú desplegable de la parte superior izquierda, presiona Agregar un reloj nuevo.
  5. En el teléfono, desde la app de Wear OS, presiona el botón de contenido adicional y, luego, Sincronizar con emulador.