随着所有类型应用的表情符号使用率都快速增加,Unicode 每年都会更新标准的表情符号集。
如果您的应用显示互联网内容或提供文本输入,我们强烈建议您支持最新的表情符号字体。否则,之后的表情符号可能会显示为名为“豆腐块” (☐) 的小方块或其他错误呈现的表情符号序列。
Android 版本 11(API 级别 30)及更低版本无法更新表情符号字体,因此必须手动更新在这些版本上显示表情符号字体的应用。
以下是新式表情符号的示例。
示例 | 版本 |
---|---|
🫠 🫱🏼🫲🏿 🫰🏽 | 14.0(2021 年 9 月) |
😶🌫️ 🧔🏻♀️ 🧑🏿❤️🧑🏾 | 13.1(2020 年 9 月) |
🥲 🥷🏿 🐻❄️ | 13.0(2020 年 3 月) |
🧑🏻🦰 🧑🏿🦯 👩🏻🤝👩🏼 | 12.1(2019 年 10 月) |
🦩 🦻🏿 👩🏼🤝👩🏻 | 12.0(2019 年 2 月) |
BOM 2023 年 3 月 (Compose UI 1.4) 支持最新表情符号版本,包括向后兼容旧版 Android 直至 API 21。
这项支持无需对您的应用进行任何更改:如果您使用 Text
和 TextField
(Material 2 或 Material 3)或者 BasicText
和 BasicTextField
,开箱即可获享现代表情符号支持。
若要在您的应用中测试最新表情符号,最佳方法是使用搭载 API 30 或更低级别的真实设备。
如果您使用的是自定义表情符号解决方案,或出于任何其他原因需要停用 Compose 中的默认表情符号分辨率,则可以使用 PlatformTextStyle(emojiSupportMatch)
:
Text( text = "Hello $EMOJI_TEXT", style = TextStyle( platformStyle = PlatformTextStyle( emojiSupportMatch = EmojiSupportMatch.None )/* ... */ ) )
互操作性
如果您的应用在同一个 Activity
中同时使用 View 和 Compose,请务必使用适当的 API 正确配置表情符号。以下部分介绍了每种 API 的适用情形。
从 ComponentActivity
扩展
如果您的 Activity
从 Compose ComponentActivity
(而不是 AppCompatActivity
)扩展,请按照在不使用 AppCompat 的情况下支持表情符号中的说明操作。
由于您没有扩展 AppCompatActivity
,因此请将 Emoji2 库添加到依赖项中,并在视图中使用 EmojiTextView
,而不是 TextView
widget,如以下代码段所示:
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 } } } }
然后,在您的 XML 文件中:
<androidx.emoji2.widget.EmojiTextView android:id="@+id/emoji_text_view" android:layout_width="match_parent" android:layout_height="wrap_content" />
从 AppCompatActivity
扩展
如果您的 Activity
从 AppCompatActivity
扩展,您可以使用 ComposeView
调用可组合函数。当您使用 Text 可组合项时,表情符号会在各种 Android 版本中正确呈现。
如果您是从 AppCompatActivity
扩展,请膨胀 XML 中的 TextView
,以正确呈现表情符号。
如果是膨胀 XML,就会出现这种情况:
- 在
ComposeView
外部,在Activity
内。请注意以下代码段中的AppCompatActivity
和TextView
用法:
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 } } } }
- (如以下代码段所示),在
ComposeView
内(使用AndroidViewBinding
通过视图绑定实现):
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 } } } } ) } }
如需使用 ComposeView
内的 AndroidView
膨胀文本,请使用 AppCompatTextView
正确呈现表情符号:
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 } ) } } } ) } }
如需了解详情,请参阅 Interoperability API 文档。
问题排查
如果您看到的是豆腐 (☐) 而不是表情符号,请先检查问题是否是由您的特定测试设备所致。您可以检查以下主要事项:
- 您可能使用的是最近刷写的设备或新的模拟器。如果可能,请尝试使用登录了 Google 帐号的其他真实测试设备。请注意,API 应为 30 或更低版本,以确保表情符号在正确的版本中正常运行。
- 测试手机不支持可下载字体。
- 检查正确的 Google Play 服务版本。
为您推荐
- 注意:当 JavaScript 处于关闭状态时,系统会显示链接文字
- 其他注意事项
- Compose 中的文字
- 滚动