Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Wear

Crea aplicaciones para relojes inteligentes de Wear OS by Google.

En esta tabla, se enumeran todos los artefactos del grupo androidx.wear.

Artefacto Versión estable actual Próxima versión potencial Versión beta Versión Alfa
wear 1.1.0 - - 1.2.0-alpha02
wear-input - 1.0.0-rc01 - -
wear-complications-data - - - 1.0.0-alpha02
wear-complications-provider - - - 1.0.0-alpha02
wear-watchface - - - 1.0.0-alpha02
wear-watchface-complications-rendering - - - 1.0.0-alpha02
wear-watchface-data - - - 1.0.0-alpha02
wear-watchface-style - - - 1.0.0-alpha02
Esta biblioteca se actualizó por última vez el 11 de noviembre de 2020

Cómo declarar dependencias

Para agregar una dependencia en Wear, debes agregar el repositorio Maven de Google a tu proyecto. Consulta el repositorio Maven de Google para obtener más información.

Agrega las dependencias de los artefactos que necesites en el archivo build.gradle de tu app o módulo:

dependencies {
    implementation "androidx.wear:wear:1.1.0"

    // Add support for wearable specific inputs
    implementation "androidx.wear:wear-input:1.0.0-rc01"
    implementation "androidx.wear:wear-input-testing:1.0.0-rc01"

    // Use to implement wear watchface complications
    implementation "androidx.wear:wear-complications-provider:1.0.0-alpha02"

    // Use to implement wear watchfaces
    implementation "androidx.wear:wear-watchface:1.0.0-alpha02"
}

Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.

Comentarios

Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes en esta biblioteca antes de crear uno nuevo. Para agregar tu voto a un error existente, haz clic en el botón de la estrella.

Cómo crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

Wear Complications y Watchface 1.0.0

Versión 1.0.0-alpha02

11 de noviembre de 2020

Lanzamiento de androidx.wear:wear-*:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Cambios en la API

  • ComplicationDetails ahora se llama ComplicationState y está correctamente encapsulado, y se migró el uso de la asistencia de wearable @ComplicationData.ComplicationType a ComplicationType de androidx. (I4dd36)
  • Se agregó un parámetro highlightedComplicationId opcional a RenderParameters que permite solicitar el resaltado de una sola complicación en capturas de pantalla. (I66ce9)
  • Ahora ComplicationProviderService usará la nueva API de estilo de complicación para mantener la coherencia. (Id5aea)
  • Ahora getPreviewReferenceTimeMillis obtiene los tiempos de referencia de DeviceConfig. (I779fe)
  • A los efectos de simplificar la plataforma de la API de Renderer, ahora se puede usar SurfaceHolder.Callback para observar cambios. (I210db)
  • CanvasComplicationRenderer no deriva de Renderer. Se cambió el nombre para proporcionar mayor claridad. (Ibe880)

Correcciones de errores

  • Primera versión de androidx.wear:wear-watchface-client (I1e35e)
  • Se cambió el nombre de GlesTextureComplication#renderer para proporcionar mayor claridad (Ib78f7)
  • Se cambió el nombre de StyleCategory a StyleSetting para proporcionar mayor claridad (I488c7)
  • Se agregó UserStyleSchema para lograr una API más limpia (If36f8)

Versión 1.0.0-alpha01

28 de octubre de 2020

