Используйте загружаемые шрифты

Попробуйте способ «Композиции»

Jetpack Compose — рекомендуемый набор инструментов для разработки пользовательского интерфейса для Android. Узнайте, как использовать текст в Compose.

Загружаемые шрифты →

Функция «Загружаемые шрифты» позволяет API запрашивать шрифты у приложения-поставщика вместо того, чтобы добавлять файлы в приложение или позволять приложению загружать шрифты. Функция «Загружаемые шрифты» доступна на устройствах с Android API версии 14 и выше через библиотеку AndroidX Core.

Загружаемые шрифты предлагают следующие преимущества:

• Уменьшает размер приложения, тем самым увеличивая вероятность успешной установки приложения.
• Улучшает общую работоспособность системы, поскольку несколько приложений могут использовать один и тот же шрифт через поставщика. Это экономит мобильный трафик, память телефона и дисковое пространство. В этой модели шрифт загружается по сети по мере необходимости.

Как работают загружаемые шрифты?

Поставщик шрифтов — это приложение, которое извлекает шрифты и кэширует их локально, чтобы другие приложения могли запрашивать шрифты и обмениваться ими. Этот процесс показан на рисунке ниже.

Основы

Функцию загружаемых шрифтов можно использовать следующими способами, которые подробно обсуждаются в последующих разделах:

• Использование Android Studio и сервисов Google Play
• Программно
• Использование библиотеки AndroidX Core

Используйте загружаемые шрифты с Android Studio и сервисами Google Play

Вы можете настроить приложение на загрузку шрифтов, используя Android Studio 3.0 или более поздней версии. Чтобы начать работу с функциями загружаемых шрифтов, воспользуйтесь поставщиком шрифтов из сервисов Google Play.

1. В редакторе макетов выберите TextView . Затем в разделе «Атрибуты» выберите fontFamily > «Другие шрифты» .

   

   Появится окно «Ресурсы» .
2. В меню «Источник» выберите «Google Fonts» .
3. В поле «Шрифты» выберите шрифт в области «Загружаемые».
4. Выберите Создать загружаемый шрифт и нажмите ОК .

   

Android Studio автоматически генерирует соответствующие XML-файлы, необходимые для корректного отображения шрифта в вашем приложении.

Используйте загружаемые шрифты программно

Начиная с Android 8.0 (API уровня 26), AndroidX Core обеспечивает полную поддержку загружаемых шрифтов. Подробнее об использовании библиотеки AndroidX Core см. в разделе «Загружаемые шрифты» на этой странице.

Чтобы использовать функцию загружаемых шрифтов программно, взаимодействуйте с двумя ключевыми классами:

• android.graphics.fonts.FontRequest : этот класс позволяет создать запрос шрифта.
• FontsContractCompat : этот класс позволяет создать новый объект Typeface на основе запроса шрифта.

Ваше приложение получает шрифты от поставщика шрифтов с помощью API FontsContract . Каждый поставщик имеет собственные ограничения на поддерживаемые версии Android и языки запросов. Подробнее о версиях Android и формате запросов см. в документации вашего поставщика.

Чтобы загрузить шрифт, выполните следующие действия:

1. Создайте экземпляр класса android.graphics.fonts.FontRequest для запроса шрифта у поставщика. Для создания запроса передайте следующие параметры:
   • Поставщик шрифтов.
   • Пакет поставщика шрифтов для проверки личности поставщика.
   • Строковый запрос шрифта. Подробнее о форматах запросов см. в документации поставщика шрифтов, например, Google Fonts .
   • Список наборов хешей сертификатов для проверки личности поставщика.

   Котлин

   val request = FontRequest(
           "com.example.fontprovider.authority",
           "com.example.fontprovider",
           "my font",
           certs
   )

   Ява

   FontRequest request = new FontRequest("com.example.fontprovider",
                      "com.example.fontprovider", "my font", certs);

