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 Herramientas > SDK Manager y, luego, instala los siguientes paquetes:

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

    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 UpsideDownCake. nombre del lanzamiento. 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 Wear OS 5 instalada una imagen del sistema que coincida con la definición de tu dispositivo, haz clic en Descarga la versión junto al 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 estos archivos arquitecturas: 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.

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.

Participa en programas de versiones beta de dispositivos

En regiones seleccionadas, puedes registrarte para el Samsung Galaxy One UI Watch Beta. . Este programa te permite descargar Wear OS 5 en un Samsung Galaxy apto. Mira el dispositivo y prueba el comportamiento de tu app.

Para registrarte, sigue estos pasos:

  1. Descarga la app de Samsung Members, que está disponible en la Google Play Store
  2. Accede con tu cuenta de Samsung.
  3. En el banner principal o en la página de avisos, desplázate y selecciona Tarjeta de registro en el Programa de versión beta de One UI Watch.
  4. En la página que aparece, lee las instrucciones y luego selecciona la opción "join" (unir). botón que aparece. Por ejemplo, en un dispositivo Samsung Galaxy Watch6, selecciona Watch 6 Join.