Lanzamiento de androidx.wear:wear-complications-*:1.0.0-alpha01 y androidx.wear:wear-watchface-*:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • Se quitaron algunos elementos que no se pretendían dar a conocer en la API pública. (I41669)
  • Se creó la biblioteca androidx.wear:wear-complications-provider. (I77f1f)
  • ComplicationsUserStyleCategory ahora es la nueva categoría recomendada para configurar complicaciones. (I96909)
  • Se agregó la API wear-complication-data. (I7c268)
  • Las funciones con valores booleanos que se muestran deberán llevar el prefijo "is" en lugar de "get". (If36ff)
  • Los consejos de API deberán evitar el uso de Protected, por lo que se refactorizó esta clase para que tome parámetros a través del constructor. (I61644)
  • Se cambió el nombre de setBackgroundComplication para brindar mayor claridad. (I96fe3)
  • Se usaron las propiedades de Kotlin para ComplicationDrawable isHighlighted y datos. (I4dcc8)
  • En lugar de ComplicationRenderer.InvalidateCallback, se agregó Complication#invalidate(). (I4f4c6)
  • Estas API dejarán de estar disponibles en WearableSupport y se quitaron de aquí. (Ib425c)
  • Se cambiaron los nombres de algunos métodos del compilador WatchFace para enfatizar su naturaleza heredada de Wear 2.0. (Idb775)
  • Se incluye el primer candidato de API en versión beta para wear/wear-watchface. (Id3981)
  • Se incluye la primera versión rastreada de la API. (Ie9fe6)
  • Se ocultó correctamente ComplicationDrawable.BorderStyle IntDef y se movió a ComplicationStyle para lograr coherencia. (I27f7a)
  • Se agregaron las anotaciones faltantes de los métodos ComplicationStyle. (I838fd)
  • Esta biblioteca no tiene una plataforma de API pública. (I88e2b)
  • Todas las clases Style Category de Option ahora son definitivas. (Ib8323)
  • Se incluye la primera versión rastreada de la API. (I27c85)

Correcciones de errores

  • Se cambió ComplicationProviderService para tener un método getComplicationPreviewData explícito. (I4905f)
  • Se habilitó la comprobación de lint de API para MissingGetterMatchingBuilder en androidx. (I4bbea, b/138602561)
  • Se cambió el nombre de wear-complications-rendering. (Ifea02)
  • Los nombres visibles de Style Category ahora son CharSequences. (I28990)
  • Se reemplazó Override con Overlay para que coincida con las convenciones de nombres actuales de temas y estilos. (I4fde9)
  • Se cambió el nombre de UserStyle#getOptions para brindar mayor claridad. (I695b6)

Versión 1.2.0

Versión 1.2.0-alpha02

11 de noviembre de 2020

Lanzamiento de androidx.wear:wear:1.2.0-alpha02. La versión 1.2.0-alpha02 contiene estas confirmaciones.

Esta versión agrega una nueva "API de actividades en curso" por primera vez. Los desarrolladores pueden usar esta API para indicar que una actividad de larga duración, como un entrenamiento físico o una sesión de reproducción de contenido multimedia, está en curso. Permite a los desarrolladores proporcionar actualizaciones de estado periódicas, como "distancia recorrida y tiempo transcurrido" o "pista que se está reproduciendo actualmente", para verlas en la cara del reloj o en el selector de aplicaciones. Esta funcionalidad está orientada a dispositivos futuros con la funcionalidad de actividad en curso habilitada.

Cambios en la API

  • Nueva API para actividades en curso. Es una no-op en "dispositivos no compatibles". (I69a31)

Versión 1.2.0-alpha01

28 de octubre de 2020

Lanzamiento de androidx.wear:wear:1.2.0-alpha01. La versión 1.2.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • Se agregó el componente WearCurvedTextView para escribir texto curvo con facilidad siguiendo la curvatura del círculo más grande que se pueda grabar en la vista. Un ejemplo de uso:
<androidx.wear.widget.WearCurvedTextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="example curved text"
        app:anchorAngleDegrees="180"
        app:anchorPosition="center"
        app:clockwise="false"
        style="@android:style/TextAppearance.Large"
/>

Un ejemplo de texto curvo en Android Wear

  • Se agregó el contenedor WearArcLayout para distribuir los elementos secundarios uno por uno en un arco, ya sea en sentido horario o antihorario. Sus elementos secundarios pueden ser widgets estándar de Android o widgets "curvos" que implementan su interfaz de ArcLayoutWidget. Un ejemplo de uso:
<androidx.wear.widget.WearArcLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:anchorPosition="center">
      <ImageView
              android:layout_width="20dp"
              android:layout_height="20dp"
              android:src="@drawable/ic_launcher"
      />
      <androidx.wear.widget.WearCurvedTextView
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:text="Curved Text"
              style="@android:style/TextAppearance.Small"
              android:padding="2dp"
       />
  </androidx.wear.widget.WearArcLayout>

Un ejemplo de texto en forma de arco en Android Wear

(I536da)

Wear-Input 1.0.0

Versión 1.0.0-rc01

11 de noviembre de 2020

