Używaj czcionek do pobrania

Wypróbuj Compose

Jetpack Compose to zalecany zestaw narzędzi interfejsu na Androida. Dowiedz się, jak używać tekstu w funkcji Utwórz.

Czcionki do pobrania →

Funkcja czcionek do pobrania umożliwia interfejsom API wysyłanie próśb o czcionki do aplikacji dostawcy zamiast dołączania plików do aplikacji lub zezwalania aplikacji na pobieranie czcionek. Czcionki do pobrania są dostępne na urządzeniach z Androidem w wersji API 14 lub nowszej dzięki bibliotece AndroidX Core.

Czcionki do pobrania zapewniają te korzyści:

• Zmniejsza rozmiar aplikacji, co zwiększa odsetek instalacji.
• Poprawia ogólną kondycję systemu, ponieważ wiele aplikacji może udostępniać tę samą czcionkę za pomocą dostawcy. Dzięki temu użytkownicy oszczędzają komórkową transmisję danych, pamięć telefonu i miejsce na dysku. W tym modelu czcionka jest pobierana z sieci w razie potrzeby.

Aby zapoznać się z czcionkami do pobrania, zobacz przykładową aplikację DownloadableFonts.

Jak działają czcionki do pobrania?

Dostawca czcionek to aplikacja, która pobiera czcionki i zapisuje je w pamięci podręcznej na urządzeniu, aby inne aplikacje mogły wysyłać do niej żądania i udostępniać czcionki. Proces ten przedstawiono na poniższym rysunku.

Rysunek 1. procesu pobierania czcionek.

Podstawy

Funkcji czcionek do pobrania możesz używać w ten sposób (szczegółowe informacje znajdziesz w dalszych sekcjach):

• Korzystanie z Androida Studio i Usług Google Play
• Automatycznie
• Korzystanie z biblioteki AndroidX Core

Korzystanie z pobieranych czcionek w Android Studio i Usługach Google Play

Możesz skonfigurować pobieranie czcionek przez aplikację za pomocą Androida Studio 3.0 lub nowszego. Aby ułatwić Ci rozpoczęcie korzystania z funkcji czcionek do pobrania, możesz użyć dostawcy czcionek z Usług Google Play.

Uwaga: aby korzystać z dostawcy Czcionki Google, urządzenie musi mieć usługi Google Play w wersji 11 lub nowszej.

1. W edytorze układu wybierz TextView. Następnie w sekcji Atrybuty wybierz fontFamily > Więcej czcionek.

   

   Rysunek 2. Korzystanie z Edytora układu.

   Pojawi się okno Zasoby.
2. W menu Źródło wybierz Google Fonts.
3. W polu Czcionki wybierz czcionkę w sekcji „Do pobrania”.
4. Kliknij Utwórz czcionkę do pobrania i OK.

   

   Rysunek 3. wybieranie czcionki w oknie Zasoby;

Android Studio automatycznie generuje odpowiednie pliki XML, które są potrzebne do prawidłowego renderowania czcionki w aplikacji.



Rysunek 4. Wyświetlanie podglądu pliku czcionki.

Automatyczne korzystanie z czcionek do pobrania

Od Androida 8.0 (interfejs API na poziomie 26) biblioteka AndroidX Core w pełni obsługuje czcionki do pobrania. Więcej informacji o korzystaniu z biblioteki AndroidX Core znajdziesz w sekcji Biblioteka AndroidX Core z czcionkami do pobrania na tej stronie.

Aby korzystać z funkcji czcionek do pobrania w sposób programowy, używaj 2 klas kluczowych:

• android.graphics.fonts.FontRequest: ta klasa umożliwia utworzenie prośby o czcionkę.
• FontsContractCompat: ta klasa umożliwia tworzenie nowego obiektu Typeface na podstawie żądania czcionki.