2. Создайте экземпляр класса FontsContract.FontRequestCallback .
3. Переопределите метод onTypefaceRetrieved() , чтобы сообщить о завершении запроса шрифта. Передайте полученный шрифт в качестве параметра. Этот метод можно использовать для установки необходимого шрифта. Например, можно установить шрифт для TextView .
4. Переопределите метод onTypefaceRequestFailed() , чтобы получать информацию об ошибках в процессе запроса шрифта. Подробнее о кодах ошибок см. в разделе « Константы кодов ошибок» .
5. Вызовите метод FontsContract.requestFont() , чтобы получить шрифт от поставщика шрифтов. Метод инициирует проверку наличия шрифта в кэше. Если шрифт недоступен локально, он вызывает поставщика шрифтов, асинхронно извлекает шрифт и передает результат в функцию обратного вызова. Передайте следующие параметры:
   • Экземпляр класса Context
   • Экземпляр класса android.graphics.fonts.FontRequest
   • Обратный вызов для получения результатов запроса шрифта
   • Обработчик для загрузки шрифтов в потоке

Следующий пример кода иллюстрирует общий процесс загрузки шрифтов:

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)

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

Дополнительную информацию о загрузке шрифта от поставщика шрифтов см. в примере приложения DownloadableFonts .

Используйте загружаемые шрифты с AndroidX Core

AndroidX Core обеспечивает поддержку функции загружаемых шрифтов на устройствах с Android API версии 14 и выше. Пакет androidx.core.provider содержит классы FontsContractCompat и FontRequest для реализации обратно-совместимой поддержки функции загружаемых шрифтов. Классы AndroidX содержат методы, аналогичные методам фреймворка, а процесс загрузки шрифтов аналогичен описанному в разделе этой страницы, посвящённом программному использованию загружаемых шрифтов .

Чтобы загрузить шрифты с помощью AndroidX, импортируйте классы FontsContractCompat и FontRequest из пакета androidx.core.provider . Создайте экземпляры этих классов вместо классов фреймворка FontsContract и android.graphics.fonts.FontRequest .

Добавить зависимость AndroidX Core

Чтобы использовать классы FontsContractCompat и FontRequest , необходимо изменить зависимости classpath вашего проекта приложения в среде разработки.

Чтобы добавить AndroidX Core в проект вашего приложения, добавьте следующую зависимость в файл build.gradle вашего приложения:

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

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

Использовать загружаемые шрифты как ресурсы в XML

Android 8.0 (API уровня 26) и AndroidX Core предлагают более быстрый и удобный способ объявить пользовательский шрифт как ресурс в XML-макете. Это означает, что нет необходимости добавлять шрифт в качестве ресурса. Вы можете определить пользовательский шрифт для всей темы, что повышает удобство использования шрифтов с различными насыщенностями и стилями, такими как жирный, средний или светлый, если они предусмотрены.

1. Создайте новый XML-файл в папке res/font .
2. Добавьте корневой элемент <font-family> и задайте атрибуты, связанные со шрифтом, как показано в следующем примере 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. В XML-файле макета файл обозначается как @font/font_file_name . Вы также можете использовать метод getFont() для программного извлечения файла, например, getFont(R.font.font_file_name) .

Предварительно объявить шрифты в манифесте

Расширение макета и получение ресурсов — синхронные задачи. По умолчанию первая попытка получения шрифтов инициирует запрос к поставщику шрифтов, что увеличивает время первого получения. Чтобы избежать задержки, можно заранее объявить шрифты, которые необходимо получить, в манифесте. После того, как система получит шрифт от поставщика, он будет доступен немедленно. Если получение шрифта занимает больше времени, чем ожидалось, система прерывает процесс получения и использует шрифт по умолчанию.

Чтобы предварительно объявить шрифты в манифесте, выполните следующие действия:

1. Создайте массив ресурсов в res/values/arrays.xml и объявите шрифты, которые вы хотите предварительно загрузить.

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. Используйте тег meta-data для объявления массива ресурсов в манифесте.

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

Добавить сертификаты

Если поставщик шрифтов не предустановлен или вы используете библиотеку AndroidX Core, укажите сертификаты, которыми подписан поставщик шрифтов. Система использует эти сертификаты для проверки подлинности поставщика шрифтов.

Для добавления сертификатов выполните следующие действия:

1. Создайте массив строк с данными сертификата. Подробнее о данных сертификата см. в документации поставщика шрифтов.

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

2. Установите атрибут fontProviderCerts для массива.

android:fontProviderCerts="@array/certs"

Загружаемые шрифты в Compose