Fitur Font yang Dapat Didownload memungkinkan API meminta font dari aplikasi penyedia, bukan membundel file ke dalam aplikasi atau membiarkan aplikasi mendownload font. Font yang Dapat Didownload tersedia di perangkat yang menjalankan Android API versi 14 dan yang lebih tinggi melalui library AndroidX Core.
Font yang Dapat Didownload menawarkan manfaat berikut:
- Mengurangi ukuran aplikasi sehingga meningkatkan tingkat keberhasilan penginstalan aplikasi.
- Meningkatkan kesehatan sistem secara keseluruhan, karena beberapa aplikasi dapat berbagi font yang sama melalui penyedia. Tindakan ini akan menghemat data seluler pengguna, memori ponsel, dan kapasitas disk. Dalam model ini, font diambil melalui jaringan jika diperlukan.
Bagaimana cara kerja Font yang Dapat Didownload?
Penyedia font adalah aplikasi yang mengambil font dan menyimpan dalam cache secara lokal sehingga aplikasi lain dapat meminta dan berbagi font. Gambar berikut mengilustrasikan prosesnya.
![Gambar yang menunjukkan komponen utama dalam proses compat Emoji](https://developer.android.com/static/guide/topics/ui/images/look-and-feel/downloadable-fonts/downloadable-fonts-process.png?authuser=6&hl=id)
Dasar-dasar
Anda dapat menggunakan fitur Font yang Dapat Didownload dengan cara berikut, yang akan dibahas secara mendetail di bagian selanjutnya:
- Menggunakan Android Studio dan Layanan Google Play
- Secara terprogram
- Menggunakan library AndroidX Core
Menggunakan Font yang Dapat Didownload dengan Android Studio dan layanan Google Play
Anda dapat menyetel aplikasi Anda untuk mendownload font dengan menggunakan Android Studio 3.0 atau yang lebih tinggi. Untuk membantu memulai fitur Font yang Dapat Didownload, Anda dapat menggunakan penyedia font dari layanan Google Play.
- Di Layout Editor, pilih
TextView
. Lalu, di bagian Attributes, pilih fontFamily > More Fonts.Gambar 2. Menggunakan Layout Editor. - Di menu Source, pilih Google Fonts.
- Dalam kotak Fonts, pilih font di bawah area "Downloadable".
- Pilih Buat font yang dapat didownload, lalu klik OK.
Gambar 3. Memilih font dari jendela Resource.
Android Studio otomatis menghasilkan file XML relevan yang diperlukan untuk merender font dengan benar di aplikasi Anda.
![Gambar yang menunjukkan cara melihat pratinjau font](https://developer.android.com/static/guide/topics/ui/images/look-and-feel/downloadable-fonts/preview-fonts.png?authuser=6&hl=id)
Menggunakan Font yang Dapat Didownload secara terprogram
Mulai dari Android 8.0 (API level 26), AndroidX Core menyediakan dukungan penuh untuk Font yang Dapat Didownload. Untuk informasi selengkapnya tentang penggunaan library AndroidX Core, lihat bagian library AndroidX Core Fonts yang Dapat Didownload di halaman ini.
Untuk menggunakan fitur Font yang Dapat Didownload secara terprogram, lakukan interaksi dengan dua class utama:
android.graphics.fonts.FontRequest
: class ini memungkinkan Anda membuat permintaan font.FontsContractCompat
: class ini memungkinkan Anda membuat objekTypeface
baru berdasarkan permintaan font.
Aplikasi Anda mengambil font dari penyedia font dengan menggunakan FontsContract
API. Setiap
penyedia memiliki serangkaian batasan masing-masing pada versi Android dan bahasa kueri yang didukungnya. Untuk
mengetahui informasi selengkapnya tentang versi Android dan format kueri, lihat dokumentasi
penyedia Anda.
Untuk mendownload font, selesaikan langkah-langkah berikut:
- Buat instance class
android.graphics.fonts.FontRequest
untuk meminta font dari penyedia. Untuk membuat permintaan, teruskan parameter berikut:- Otoritas penyedia font.
- Paket penyedia font untuk memverifikasi identitas penyedia.
- Kueri string font. Untuk mengetahui informasi selengkapnya tentang format kueri, lihat dokumentasi penyedia font Anda, seperti Google Fonts.
- Daftar serangkaian hash bagi sertifikat untuk memverifikasi identitas penyedia.
Kotlin
val request = FontRequest( "com.example.fontprovider.authority", "com.example.fontprovider", "my font", certs )
Java
FontRequest request = new FontRequest("com.example.fontprovider", "com.example.fontprovider", "my font", certs);
- Buat instance class
FontsContract.FontRequestCallback
. - Ganti metode
onTypefaceRetrieved()
untuk menunjukkan bahwa permintaan font telah selesai. Masukkan font yang diambil sebagai parameter. Anda dapat menggunakan metode ini untuk menyetel font sesuai kebutuhan. Misalnya, Anda dapat menetapkan font padaTextView
. - Ganti metode
onTypefaceRequestFailed()
untuk menerima informasi tentang error dalam proses permintaan font. Untuk informasi selengkapnya tentang kode error, lihat konstanta kode error. - Panggil metode
FontsContract.requestFont()
untuk mengambil font dari penyedia font. Metode ini memulai pemeriksaan untuk menentukan apakah font ada dalam cache. Jika font tidak tersedia secara lokal, font akan memanggil penyedia font, mengambil font secara asinkron, dan meneruskan hasilnya ke callback. Teruskan parameter berikut:- Instance class
Context
- Instance class
android.graphics.fonts.FontRequest
- Callback untuk menerima hasil permintaan font
- Pengendali untuk mengambil font pada thread
- Instance class
Kode contoh berikut mengilustrasikan proses Font yang Dapat Didownload secara keseluruhan:
Kotlin
val request = FontRequest( "com.example.fontprovider.authority", "com.example.fontprovider", "my font", certs ) val callback = object : FontsContract.FontRequestCallback() { override fun onTypefaceRetrieved(typeface: Typeface) { // Your code to use the font goes here. ... } override fun onTypefaceRequestFailed(reason: Int) { // Your code to deal with the failure goes here. ... } } FontsContract.requestFonts(context, request, handler, null, callback)
Java
FontRequest request = new FontRequest("com.example.fontprovider.authority", "com.example.fontprovider", "my font", certs); FontsContract.FontRequestCallback callback = new FontsContract.FontRequestCallback() { @Override public void onTypefaceRetrieved(Typeface typeface) { // Your code to use the font goes here. ... } @Override public void onTypefaceRequestFailed(int reason) { // Your code to deal with the failure goes here. ... } }; FontsContract.requestFonts(context, request, handler, null, callback);
Untuk mengetahui informasi selengkapnya tentang cara mendownload font dari penyedia font, lihat aplikasi contoh DownloadableFonts.
Menggunakan Font yang Dapat Didownload dengan AndroidX Core
AndroidX Core menyediakan dukungan untuk fitur Font yang Dapat Didownload di perangkat yang menjalankan Android
API versi 14 atau yang lebih tinggi. Paket
androidx.core.provider
berisi class FontsContractCompat
dan FontRequest
untuk mengimplementasikan
dukungan fitur Font yang Dapat Didownload yang kompatibel dengan versi lama. Class AndroidX berisi metode
yang serupa dengan metode framework, dan proses untuk mendownload font serupa dengan
yang dijelaskan di bagian halaman ini tentang
menggunakan Font yang Dapat Didownload secara terprogram.
Untuk mendownload font menggunakan AndroidX, impor class FontsContractCompat
dan
FontRequest
dari paket androidx.core.provider
. Buat
instance dari class ini, bukan
class framework FontsContract
dan
android.graphics.fonts.FontRequest
.
Menambahkan dependensi AndroidX Core
Untuk menggunakan class FontsContractCompat
dan FontRequest
, Anda harus mengubah
dependensi classpath project aplikasi dalam lingkungan pengembangan Anda.
Untuk menambahkan AndroidX Core ke project aplikasi, tambahkan dependensi berikut ke file
build.gradle
aplikasi Anda:
Groovy
dependencies { ... implementation "androidx.core:core-ktx:2.2.0" }
Kotlin
dependencies { ... implementation("androidx.core:core-ktx:2.2.0") }
Menggunakan Font yang Dapat Didownload sebagai resource dalam XML
Android 8.0 (API level 26) dan AndroidX Core menawarkan cara yang lebih cepat dan mudah untuk mendeklarasikan font kustom sebagai resource dalam tata letak XML. Artinya, Anda tidak perlu memaketkan font sebagai aset. Anda dapat menentukan font kustom untuk seluruh tema, yang mempercepat kegunaan untuk beberapa bobot dan gaya, seperti tebal, sedang, atau terang, jika disediakan.
- Buat file XML baru di folder
res/font
. - Tambahkan elemen root
<font-family>
dan tetapkan atribut terkait font, seperti yang ditunjukkan dalam contoh file XML berikut: - Lihat file sebagai
@font/font_file_name
dalam file XML tata letak. Anda juga dapat menggunakan metodegetFont()
untuk mengambil file secara terprogram, sepertigetFont(R.font.font_file_name)
.
<?xml version="1.0" encoding="utf-8"?> <font-family xmlns:android="http://schemas.android.com/apk/res/android" android:fontProviderAuthority="com.example.fontprovider.authority" android:fontProviderPackage="com.example.fontprovider" android:fontProviderQuery="example font" android:fontProviderCerts="@array/certs"> </font-family>
Deklarasikan font di awal dalam manifes
Perluasan tata letak dan pengambilan resource adalah tugas tersinkron. Secara default, upaya pertama untuk mengambil font akan memicu permintaan ke penyedia font, sehingga meningkatkan waktu tata letak pertama. Untuk menghindari penundaan, Anda dapat mendeklarasikan di awal font yang perlu diambil dalam manifes. Setelah sistem mengambil font dari penyedia, font akan langsung tersedia. Jika pengambilan font memerlukan waktu lebih lama dari yang diperkirakan, sistem akan membatalkan proses pengambilan dan menggunakan font default.
Untuk mendeklarasikan font di awal dalam manifes, selesaikan langkah-langkah berikut:
- Buat array resource di
res/values/arrays.xml
dan deklarasikan font yang ingin Anda ambil datanya. - Gunakan tag
meta-data
untuk mendeklarasikan array resource dalam manifes.
res/values/arrays.xml <?xml version="1.0" encoding="utf-8"?> <resources> <array name="preloaded_fonts"> <item>@font/font1</item> <item>@font/font2</item> </array> </resources>
<meta-data android:name="preloaded_fonts" android:resource="@array/preloaded_fonts" />
Tambahkan sertifikat
Jika penyedia font belum diinstal sebelumnya, atau jika Anda menggunakan library AndroidX Core, deklarasikan sertifikat yang telah ditandatangani dengan penyedia font. Sistem menggunakan sertifikat tersebut untuk memverifikasi identitas penyedia font.
Lakukan langkah-langkah berikut untuk menambahkan sertifikat:
- Buat array string dengan detail sertifikat. Untuk informasi selengkapnya tentang detail sertifikat, lihat dokumentasi penyedia font Anda.
- Tetapkan atribut
fontProviderCerts
ke array.
<?xml version="1.0" encoding="utf-8"?> <resources> <string-array name="certs"> <item>MIIEqDCCA5CgAwIBAgIJA071MA0GCSqGSIb3DQEBBAUAMIGUMQsww...</item> </string-array> </resources>
android:fontProviderCerts="@array/certs"
Font yang Dapat Didownload di Compose
Mulai Compose 1.2-alpha07, Anda dapat menggunakan Downloadable Fonts API di aplikasi Compose untuk mendownload Google Fonts secara asinkron dan menggunakannya di aplikasi Anda. Untuk informasi selengkapnya, lihat dokumentasi Membuat Font yang Dapat Didownload.