Aplikacja pobiera czcionki od dostawcy czcionek za pomocą interfejsu FontsContract. Każdy dostawca ma własny zestaw ograniczeń dotyczących wersji Androida i języka zapytań, które obsługuje. Więcej informacji o wersjach Androida i formacie zapytania znajdziesz w dokumentacji dostawcy.

Aby pobrać czcionkę, wykonaj te czynności:

1. Utwórz instancję klasy android.graphics.fonts.FontRequest, aby poprosić dostawcę o czcionkę. Aby utworzyć żądanie, przekaż te parametry:
   • organ dostawcy czcionki.
   • Pakiet dostawcy czcionek do weryfikacji tożsamości dostawcy.
   • Ciąg zapytania czcionki. Więcej informacji o formatach zapytań znajdziesz w dokumentacji dostawcy czcionek, np. w dokumentacji Czcionek Google.
   • Lista zestawów skrótów certyfikatów do weryfikacji tożsamości dostawcy.
     Uwaga: nie musisz dodawać certyfikatu, jeśli prosisz o czcionki od wstępnie zainstalowanych dostawców. Jeśli jednak żądasz czcionek za pomocą biblioteki AndroidX Core, zawsze podawaj certyfikat.

   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);

   Uwaga: wartości parametrów możesz uzyskać od dostawcy czcionki. Android Studio automatycznie wypełnia te wartości w przypadku obsługiwanych dostawców w swoim interfejsie.
2. Utwórz instancję klasy FontsContract.FontRequestCallback.
3. Zastąp metodę onTypefaceRetrieved() , aby wskazać, że żądanie czcionki zostało zrealizowane. Podaj pobraną czcionkę jako parametr. Za pomocą tej metody możesz ustawić czcionkę zgodnie z potrzebami. Możesz na przykład ustawić czcionkę na TextView.
4. Zastąp metodę onTypefaceRequestFailed() , aby otrzymywać informacje o błędach w procesie żądania czcionki. Więcej informacji o kodach błędów znajdziesz w stałych kodów błędów.
5. Wywołaj metodę FontsContract.requestFont(), aby pobrać czcionkę od dostawcy czcionek. Metoda rozpoczyna sprawdzanie, czy czcionka znajduje się w pamięci podręcznej. Jeśli czcionka nie jest dostępna lokalnie, wywołuje dostawcę czcionki, pobiera ją asynchronicznie i przekazuje wynik do wywołania zwrotnego. Przekaż te parametry:
   • Instancja klasy Context
   • Instancja klasy android.graphics.fonts.FontRequest
   • Wywołanie zwrotne do otrzymywania wyników żądania czcionki
   • Moduł obsługi pobierania czcionek w wątku
   Uwaga: upewnij się, że ten moduł obsługi nie jest modułem obsługi wątku interfejsu użytkownika.

Poniższy przykładowy kod ilustruje ogólny proces pobierania czcionek:

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);

Więcej informacji o pobieraniu czcionki od dostawcy znajdziesz w przykładowej aplikacji DownloadableFonts.

Korzystanie z czcionek do pobrania w Androidzie X Core

AndroidX Core obsługuje funkcję czcionek do pobrania na urządzeniach z Androidem w wersji API 14 lub nowszej. Pakiet zawiera klasy androidx.core.provider i FontRequest, które umożliwiają implementację zgodnej wstecznie funkcji czcionek do pobrania.FontsContractCompat Klasy AndroidX zawierają metody podobne do metod platformy, a proces pobierania czcionek jest podobny do tego opisanego w sekcji na tej stronie dotyczącej programowego korzystania z czcionek do pobrania.

Aby pobrać czcionki za pomocą AndroidX, zaimportuj klasy FontsContractCompat i FontRequest z pakietu androidx.core.provider. Zamiast klas frameworka FontsContract i android.graphics.fonts.FontRequest twórz instancje tych klas.

Uwaga: podczas wysyłania żądań czcionek za pomocą biblioteki AndroidX Core musisz podać certyfikat. Dotyczy to nawet dostawców czcionek preinstalowanych.

