因為所有應用程式類型的表情符號使用頻率迅速上升,所以標準表情符號每年都會由萬國碼 (Unicode) 重新整理。
如果您的應用程式會顯示網際網路內容或提供文字輸入,強烈建議支援最新的表情符號字型。否則,稍後的表情符號可能會顯示為名為「tofu」的小正方形方塊 (☐),或其他以錯誤轉譯的表情符號序列。
Android 11 (API 級別 30) 及以下版本無法更新表情符號字型,因此在這些版本上顯示表情符號的應用程式必須手動更新。
以下是現代表情符號的範例。
範例 | 版本 |
---|---|
🫠? 🫱?🏿? 🫲?🏿? 🫰?🏽? | 14.0 (2021 年 9 月) |
😶🌫️ 🧔🏻♀️ 🧑🏿❤️🧑🏾 | 13.1 (2020 年 9 月) |
🥲 🥷🏿 🐻❄️ | 13.0 (2020 年 3 月) |
🧑🏻🦰 🧑🏿🦯 👩🏻🤝👩🏼 | 12.1 (2019 年 10 月) |
🦩 🦻🏿 👩🏼🤝👩🏻 | 12.0 (2019 年 2 月) |
2023 年 3 月的 BOM (Compose UI 1.4) 支援最新的表情符號版本,包括與 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
小工具),如以下程式碼片段所示:
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
呼叫可組合函式。使用文字可組合項時,表情符號會在所有 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 } ) } } } ) } }
詳情請參閱互通性 API 說明文件。
疑難排解
如果您看到「tofu」 (☐),而不是顯示表情符號,請先檢查問題是否出在特定的測試裝置。以下是幾個常見的檢查事項:
- 您使用的可能是最近刷新的裝置或新的模擬器。如果可以,請嘗試使用其他您經常登入 Google 帳戶的實際測試裝置。請注意,API 應為 30 以下,以確保表情符號在正確版本中運作。
- 測試手機不支援可下載字型。
- 查看正確的 Google Play 服務版本。
為您推薦
- 注意:系統會在 JavaScript 關閉時顯示連結文字
- 其他考量
- Compose 中的文字
- 捲動