Значки помогают пользователям идентифицировать ваше приложение и действия в нем. Вы можете получить доступ к набору значков материалов и добавить их в свое приложение непосредственно с помощью Compose. Чтобы создавать собственные значки или значки для вашего приложения с помощью представлений, Android Studio предлагает Image Asset Studio.
Добавьте значки в свое приложение с помощью Compose
С помощью Compose вы можете импортировать библиотеку Compose Material или Compose Material 3 для доступа к любым значкам материалов. Затем используйте компонуемый Icon
, чтобы добавить значки в ваше приложение. Значки материалов наиболее полезны для значков панели действий, значков вкладок или значков уведомлений. Дополнительные сведения см. в разделе Значки материалов .
Если вам нужно создать собственные значки, например значок запуска приложения, используйте Image Asset Studio . Для значков запуска файл AndroidManifest.xml
должен ссылаться на mipmap/
location. Image Asset Studio автоматически добавит этот код. Следующий код файла манифеста ссылается на значок ic_launcher
в каталоге mipmap/
:
<application android:name="ApplicationTitle" android:label="@string/app_label" android:icon="@mipmap/ic_launcher" >
О студии Image Asset Studio
В состав Android Studio входит инструмент Image Asset Studio, который помогает создавать собственные значки приложений из значков материалов , пользовательских изображений и текстовых строк. Он генерирует набор значков с соответствующим разрешением для каждой плотности пикселей , которую поддерживает ваше приложение. Image Asset Studio помещает вновь созданные значки в папки с определенной плотностью в каталоге res/
вашего проекта. Во время выполнения Android использует соответствующий ресурс в зависимости от плотности экрана устройства, на котором работает ваше приложение.
Image Asset Studio помогает создавать следующие типы значков:
- Значки запуска
- Значки панели действий и вкладок
- Значки уведомлений
В следующих разделах описаны типы значков, которые вы можете создать, а также изображения и текстовые поля, которые вы можете использовать.
Адаптивные и устаревшие значки запуска
Значок средства запуска — это изображение, которое представляет ваше приложение пользователям. Он может:
- Появляются в списке приложений, установленных на устройстве и на главном экране.
- Представляйте ярлыки в вашем приложении (например, значок ярлыка контакта, который открывает подробную информацию о контакте).
- Может использоваться приложениями запуска.
- Помогите пользователям найти ваше приложение в Google Play.
Адаптивные значки панели запуска могут отображаться в различных формах на разных моделях устройств и доступны в Android 8.0 (уровень API 26) и более поздних версиях. В Android Studio 3.0 появилась поддержка создания адаптивных значков с помощью Image Asset Studio. Image Asset Studio создает предварительный просмотр адаптивного значка в форме круга, квадрата, квадрата с закругленными углами и квадрата, а также предварительный просмотр значка под обрез. Image Asset Studio также создает превью значка устаревшего, круглого и Google Play Store. Устаревший значок средства запуска — это изображение, которое представляет ваше приложение на главном экране устройства и в окне средства запуска. Устаревшие значки запуска предназначены для использования на устройствах под управлением Android 7.1 (уровень API 25) или более ранней версии, которые не поддерживают адаптивные значки и не отображаются в виде различных форм в зависимости от модели устройства.
Image Asset Studio размещает значки в нужных местах в каталогах res/mipmap- density /
. Он также создает изображение размером 512 x 512 пикселей, подходящее для магазина Google Play.
Мы рекомендуем использовать стиль Material Design для значков запуска, даже если вы поддерживаете более старые версии Android.
Дополнительные сведения см. в разделах «Адаптивные значки панели запуска» и «Значки продуктов — Material Design» .
Значки панели действий и вкладок
Значки панели действий — это графические элементы, размещенные на панели действий и обозначающие отдельные элементы действий. Дополнительные сведения см. в разделах «Добавление и обработка действий» , «Панель приложения — Material Design » и « Дизайн панели действий» .
Значки вкладок — это графические элементы, используемые для обозначения отдельных вкладок в интерфейсе с несколькими вкладками. Каждый значок вкладки имеет два состояния: невыбранное и выбранное. Дополнительные сведения см. в разделе «Создание видов с перелистыванием с помощью вкладок и вкладок — Material Design» .
Image Asset Studio размещает значки в нужных местах в каталогах res/drawable- density /
.
Мы рекомендуем использовать стиль Material Design для значков панели действий и вкладок, даже если вы поддерживаете более старые версии Android. Используйте appcompat
и другие библиотеки поддержки , чтобы перенести пользовательский интерфейс Material Design на более старые версии платформы.
В качестве альтернативы Image Asset Studio вы можете использовать Vector Asset Studio для создания значков панели действий и вкладок. Векторные рисунки подходят для простых значков и могут уменьшить размер вашего приложения.
Значки уведомлений
Уведомление — это сообщение, которое вы можете отобразить пользователю за пределами обычного пользовательского интерфейса вашего приложения. Image Asset Studio размещает значки уведомлений в нужных местах в каталогах res/drawable- density /
:
- Иконки для Android 2.2 (уровень API 8) и ниже размещаются в каталогах
res/drawable- density /
. - Значки для Android 2.3–2.3.7 (уровни API с 9 по 10) размещаются в каталогах
res/drawable- density -v9/
. - Значки для Android 3 (уровень API 11) и выше размещаются в каталогах
res/drawable- density -v11/
.
Если ваше приложение поддерживает Android 2.3–2.3.7 (уровни API с 9 по 10), Image Asset Studio создаст серую версию вашего значка. В более поздних версиях Android используется белый значок, который генерирует Image Asset Studio.
См. Уведомления ; Материальный дизайн уведомлений ; Уведомления, изменения Android 5.0 ; Уведомления, Android 4.4 и более ранние версии ; и значки строки состояния, Android 3.0 и более ранних версий для получения дополнительной информации.
Клип-арт
Image Asset Studio упрощает импорт значков материалов Google в форматах VectorDrawable и PNG: просто выберите значок в диалоговом окне. Для получения дополнительной информации см. Значки материалов .
Изображения
Вы можете импортировать свои собственные изображения и настроить их в соответствии с типом значка. Image Asset Studio поддерживает следующие типы файлов: PNG (предпочтительно), JPG (допустимо) и GIF (не рекомендуется).
Текстовые строки
Image Asset Studio позволяет вводить текстовую строку различными шрифтами и размещать ее на значке. Он преобразует текстовый значок в файлы PNG различной плотности. Вы можете использовать шрифты, которые установлены на вашем компьютере.
Запустите Image Asset Studio.
Чтобы запустить Image Asset Studio, выполните следующие действия:
- В окне «Проект» выберите представление Android .
- Щелкните правой кнопкой мыши папку res и выберите «Создать» > «Актив изображения» .
- Продолжайте, выполнив следующие действия:
- Создавайте адаптивные и устаревшие значки запуска .
- Создайте панель действий или значок вкладки .
- Создайте значок уведомления .
Создавайте адаптивные и устаревшие значки запуска
После открытия Image Asset Studio вы можете добавить адаптивные и устаревшие значки, выполнив следующие действия:
- В поле «Тип значка» выберите «Значки запуска (адаптивные и устаревшие)» .
- На вкладке «Слой переднего плана» выберите « Тип актива» , а затем укажите актив в поле ниже:
- Выберите «Изображение» , чтобы указать путь к файлу изображения.
- Выберите «Клип-арт» , чтобы указать изображение из набора значков Material Design .
- Выберите «Текст» , чтобы указать текстовую строку и выберите шрифт.
- На вкладке «Фоновый слой» выберите « Тип ресурса» , а затем укажите актив в поле ниже. Вы можете выбрать цвет или указать изображение, которое будет использоваться в качестве фонового слоя.
- На вкладке «Устаревшие» проверьте настройки по умолчанию и подтвердите, что вы хотите создавать устаревшие, круглые значки и значки Google Play Store.
- При желании измените имя и настройки отображения для каждой вкладки «Слой переднего плана» и «Фоновый слой» :
- Имя . Если вы не хотите использовать имя по умолчанию, введите новое имя. Если это имя ресурса уже существует в проекте, на что указывает ошибка в нижней части мастера, оно перезаписывается. Имя может содержать только символы нижнего регистра, символы подчеркивания и цифры.
- Обрезать — чтобы отрегулировать границу между изображением значка и границей исходного ресурса, выберите «Да» . Эта операция удаляет прозрачное пространство, сохраняя при этом соотношение сторон. Чтобы оставить исходный актив без изменений, выберите Нет .
- Цвет — чтобы изменить цвет значка клипа или текста , щелкните это поле. В диалоговом окне «Выбор цвета» укажите цвет и нажмите «Выбрать» . Новое значение появится в поле.
- Изменение размера — используйте ползунок, чтобы указать коэффициент масштабирования в процентах для изменения размера значка изображения , картинки или текста . Этот элемент управления отключается для фонового слоя, когда вы указываете тип ресурса «Цвет» .
- Нажмите Далее .
- При необходимости измените каталог ресурсов: выберите набор источников ресурсов, в который вы хотите добавить ресурс изображения: src/main/res , src/debug/res , src/release/res или пользовательский набор источников. Основной набор исходного кода применяется ко всем вариантам сборки, включая отладку и выпуск. Наборы исходного кода для отладки и выпуска переопределяют основной набор исходного кода и применяются к одной версии сборки. Набор исходных текстов для отладки предназначен только для отладки. Чтобы определить новый набор исходного кода, выберите «Файл» > «Структура проекта» > «Приложение» > «Типы сборки» . Например, вы можете определить исходный набор бета-версии и создать версию значка, включающую текст «БЕТА» в правом нижнем углу. Дополнительные сведения см. в разделе Настройка вариантов сборки .
- Нажмите «Готово» . Image Asset Studio добавляет изображения в папки MIP-карт с различной плотностью.
Предварительный просмотр тематических значков приложений
Android Studio позволяет предварительно просмотреть значок вашего тематического приложения и проверить, как он адаптируется к цвету обоев пользователя. Чтобы просмотреть значок вашего тематического приложения, откройте файл launcher.xml
, который определяет ваш значок, а затем воспользуйтесь переключателем режима системного пользовательского интерфейса на панели инструментов, чтобы переключить обои и посмотреть, как значок отреагирует.
Дополнительные сведения о том, как создавать тематические значки приложений, см. в разделе Адаптивные значки .
Создайте панель действий или значок вкладки
После открытия Image Asset Studio вы можете добавить панель действий или значок вкладки, выполнив следующие действия:
- В поле «Тип значка» выберите «Значки панели действий и вкладок» .
- Выберите тип актива , а затем укажите актив в поле ниже:
- В поле «Картинка» нажмите кнопку.
- В поле Путь укажите путь и имя файла изображения. Нажмите ..., чтобы использовать диалоговое окно.
- В поле «Текст» введите текстовую строку и выберите шрифт.
- При желании измените имя и параметры отображения:
- Имя . Если вы не хотите использовать имя по умолчанию, введите новое имя. Если это имя ресурса уже существует в проекте, о чем свидетельствует ошибка в нижней части мастера, оно перезаписывается. Имя может содержать только символы нижнего регистра, символы подчеркивания и цифры.
- Обрезать — чтобы отрегулировать границу между изображением значка и границей исходного ресурса, выберите «Да» . Эта операция удаляет прозрачное пространство, сохраняя при этом соотношение сторон. Чтобы оставить исходный актив без изменений, выберите Нет .
- Отступы . Если вы хотите настроить отступы исходного ресурса со всех четырех сторон, переместите ползунок. Выберите значение от -10% до 50%. Если вы также выберете «Обрезать» , сначала произойдет обрезка.
- Тема — выберите HOLO_LIGHT или HOLO_DARK . Или, чтобы указать цвет в диалоговом окне «Выбор цвета» , выберите «ПОЛЬЗОВАТЕЛЬСКИЙ» , а затем щелкните поле «Пользовательский цвет» .
Image Asset Studio создает значок в прозрачном квадрате с отступами по краям. Отступы обеспечивают достаточно места для стандартного эффекта значка тени.
- Нажмите Далее .
- При желании измените каталог ресурсов:
- Каталог Res — выберите набор источников ресурсов, в который вы хотите добавить ресурс изображения: src/main/res , src/debug/res , src/release/res или пользовательский набор источников. Основной набор исходного кода применяется ко всем вариантам сборки, включая отладку и выпуск. Наборы исходного кода для отладки и выпуска переопределяют основной набор исходного кода и применяются к одной версии сборки. Набор исходных текстов для отладки предназначен только для отладки. Чтобы определить новый набор исходного кода, выберите «Файл» > «Структура проекта» > «Приложение» > «Типы сборки» . Например, вы можете определить исходный набор бета-версии и создать версию значка, включающую текст «БЕТА» в правом нижнем углу. Дополнительные сведения см. в разделе Настройка вариантов сборки .
- Нажмите «Готово» .
В диалоговом окне «Выбор значка» выберите значок материала и нажмите «ОК» .
Значок появится в области «Исходный ресурс» справа и в области предварительного просмотра в нижней части мастера.
В области «Каталоги вывода» отображаются изображения и папки, в которых они будут отображаться в представлении «Файлы проекта» окна «Проект» .
Image Asset Studio добавляет изображения в доступные для рисования папки различной плотности.
Создайте значок уведомления
После открытия Image Asset Studio вы можете добавить значок уведомления, выполнив следующие действия:
- В поле «Тип значка» выберите «Значки уведомлений» .
- Выберите тип актива , а затем укажите актив в поле ниже:
- В поле «Картинка» нажмите кнопку.
- В поле Путь укажите путь и имя файла изображения. Нажмите ..., чтобы использовать диалоговое окно.
- В поле «Текст» введите текстовую строку и выберите шрифт.
- При желании измените имя и параметры отображения:
- Имя . Если вы не хотите использовать имя по умолчанию, введите новое имя. Если это имя ресурса уже существует в проекте, о чем свидетельствует ошибка в нижней части мастера, оно перезаписывается. Имя может содержать только символы нижнего регистра, символы подчеркивания и цифры.
- Обрезать — чтобы отрегулировать границу между изображением значка и границей исходного ресурса, выберите «Да» . Эта операция удаляет прозрачное пространство, сохраняя при этом соотношение сторон. Чтобы оставить исходный актив без изменений, выберите Нет .
- Отступы . Если вы хотите настроить отступы исходного ресурса со всех четырех сторон, переместите ползунок. Выберите значение от -10% до 50%. Если вы также выберете «Обрезать» , сначала произойдет обрезка.
Image Asset Studio создает значок в прозрачном квадрате с отступами по краям. Отступ обеспечивает достаточно места для стандартного эффекта значка тени.
- Нажмите Далее .
- При желании измените каталог ресурсов:
- Каталог Res — выберите набор источников ресурсов, в который вы хотите добавить ресурс изображения: src/main/res , src/debug/res , src/release/res или пользовательский набор источников. Основной набор исходного кода применяется ко всем вариантам сборки, включая отладку и выпуск. Наборы исходного кода для отладки и выпуска переопределяют основной набор исходного кода и применяются к одной версии сборки. Набор исходных текстов для отладки предназначен только для отладки. Чтобы определить новый набор исходного кода, выберите «Файл» > «Структура проекта» > «Приложение» > « Типы сборки» . Например, вы можете определить исходный набор бета-версии и создать версию значка, включающую текст «БЕТА» в правом нижнем углу. Дополнительные сведения см. в разделе Настройка вариантов сборки .
- Нажмите «Готово» .
В диалоговом окне «Выбор значка» выберите значок материала и нажмите «ОК» .
Значок появится в области «Исходный ресурс» справа и в области предварительного просмотра в нижней части мастера.
В области «Каталоги вывода» отображаются изображения и папки, в которых они будут отображаться в представлении «Файлы проекта» окна «Проект» .
Image Asset Studio добавляет изображения в доступные для рисования папки различной плотности и версии.
Обратитесь к ресурсу изображения в коде с помощью представлений.
Обычно вы можете ссылаться на ресурс изображения в общем виде в своем коде, и когда ваше приложение запускается, соответствующее изображение отображается автоматически в зависимости от устройства:
- В большинстве случаев вы можете ссылаться на ресурсы изображений как
@drawable
в коде XML илиDrawable
в коде Java. - Если ваше приложение использует библиотеку поддержки, вы можете обратиться к ресурсу изображения в XML-коде с помощью оператора
app:srcCompat
. Например:
Например, следующий XML-код макета отображает рисуемый объект в ImageView :
<ImageView android:layout_height="wrap_content" android:layout_width="wrap_content" android:src="@drawable/myimage" />
Следующий код Java извлекает изображение как Drawable
:
Котлин
val drawable = resources.getDrawable(R.drawable.myimage, theme)
Ява
Resources res = getResources(); Drawable drawable = res.getDrawable(R.drawable.myimage, getTheme());
Метод getResources()
находится в классе Context
, который применяется к объектам пользовательского интерфейса, таким как действия, фрагменты, макеты, представления и т. д.
<ImageView android:layout_height="wrap_content" android:layout_width="wrap_content" app:srcCompat="@drawable/myimage" />
Вы можете получить доступ к ресурсам изображений только из основного потока.
После того как у вас есть ресурс изображения в каталоге res/
вашего проекта, вы можете ссылаться на него из своего кода Java или макета XML, используя его идентификатор ресурса. Следующий код Java устанавливает ImageView для использования ресурса drawable/myimage.png
:
Котлин
findViewById<ImageView>(R.id.myimageview).apply { setImageResource(R.drawable.myimage) }
Ява
ImageView imageView = (ImageView) findViewById(R.id.myimageview); imageView.setImageResource(R.drawable.myimage);
Дополнительную информацию см. в разделе «Доступ к ресурсам» .
Удаление значка из проекта
Чтобы удалить значок из проекта:
- В окне «Проект» выберите представление Android .
- Разверните папку res/mipmap для значка средства запуска или папку res/drawable для значков других типов.
- Найдите подпапку с именем значка, который вы хотите удалить.
- Выберите папку и нажмите клавишу «Delete» .
- При необходимости выберите параметры, чтобы узнать, где значок используется в проекте, и нажмите «ОК» .
- Выберите «Сборка» > «Очистить проект» .
- При необходимости исправьте все оставшиеся ошибки, связанные с частями кода, ссылающимися на ресурс.
Эта папка содержит значок разной плотности.
Либо выберите «Правка» > «Удалить» . Или щелкните файл правой кнопкой мыши и выберите «Удалить» .
Появится диалоговое окно Безопасное удаление .
Android Studio удаляет файлы из проекта и диска. Однако если вы выбрали поиск мест в проекте, где используются файлы и обнаружены некоторые варианты использования, вы можете просмотреть их и решить, следует ли их удалять. Вы должны удалить или заменить эти ссылки, чтобы иметь возможность успешно скомпилировать проект.
Android Studio удаляет все сгенерированные файлы изображений, соответствующие удаленному ресурсу изображения. Он удаляет их из проекта и диска.
Android Studio выделяет эти ошибки в вашем коде. Удалив все ссылки из своего кода, вы сможете снова успешно построить свой проект.