Mostrar emoji

Unicode actualiza anualmente el conjunto de emojis estándar, ya que se incrementó rápidamente su uso en todo tipo de apps.

Si tu app muestra contenido de Internet o proporciona entrada de texto, te recomendamos encarecidamente que admitas las fuentes de emojis más recientes. De lo contrario, los emojis nuevos podrían mostrarse como un cuadrado pequeño llamado tofu (☐) o como otras secuencias de emojis renderizadas de manera incorrecta.

Las versiones de Android 11 (nivel de API 30) y anteriores no pueden actualizar la fuente de emojis, por lo que las apps que los muestran en ellas deben actualizarse de forma manual.

Estos son algunos ejemplos de emojis modernos.

La BOM de marzo de 2023 (Compose UI 1.4) admite la versión más reciente de emojis, incluida la retrocompatibilidad con versiones anteriores de Android hasta la API 21.

Esta compatibilidad no requiere cambios en tu app. Si usas Text y TextField (Material 2 o Material 3) o BasicText y BasicTextField, obtendrás compatibilidad con emojis modernos de inmediato.

La mejor manera de probar los emojis más recientes en tu app es usar un dispositivo real en la API 30 o versiones anteriores.

Si usas una solución de emojis personalizada o necesitas inhabilitar la resolución de emojis predeterminada en Compose por cualquier otro motivo, puedes usar PlatformTextStyle(emojiSupportMatch):

Text(
    text = "Hello $EMOJI_TEXT",
    style = TextStyle(
        platformStyle = PlatformTextStyle(
            emojiSupportMatch = EmojiSupportMatch.None
        )/* ... */
    )
)
EmojiSnippets.kt

Interoperabilidad

Si tu app usa Views y Compose en la misma Activity, asegúrate de usar las APIs adecuadas para configurar los emojis correctamente. En las siguientes secciones, se describe cuándo usar cada API.

Extensión de ComponentActivity

Si tu Activity se extiende desde Compose ComponentActivity en lugar de AppCompatActivity, sigue las instrucciones para admitir emojis sin AppCompat.

Como no extiendes AppCompatActivity, agrega la biblioteca Emoji2 a tus dependencias y usa EmojiTextView en tus vistas en lugar del widget TextView, como se muestra en el siguiente fragmento:

class MainActivity : ComponentActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val emojiTextView: EmojiTextView = findViewById(R.id.emoji_text_view)
        emojiTextView.text = getString(R.string.emoji_text_view, EMOJI_TEXT)

        val composeView: ComposeView = findViewById(R.id.compose_view)

        composeView.apply {
            setContent {
                // compose code
            }
        }
    }
}
EmojiSnippets.kt

Luego, en tu archivo XML:

<androidx.emoji2.widget.EmojiTextView
    android:id="@+id/emoji_text_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    />
example_view.xml

Extensión de AppCompatActivity

Si tu Activity se extiende desde AppCompatActivity, puedes usar ComposeView para llamar a funciones que admiten composición. Los emojis se renderizan correctamente en todas las versiones de Android cuando usas elementos que admiten composición de texto.

Si extiendes desde AppCompatActivity, aumenta TextView desde XML para que los emojis se rendericen correctamente.

Esto se aplica si aumentas el XML:

• fuera de ComposeView, en la Activity. Observa el uso de AppCompatActivity y TextView en el siguiente fragmento:

class MyActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val emojiTextView: TextView = findViewById(R.id.emoji_text_view)
        emojiTextView.text = getString(R.string.emoji_text_view, EMOJI_TEXT)

        val composeView: ComposeView = findViewById(R.id.compose_view)

        composeView.apply {
            setContent {
                // compose code
            }
        }
    }
}
EmojiSnippets.kt

• dentro de ComposeView, a través de la vinculación de vistas con AndroidViewBinding, como en el siguiente fragmento:

class MyActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        setContentView(
            ComposeView(this).apply {
                setContent {
                    Column {
                        Text(EMOJI_TEXT)

                        AndroidViewBinding(ExampleViewBinding::inflate) {
                            emojiTextView.text = EMOJI_TEXT
                        }
                    }
                }
            }
        )
    }
}
EmojiSnippets.kt

Para aumentar un texto con AndroidView dentro de ComposeView, usa AppCompatTextView para renderizar los emojis correctamente:

class MyActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        setContentView(
            ComposeView(this).apply {
                setContent {
                    Column {
                        Text(EMOJI_TEXT)

                        AndroidView(
                            factory = { context -> AppCompatTextView(context) },
                            update = { it.text = EMOJI_TEXT }
                        )
                    }
                }
            }
        )
    }
}
EmojiSnippets.kt

Consulta la documentación de las APIs de interoperabilidad para obtener más detalles.

Solución de problemas

Si ves tofu (☐) en lugar del emoji, primero verifica si el problema es tu dispositivo de prueba específico. Hay algunas cosas principales que puedes verificar:

• Es posible que uses un dispositivo actualizado recientemente o un emulador nuevo. Si es posible, prueba con otro dispositivo de prueba real que uses con frecuencia y que haya accedido a tu Cuenta de Google. Recuerda que la API debe ser 30 o inferior para garantizar que los emojis funcionen en las versiones correctas.
• El teléfono de prueba no admite fuentes descargables.
• Verifica la versión correcta de los Servicios de Google Play.