Dodawanie zależności AndroidX Core

Aby używać klas FontsContractCompat i FontRequest, musisz zmodyfikować zależności ścieżki klas projektu aplikacji w środowisku programistycznym.

Aby dodać AndroidX Core do projektu aplikacji, dodaj tę zależność do pliku build.gradle aplikacji:

Groovy

dependencies {
    ...
    implementation "androidx.core:core-ktx:1.17.0"
}

Kotlin

dependencies {
    ...
    implementation("androidx.core:core-ktx:1.17.0")
}

Używanie czcionek do pobrania jako zasobów w XML

Android 8.0 (interfejs API na poziomie 26) i AndroidX Core oferują szybszy i wygodniejszy sposób deklarowania niestandardowej czcionki jako zasobu w układzie XML. Oznacza to, że nie musisz dołączać czcionki jako zasobu. Możesz zdefiniować niestandardową czcionkę dla całego motywu, co przyspiesza korzystanie z wielu grubości i stylów, takich jak pogrubiony, średni lub lekki, jeśli są dostępne.

1. Utwórz nowy plik XML w folderze res/font.
2. Dodaj element główny <font-family> i ustaw atrybuty związane z czcionką, jak pokazano w tym przykładowym pliku XML:

<?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>

3. Odwołuj się do pliku jako @font/font_file_name w pliku XML układu. Możesz też użyć metody getFont(), aby pobrać plik automatycznie, np. getFont(R.font.font_file_name).

Wstępne deklarowanie czcionek w pliku manifestu

Powiększanie układu i pobieranie zasobów to zadania synchroniczne. Domyślnie pierwsza próba pobrania czcionek wywołuje żądanie do dostawcy czcionek, co zwiększa czas pierwszego układu. Aby uniknąć opóźnienia, możesz wstępnie zadeklarować w pliku manifestu czcionki, które mają zostać pobrane. Po pobraniu czcionki od dostawcy jest ona od razu dostępna. Jeśli pobieranie czcionki trwa dłużej niż oczekiwano, system przerywa proces pobierania i używa czcionki domyślnej.

Aby wstępnie zadeklarować czcionki w pliku manifestu, wykonaj te czynności:

1. Utwórz tablicę zasobów w res/values/arrays.xml i zadeklaruj czcionki, które chcesz wstępnie pobrać.

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>

2. Aby zadeklarować tablicę zasobów w pliku manifestu, użyj tagu meta-data.

<meta-data android:name="preloaded_fonts" android:resource="@array/preloaded_fonts" />

Dodawanie certyfikatów

Jeśli dostawca czcionek nie jest preinstalowany lub używasz biblioteki AndroidX Core, zadeklaruj certyfikaty, którymi jest podpisany dostawca czcionek. System używa certyfikatów do weryfikacji tożsamości dostawcy czcionek.

Uwaga: Android Studio może automatycznie wypełniać wartości dostawcy usług Google Play, jeśli używasz narzędzia do wyboru czcionek w Android Studio. Więcej informacji o pobieraniu czcionek za pomocą Android Studio znajdziesz w sekcji Korzystanie z czcionek do pobrania w Android Studio i Usługach Google Play na tej stronie.

Aby dodać certyfikaty, wykonaj te czynności:

1. Utwórz tablicę ciągów znaków ze szczegółami certyfikatu. Więcej informacji o szczegółach certyfikatu znajdziesz w dokumentacji dostawcy czcionki.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="certs">
       <item>MIIEqDCCA5CgAwIBAgIJA071MA0GCSqGSIb3DQEBBAUAMIGUMQsww...</item>
    </string-array>
</resources>

2. Ustaw atrybut fontProviderCerts na tablicę.

android:fontProviderCerts="@array/certs"

Uwaga: jeśli dostawca ma więcej niż 1 zestaw certyfikatów, możesz zdefiniować tablicę tablic ciągów znaków.

Czcionki do pobrania w Compose