Урок 5: Ресурсы (res), квалификаторы, локализация, шрифты

Типы ресурсов в Android

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

Папка res

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

Основные каталоги:

• drawable — графические файлы и объекты:
  • растровые изображения .png, .jpg, .gif;
  • векторные изображения (из SVG);
  • shape drawable — XML-файлы с формами для атрибута background;
  • layer drawable — несколько изображений в один стек;
  • transition drawable — анимация перехода между двумя объектами.
• layout — файлы макетов экранов.
• mipmap — иконки приложения для различных мест (рабочий стол, экраны настроек и т.д.). В отличие от drawable, хранятся в оригинальном качестве без масштабирования, расфасованы по папкам согласно плотности пикселей и выбираются автоматически. Хранятся в формате webp. Папки с пометкой v26 используются на устройствах с API 26+ (Android 8).
• values — файлы с цветами, строками, размерами и темами. Обращение к ним происходит через @ в разметке или через класс R в коде. Здесь же хранится strings.xml с названием приложения. Все строки из разметки и кода следует выносить в этот файл — это необходимо для локализации.
  • Отдельная папка для ресурсов тёмной темы.
  • Отдельная папка для пользовательских конфигурационных файлов.

Все ресурсы доступны через класс R, который хранит идентификаторы всех создаваемых ресурсов. Это позволяет переиспользовать значения в разных местах приложения и массово их редактировать.

Импорт шрифтов

В макете используются два семейства шрифтов: Rubik (для вариантов слов) и Nunito (для всего остального). Искать исходники следует на Google Fonts. Rubik нужен в начертании Regular, Nunito — в Regular, SemiBold и Bold. Скачиваем все нужные варианты.

Создание директории font

После разархивации удаляем лишнее и переименовываем шрифты в стиле snake_case. Затем создаём каталог font в ресурсах и копируем шрифты туда.

Для создания каталога: правая кнопка мыши на папке res → New → Android Resource Directory. Задаём название font и выбираем тип font в выпадающем списке. Нажимаем OK.

Добавление шрифтов элементам разметки

Пересобираем проект, чтобы подтянулись новые ресурсы. Шрифты расставляются по элементам TextView согласно макету через атрибут fontFamily:

android:fontFamily="@font/rubik_regular"

Строковые ресурсы

Строки следует выносить в строковые ресурсы по трём причинам:

1. Переиспользование одних и тех же строк в разных местах.
2. Массовое редактирование строк.
3. Локализация приложения.

Перед выносом строк обратите внимание на предупреждение Missing contentDescription attribute on image у элементов ImageView. Content description — текстовое описание изображения для скринридеров (программ синтеза речи для людей с нарушением зрения). Задаётся атрибутом contentDescription.

После заполнения contentDescription среда разработки подсветит захардкоженные строки варнингом — это сигнал для их выноса в ресурсы.

Как создать строковый ресурс (string resource)

Строки для вопроса и вариантов ответа будут задаваться программно, поэтому их следует перенести в атрибут tools и убрать text. Для остальных захардкоженных строк воспользуемся предложением добавить тег игнорирования.

Безусловно выносятся: строки об успешности или неверности ответа, а также тексты кнопок «Пропустить» и «Продолжить».

Способы создания строкового ресурса:

• Вручную — добавить запись в файл strings.xml.
• Через контекстное меню — навести курсор на атрибут текста и нажать Extract string resource.

В окне создания ресурса:

• Resource name — уникальный идентификатор в стиле snake_case. Рекомендуется начинать с типа строки, затем конкретизировать контекст: например, button_skip.
• Resource value — непосредственно текст строки.

После создания в атрибуте записывается ссылка на ресурс: @string/button_skip. Переход к ресурсу — Ctrl/Cmd + клик по ссылке.

Квалификаторы на примере локализации ресурсов

Что такое квалификаторы

Квалификаторы позволяют использовать разные значения ресурсов в зависимости от конфигурации устройства. Для локализации создаются папки для каждого языка, в каждой из которых лежит файл со строками нужной локали: папка values-en — английский, values-ru — русский. При обращении к строкам через класс R система сама выбирает нужный вариант по языку устройства.

Квалификаторы применяются не только для языков:

• разные изображения в зависимости от плотности пикселей (как у иконок в mipmap);
• разные интерфейсы в зависимости от ориентации экрана;
• разные ресурсы для разных версий Android.

Как локализировать Android приложение

1. Создать каталог для русскоязычной локализации: правая кнопка мыши на res → New → Android Resource Directory. Тип оставить values, в названии добавить -ru.
2. Скопировать strings.xml в новую папку.
3. Открыть редактор переводов кнопкой Open Editor. В таблице добавить переводы для нужных строк.
4. Для строк, не требующих перевода, установить чекбокс Untranslatable — он прописывает строке специальный атрибут и убирает предупреждение об отсутствии перевода.

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