Lanzamiento de androidx.wear:wear-input:1.0.0-rc01 y androidx.wear:wear-input-testing:1.0.0-rc01. La versión 1.0.0-rc01 contiene estas confirmaciones.

Esta versión es idéntica a la versión 1.0.0-beta01.

Versión 1.0.0-beta01

28 de octubre de 2020

Lanzamiento de androidx.wear:wear-input:1.0.0-beta01 y androidx.wear:wear-input-testing:1.0.0-beta01 sin cambios desde 1.1.0-alpha01. La versión 1.0.0-beta01 contiene estas confirmaciones.

Wear-Input-Testing versión 1.0.0-alpha01

14 de octubre de 2020

Lanzamiento de androidx.wear:wear-input-testing:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • Se agregó androidx.wear.input.test.TestWearableButtonsProvider, que implementa androidx.wear.input.WearableButtonsProvider para ayudar a probar las aplicaciones desarrolladas con la biblioteca de androidx.wear:wear-input. (I0ed0c)

Wear-Input versión 1.0.0-alpha01

2 de septiembre de 2020

Lanzamiento de androidx.wear:wear-input:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

Se migró la funcionalidad de WearableButtons de una biblioteca de compatibilidad con dispositivos wearables a Jetpack. Se ampliará la compatibilidad con pruebas en la biblioteca de androidx.wear:wear-input-testing en la próxima versión de Jetpack.

Versión 1.1.0

Versión 1.1.0

14 de octubre de 2020

Lanzamiento de androidx.wear:wear:1.1.0. La versión 1.1.0 contiene estas confirmaciones.

Cambios importantes desde la versión 1.0.0

  • Se agregó un prefijo layout_ al atributo boxedEdges (ahora layout_BoxedEdges) para BoxInsetLayout a fin de cumplir con la convención de nombres de Android. Esto quitará el error de linter en estos atributos de Android Studio. (I4272f)
  • Se agregó EXTRA_ANIMATION_DURATION_MILLIS opcional a ConfirmationActivity para permitir la duración en la que se muestra el cuadro de diálogo de confirmación. (adb83ce, b/143356547)
  • Se actualizó WearableActionDrawView para retrasar el aumento del panel lateral de acciones hasta que se abra por primera vez. (I01026, b/163870541)

Versión 1.1.0-rc03

2 de septiembre de 2020

Lanzamiento de androidx.wear:wear:1.1.0-rc03. La versión 1.1.0-rc03 contiene estas confirmaciones.

Correcciones de errores

  • Se solucionó el problema por el cual el panel lateral de acciones no mostraba contenido cuando se abría. (I01026, b/163870541)

Versión 1.1.0-rc02

24 de junio de 2020

Lanzamiento de androidx.wear:wear:1.1.0-rc02. La versión 1.1.0-rc02 contiene estas confirmaciones.

Correcciones de errores

  • Se agregó un prefijo layout_ al atributo boxedEdges (ahora layout_boxedEdges) para BoxInsetLayout a fin de cumplir con la convención de nombres de Android. Esto quitará el error de linter en estos atributos de Android Studio.

Versión 1.1.0-rc01

14 de mayo de 2020

Lanzamiento de androidx.wear:wear:1.1.0-rc01 sin cambios desde la versión .1.0-beta01. La versión 1.1.0-rc01 contiene estas confirmaciones.

Versión 1.1.0-beta01

29 de abril de 2020

Lanzamiento de androidx.wear:wear:1.1.0-beta01 sin cambios desde androidx.wear:wear:1.1.0-alpha01. La versión 1.3.0-beta01 contiene estas confirmaciones.

Versión 1.1.0-alpha01

15 de abril de 2020

Lanzamiento de androidx.wear:wear:1.1.0-alpha01. La versión 1.1.0-alpha01 contiene estas confirmaciones.

Cambios en la API

  • Se agregó EXTRA_ANIMATION_DURATION_MILLIS opcional a ConfirmationActivity para permitir la duración en la que se muestra el cuadro de diálogo de confirmación. (adb83ce, 134523c, b/143356547)

Correcciones de errores

  • Se actualizó WearableActionDrawView para retrasar el aumento del panel lateral de acciones hasta que se abra por primera vez. (5cd32f7)