Cómo crear y ejecutar una app en Wear OS

En esta página, se proporciona una guía que te permitirá crear tu primera app para Wear OS usando una plantilla de Android Studio. En la app, se muestran las diferentes maneras de ver información de un vistazo en dispositivos Wear OS y se presentan algunas prácticas recomendadas para desarrollar apps en la plataforma.

Esta guía se basa en conocimientos previos sobre la plataforma de Android y el IDE de Android Studio. Si es la primera vez que usas Android, crea una app con este codelab. Para obtener más información sobre las capacidades de Android Studio, visita la página de Introducción a Android Studio.

Cómo crear una app para Wear OS

Después de descargar e instalar la versión más reciente de Android Studio, completa el asistente de "new project":

  1. Abre Android Studio y ve a File > New > New Project. Aparecerá la ventana New Project.
  2. En el panel Templates, selecciona Wear OS. Luego, en el panel principal, selecciona Empty Wear App.
  3. Ponle un nombre al proyecto y haz clic en Finish. Android Studio descargará las dependencias necesarias y compilará la versión inicial de tu proyecto.

  4. Ve a Tools > SDK Manager y, luego, instala los siguientes paquetes:

    • Android 14.0 ("UpsideDownCake) (nivel de API 34), que incluye la imagen del sistema ARM 64 v8a de Wear OS 5 y la imagen del sistema Intel x86 Atom_64 de Wear OS 5
    • Android 13.0 ("Tiramisu") (nivel de API 33), que incluye la imagen del sistema v8a ARM 64 de Wear OS 4 y la imagen del sistema Atom_64 Intel x86 de Wear OS 4

    Para cerrar SDK Manager, haz clic en OK.

Ya está todo listo para que ejecutes tu primera app en Wear OS.

Cómo ejecutar una app en el emulador

La manera más sencilla de ejecutar tu primera app para Wear OS es configurar un emulador.

Cómo configurar un emulador

Para configurar un emulador en Android Studio, completa los siguientes pasos:

  1. En SDK Manager, abre la pestaña SDK Tools. Confirma que tienes la versión más reciente de las Herramientas de la plataforma del SDK de Android.
  2. Ve a Tools > Device Manager.
  3. Selecciona Create (+). Aparecerá el asistente Virtual Device Configuration.
  4. En el panel Category, selecciona Wear OS y un perfil de hardware, como Wear OS Small Round. Haz clic en Next.

  5. Para las imágenes del sistema que se usan fuera de China, selecciona el nombre de versión UpsideDownCake. Esta versión está orientada a Android 14.0 (Wear OS 5). Para las imágenes del sistema que se usan en China, selecciona el nombre de versión R. Esta versión se orienta a Android 11.0 (Wear OS 3). Si aún no tienes instalada una imagen del sistema de Wear OS 5 que coincida con la definición de tu dispositivo, haz clic en Descargar junto a Nombre de la versión para obtenerla. Haz clic en Siguiente.

    Nota: Las imágenes del sistema para el emulador de Wear OS incluyen avisos de archivos y código fuente externos. Puedes ver avisos de terceros para una imagen del sistema en particular si abres el archivo NOTICE.txt, que se encuentra en uno de los siguientes directorios:

    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI para emuladores que se usan fuera de China.
    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI para los emuladores que se usan en China.

  6. Puedes mantener el valor predeterminado para todos los parámetros de configuración en esta pantalla, a menos que quieras personalizar el emulador. Haz clic en Finish.

Si quieres obtener más información para usar emuladores, consulta la guía para ejecutar apps en Android Emulator.

Abre la app en el emulador

  1. Ve a Run > Select Device. Elige el emulador que acabas de crear.
  2. En la barra de herramientas de Android Studio, haz clic en Run . El emulador se inicia y abre tu app.
  3. Después de unos momentos, deberías ver el mensaje "Hello…" en el emulador.

Prueba el audio Bluetooth con el emulador

En las imágenes del sistema que ejecutan Wear OS 4 o versiones posteriores, el emulador admite Bluetooth emulado, lo que te permite probar audio Bluetooth en varios casos de uso.

Las imágenes del sistema recientes solo admiten arquitecturas de 64 bits

Las imágenes del sistema del emulador para Wear OS 4 y versiones posteriores solo admiten estas arquitecturas de 64 bits: x86-64 y arm64-v8a. Si sabes o sospechas que la app usa código nativo (que no está escrito en los lenguajes de programación Kotlin o Java), comprueba que incluya bibliotecas nativas de 32 y 64 bits.

Descubre cómo admitir arquitecturas de 64 bits.

Cómo ejecutar una app en un reloj físico (opcional)

Ejecutar y depurar tu app en un reloj real te permite evaluar mejor la experiencia del usuario completa. Esto es muy importante si tu app se basa en hardware específico, como sensores o una GPU.

Para ejecutar una app en un reloj físico, prepara el dispositivo para la prueba y, luego, conéctalo a tu máquina de desarrollo.

Prepara el reloj para la prueba

Para preparar tu reloj para la prueba, habilita la depuración ADB completando los siguientes pasos.

  1. En el reloj, abre el menú de Configuración.
  2. Ve a la parte inferior del menú. Si no aparece el elemento Opciones para desarrolladores, completa los subpasos que siguen aquí. De lo contrario, continúa con el paso próximo.
    1. Presiona Sistema > Acerca de o Sistema > Acerca de > Versiones.
    2. Busca el elemento Número de compilación y presiónalo siete veces. Si el reloj está protegido con un PIN o un patrón, ingrésalo cuando se te solicite.
  3. En el menú Configuración, presiona Opciones para desarrolladores.
  4. Habilita la opción Depuración ADB.

Conecta el reloj a la máquina de desarrollo

Algunos relojes te permiten conectarte por USB. Otros requieren una conexión inalámbrica.

Cómo configurar una conexión por cable a través de USB

Para conectar el reloj, sigue estos pasos:

  1. Con un cable USB, conecta el reloj a la máquina de desarrollo.
  2. En el reloj, habilita Permitir siempre en esta computadora y, luego, presiona Aceptar.

Cómo configurar una conexión inalámbrica

Si tu reloj no tiene un puerto USB, obtén información para conectar un reloj con Wi-Fi o Bluetooth.

Cómo instalar una versión específica de Wear OS (opcional)

Si el caso de prueba de tu app depende de una versión específica de Wear OS, puedes escribir una imagen de software en la memoria flash de relojes compatibles con una conexión de datos USB (con cable). Por ejemplo, puedes escribir en la memoria flash una imagen de fábrica o una imagen OTA completa en un dispositivo Google Pixel Watch 3 o Google Pixel Watch 2.

Abre la app en el reloj

  1. Ve a Run > Select Device. Elige el reloj que está conectado a tu máquina.
  2. En la barra de herramientas de Android Studio, haz clic en Run . El emulador se inicia y abre tu app.
  3. Después de unos momentos, deberías ver el mensaje "Hello…" en el reloj.