Emoji2

Muestra emojis en dispositivos modernos y antiguos.
Actualización más reciente Versión estable actual Próxima versión potencial Versión beta Versión alfa
30 de junio de 2021 - - - 1.0.0-alpha03

Cómo declarar dependencias

Para agregar una dependencia en Emoji2, debes agregar el repositorio Maven de Google a tu proyecto. Lee 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:

Groovy

dependencies {
    def emoji2_version = "1.0.0-alpha03"

    implementation "androidx.emoji2:emoji2:$emoji2_version"
    implementation "androidx.emoji2:emoji2-views:$emoji2_version"
    implementation "androidx.emoji2:emoji2-views-helper:$emoji2_version"
}

Kotlin

dependencies {
    val emoji2_version = "1.0.0-alpha03"

    implementation("androidx.emoji2:emoji2:$emoji2_version")
    implementation("androidx.emoji2:emoji2-views:$emoji2_version")
    implementation("androidx.emoji2:emoji2-views-helper:$emoji2_version")
}

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.

1.0.0

Versión 1.0.0-alpha03

30 de junio de 2021

Lanzamiento de androidx.emoji2:emoji2-*:1.0.0-alpha03. La versión 1.0.0-alpha03 contiene estas confirmaciones.

Nuevas funciones

Esta es una versión de corrección de errores y estabilización.

  1. Ahora, EmojiEditTextHelper permite que se pase null como KeyListener. De esta manera, se habilita el comportamiento de la plataforma que permite que los valores nulos se apliquen al emoji compatible con las implementaciones de EditText.
  2. Cuando se usa EmojiCompatInitializer, se mejora el retraso del primer inicio para que se active después de que se reanuda la primera actividad. De esta manera, se permite que el inicio de una app se realice sin problemas, y se evita cargar la fuente para los inicios de la app que nunca muestran una IU. Después de un retraso breve, EmojiCompat creará un subproceso para cargar la fuente del emoji.
  • Se agregó una dependencia nueva en androidx.lifecycle:lifecycle-process desde androidx.emoji2:emoji2 para implementar el retraso, lo que tendrá un impacto insignificante en el tamaño del APK para las apps que ya incluyen un ciclo de vida (como las que tienen appcompat).

Cambios en la API

  • Se permite KeyListener nulo en AppCompatEditText. Esto revierte la anotación no nula que se agregó a AppCompatEditText en la versión 1.4.0-alpha01 y restablece el comportamiento anterior cuando se pasa un valor nulo. (I21482, b/189559345)

Correcciones de errores

  • Se cambió EmojiCompatInitializer para retrasar la carga de la fuente hasta 500 ms después del primer elemento Activity.onResume. De esta manera, una actividad puede realizar Application.onCreate y Activity.onCreate sin problemas, al mismo tiempo que garantiza que la fuente del emoji se cargue poco después del inicio de la app. (I4bff7)

Versión 1.0.0-alpha02

2 de junio de 2021

Lanzamiento de androidx.emoji2:emoji2:1.0.0-alpha02, androidx.emoji2:emoji2-views:1.0.0-alpha02 y androidx.emoji2:emoji2-views-helper:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Cambios en la API

  • Se cambió el nombre del paquete en emoji2-views-helper por androidx.emoji2.viewsintegration. Este es un cambio rotundo para AppCompat 1.4.0-alpha01, y las apps deberán asegurarse de que la dependencia de AppCompat se actualice a fin de usar la versión nueva de emoji2. (Ie8397)

Versión 1.0.0-alpha01

18 de mayo de 2021

Lanzamiento de androidx.emoji2:emoji2:1.0.0-alpha01, androidx.emoji2:emoji2-views:1.0.0-alpha01 y androidx.emoji2:emoji2-views-helper:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Funciones de esta versión inicial

Se recomienda la integración de Emojicompat en todas las apps para admitir emojis modernos de API19. Todo el contenido de tu app generado por el usuario contiene 🎉.

EmojiCompat pasó de los artefactos androidx.emoji a los nuevos androidx.emoji2, ahora en alpha01. Los artefactos nuevos reemplazan a la versión anterior.

Se agrega emoji2 como dependencia a AppCompat a partir de AppCompat 1.4.0-alpha01 y está habilitada de forma predeterminada para las vistas de AppCompat.

El artefacto emoji2 incorpora una nueva configuración automática a través de la biblioteca androidx.startup. Ya no tienes que escribir ningún código 👨🏽‍💻 para que se muestre 🐻‍❄️.

Cambios en emojis2 en comparación con emojis

  • Se agregó la nueva configuración automática EmojiCompatInitializer a través de androidx.startup.
  • Se agregó una nueva configuración predeterminada que usa la ubicación del servicio para encontrar un proveedor de fuentes descargables en DefaultEmojiCompatConfiguration.
  • Las clases pasaron del paquete androidx.emoji a androidx.emoji2.
  • Se dividió EmojiTextView y vistas relacionadas en un artefacto emoji2-views independiente. Solo se debe usar si tu app no utiliza appcompat.
  • Se extrajeron asistentes para integrar Emojicompat en vistas personalizadas en un artefacto emoji2-views-helper independiente.
  • Se agregaron anotaciones de nulabilidad.
  • Ahora, se pueden usar los ayudantes en emoji2-views-helper aunque no se inicialice EmojiCompat (antes arrojaban una excepción).

¿Qué dependencia deberías agregar?

  • Las apps con AppCompat deberían actualizarse a la versión Appcompat 1.4.0-alpha01 o versiones posteriores.
  • Las apps sin AppCompat que usan TextView y EditText desde la plataforma deben usar EmojiTextView y las clases relacionadas de emoji2-views.

Cómo brindar asistencia en vistas personalizadas

  • Las apps con AppCompat deberían extender AppCompatTextView, AppCompatButton, etc. en lugar de TextView, y así sucesivamente.
  • Las apps sin AppCompat deben agregar la dependencia a androidx.emoji2:emoji2-views-helper y usar asistentes para integrarla con subclases TextView o EditText personalizadas.

Cómo configurar la inicialización automática

  • Las apps pueden inhabilitar la inicialización automática si se agrega al manifiesto:

     <provider
         android:name="androidx.startup.InitializationProvider"
         android:authorities="${applicationId}.androidx-startup"
         android:exported="false"
         tools:node="merge">
         <meta-data android:name="androidx.emoji2.text.EmojiCompatInitializer"
                   tools:node="remove" />
     </provider>
    
  • Se inhabilita la configuración automática y, luego, puedes pasar una configuración personalizada a EmojiCompat.init. La configuración predeterminada del sistema se puede recuperar de DefaultEmojiCompatConfig.create(context) para realizar más configuraciones antes de pasar a EmojiCompat.init.