Kumpulan emoji standar diperbarui setiap tahun oleh Unicode, karena penggunaan emoji meningkat dengan cepat untuk semua jenis aplikasi.
Jika aplikasi Anda menampilkan konten internet atau menyediakan input teks, sebaiknya dukungan font emoji terbaru. Jika tidak, emoji nantinya mungkin ditampilkan sebagai kotak persegi kecil yang disebut tofu (Validator) atau urutan emoji yang salah dirender.
Android versi 11 (level API 30) dan yang lebih rendah tidak dapat mengupdate font emoji, sehingga aplikasi yang menampilkannya di versi tersebut harus diupdate secara manual.
Berikut adalah contoh emoji modern.
Contoh | Versi |
---|---|
🫠 🫱🏼🫲🏿 🫰🏽 | 14.0 (September 2021) |
😶🌫️ 🧔🏻♀️ 🧑🏿❤️🧑🏾 | 13.1 (September 2020) |
🥲 🥷🏿 🐻❄️ | 13.0 (Maret 2020) |
🧑🏻🦰 🧑🏿🦯 👩🏻🤝👩🏼 | 12.1 (Oktober 2019) |
🦩 🦻🏿 👩🏼🤝👩🏻 | 12.0 (Februari 2019) |
BOM Maret 2023 (Compose UI 1.4) menghadirkan dukungan untuk versi emoji terbaru, termasuk kompatibilitas mundur dengan versi Android lama hingga API 21.
Dukungan ini tidak memerlukan perubahan pada aplikasi—jika menggunakan Text
dan
TextField
(Material 2 atau Material 3) atau BasicText
dan
BasicTextField
, Anda akan langsung mendapatkan dukungan emoji modern.
Cara terbaik untuk menguji emoji terbaru di aplikasi Anda adalah dengan menggunakan perangkat sebenarnya di API 30 atau yang lebih lama.
Jika Anda menggunakan solusi emoji kustom, atau perlu menonaktifkan resolusi emoji default
di Compose karena alasan lain, Anda dapat menggunakan
PlatformTextStyle(emojiSupportMatch)
:
Text( text = "Hello $EMOJI_TEXT", style = TextStyle( platformStyle = PlatformTextStyle( emojiSupportMatch = EmojiSupportMatch.None )/* ... */ ) )
Kemampuan interoperabilitas
Jika aplikasi menggunakan View dan Compose dalam Activity
yang sama, pastikan Anda
menggunakan API yang sesuai untuk mengonfigurasi emoji dengan benar. Bagian berikut
menjelaskan kapan harus menggunakan setiap API.
Memperluas dari ComponentActivity
Jika Activity
Anda diperluas dari Compose ComponentActivity
, bukan
AppCompatActivity
, ikuti petunjuk Mendukung emoji tanpa AppCompat.
Karena Anda tidak memperluas AppCompatActivity
, tambahkan library
Emoji2 ke dependensi dan gunakan EmojiTextView
dalam tampilan,
bukan widget TextView
, seperti yang ditampilkan dalam cuplikan berikut:
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 } } } }
Kemudian, di file XML Anda:
<androidx.emoji2.widget.EmojiTextView android:id="@+id/emoji_text_view" android:layout_width="match_parent" android:layout_height="wrap_content" />
Memperluas dari AppCompatActivity
Jika Activity
diperluas dari AppCompatActivity
, Anda dapat menggunakan
ComposeView
untuk memanggil fungsi composable. Emoji dirender dengan benar di seluruh
versi Android saat Anda menggunakan composable Text.
Jika Anda memperluas dari AppCompatActivity
, inflate TextView
dari XML
agar emoji dirender dengan benar.
Hal ini berlaku jika Anda meng-inflate XML:
- di luar
ComposeView
, diActivity
. Perhatikan penggunaanAppCompatActivity
danTextView
dalam cuplikan berikut:
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 } } } }
- di dalam
ComposeView
, melalui view binding menggunakanAndroidViewBinding
, seperti dalam cuplikan berikut:
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 } } } } ) } }
Untuk meng-inflate teks dengan AndroidView
di dalam ComposeView
, gunakan
AppCompatTextView
untuk merender emoji dengan benar:
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 } ) } } } ) } }
Lihat dokumentasi API Interoperabilitas untuk mengetahui detailnya.
Pemecahan masalah
Jika Anda melihat tofu (Wir ) dan bukan emoji, periksa terlebih dahulu apakah masalahnya adalah perangkat pengujian spesifik Anda. Ada beberapa hal utama yang dapat Anda periksa:
- Anda mungkin menggunakan perangkat yang baru-baru ini di-flash atau emulator baru. Jika memungkinkan, coba perangkat pengujian sebenarnya lain yang sering Anda gunakan yang login ke Akun Google Anda. Ingat bahwa API harus dalam versi 30 atau yang lebih rendah untuk memastikan emoji berfungsi dalam versi yang benar.
- Ponsel pengujian tidak mendukung font yang dapat didownload.
- Periksa versi layanan Google Play yang benar.
Direkomendasikan untuk Anda
- Catatan: teks link ditampilkan saat JavaScript nonaktif
- Pertimbangan lainnya
- Teks dalam Compose
- Scroll