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

Попробуйте способ создания

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

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

Примечание. На этой странице описано, как использовать загружаемые шрифты с пользовательским интерфейсом на основе View . Если вы используете Jetpack Compose, см. раздел «Загружаемые шрифты» в документации Compose .

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

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

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

Практический опыт работы с загружаемыми шрифтами см. в примере приложения DownloadableFonts .

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

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

Рисунок 1. Процесс загрузки загружаемых шрифтов.

Основы

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

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

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

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

Примечание. Для использования поставщика Google Fonts на устройстве должны быть установлены службы Google Play версии 11 или выше.

1. В редакторе макетов выберите TextView . Затем в разделе «Атрибуты» выберите «Семейство шрифтов» > «Дополнительные шрифты» .

   

   Рисунок 2. Использование редактора макетов .

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

   

   Рисунок 3. Выбор шрифта в окне «Ресурсы» .

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



Рисунок 4. Предварительный просмотр файла шрифта.

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

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

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

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

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

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

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

   Котлин

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

   Примечание . Значения параметров можно получить у поставщика шрифтов. Android Studio автоматически заполняет эти значения для поставщиков, которых она поддерживает, в своем пользовательском интерфейсе.
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 необходимо предоставить сертификат. Это применимо даже для предустановленных поставщиков шрифтов.

Добавить зависимость ядра AndroidX

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

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

классный

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

Котлин

dependencies {
    ...
    implementation("androidx.core:core-ktx:2.2.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, объявите сертификаты, которыми подписан поставщик шрифтов. Система использует сертификаты для проверки личности поставщика шрифтов.

Примечание . Android Studio может автоматически заполнять значения для поставщика услуг Google Play, если вы используете инструмент выбора шрифта в Android Studio. Дополнительную информацию об использовании Android Studio для загрузки шрифтов см. в разделе «Использование загружаемых шрифтов с сервисами Android Studio и Google Play» на этой странице.

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

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

Начиная с Compose 1.2-alpha07 , вы можете использовать API загружаемых шрифтов в своем приложении Compose для асинхронной загрузки шрифтов Google и использования их в своем приложении. Дополнительную информацию см. в документации по созданию загружаемых шрифтов .