Ключевые моменты
- Векторный рисунок — это векторная графика, определенная в XML-файле как набор точек, линий и кривых вместе со связанной с ними информацией о цвете.
- Векторные рисунки масштабируемы, то есть их размер можно изменять без потери качества отображения. Это делает их идеальными для использования в приложениях Android, поскольку помогает уменьшить размер APK-файлов и повысить производительность.
- Вы можете создавать векторные рисунки в Android Studio, щелкнув правой кнопкой мыши папку с возможностью рисования в своем проекте и выбрав «Создать» > «Векторный ресурс». Вы также можете импортировать файлы SVG в Android Studio в виде векторных изображений.
Введение
VectorDrawable
— это векторная графика, определенная в XML-файле как набор точек, линий и кривых вместе со связанной с ними информацией о цвете. Основным преимуществом использования векторного изображения является масштабируемость изображения. Его можно масштабировать без потери качества отображения, что означает, что размер одного и того же файла изменяется для различной плотности экрана без потери качества изображения. Это приводит к уменьшению размера APK-файлов и уменьшению затрат на обслуживание со стороны разработчиков. Вы также можете использовать векторные изображения для анимации, используя несколько файлов XML вместо нескольких изображений для каждого разрешения экрана.На этой странице и в видео ниже представлен обзор того, как создавать векторные рисунки в XML. Android Studio также может конвертировать файлы SVG в векторный формат, как описано в разделе «Добавление векторной графики с разной плотностью» .
Android 5.0 (уровень API 21) был первой версией, которая официально поддерживала векторные объекты рисования с помощью VectorDrawable
и AnimatedVectorDrawable
, но вы можете поддерживать более старые версии с помощью библиотеки поддержки Android, которая предоставляет классы VectorDrawableCompat
и AnimatedVectorDrawableCompat
.
О классе VectorDrawable
VectorDrawable
определяет статический объект, который можно рисовать. Подобно формату SVG, каждое векторное изображение определяется как древовидная иерархия, состоящая из объектов path
и group
. Каждый path
содержит геометрию контура объекта, а group
содержит детали для преобразования. Все пути рисуются в том же порядке, в котором они указаны в XML-файле.
![](https://developer.android.com/static/images/guide/topics/graphics/vectorpath.png?authuser=0000&hl=ru)
Рисунок 1. Пример иерархии векторного рисуемого ресурса.
Инструмент студии векторных ресурсов предлагает простой способ добавить векторную графику в проект в виде XML-файла.
Пример XML
Вот пример XML-файла VectorDrawable
, который отображает изображение батареи в режиме зарядки.
<!-- res/drawable/battery_charging.xml --> <vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="24dp" android:width="24dp" android:viewportWidth="24.0" android:viewportHeight="24.0"> <group android:name="rotationGroup" android:pivotX="10.0" android:pivotY="10.0" android:rotation="15.0" > <path android:name="vect" android:fillColor="#FF000000" android:pathData="M15.67,4H14V2h-4v2H8.33C7.6,4 7,4.6 7,5.33V9h4.93L13,7v2h4V5.33C17,4.6 16.4,4 15.67,4z" android:fillAlpha=".3"/> <path android:name="draw" android:fillColor="#FF000000" android:pathData="M13,12.5h2L11,20v-5.5H9L11.93,9H7v11.67C7,21.4 7.6,22 8.33,22h7.33c0.74,0 1.34,-0.6 1.34,-1.33V9h-4v3.5z"/> </group> </vector>
Этот XML отображает следующее изображение:
![](https://developer.android.com/static/images/guide/topics/graphics/ic_battery_charging_80_black_24dp.png?authuser=0000&hl=ru)
О классе AnimatedVectorDrawable
AnimatedVectorDrawable
добавляет анимацию к свойствам векторной графики. Вы можете определить анимированную векторную графику как три отдельных файла ресурсов или как один XML-файл, определяющий весь объект рисования. Давайте рассмотрим оба подхода для лучшего понимания: несколько файлов XML и один файл XML .
Несколько XML-файлов
Используя этот подход, вы можете определить три отдельных XML-файла:
- XML-файл
VectorDrawable
. - XML-файл
AnimatedVectorDrawable
, определяющий целевой объектVectorDrawable
, целевые пути и группы для анимации, свойства и анимации, определенные как объектыObjectAnimator
илиAnimatorSet
. - XML-файл аниматора.
Пример нескольких файлов XML
Следующие XML-файлы демонстрируют анимацию векторной графики.
- XML-файл VectorDrawable:
vd.xml
<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="64dp" android:width="64dp" android:viewportHeight="600" android:viewportWidth="600" > <group android:name="rotationGroup" android:pivotX="300.0" android:pivotY="300.0" android:rotation="45.0" > <path android:name="vectorPath" android:fillColor="#000000" android:pathData="M300,70 l 0,-70 70,70 0,0 -70,70z" /> </group> </vector>
- XML-файл AnimatedVectorDrawable:
avd.xml
<animated-vector xmlns:android="http://schemas.android.com/apk/res/android" android:drawable="@drawable/vd" > <target android:name="rotationGroup" android:animation="@anim/rotation" /> <target android:name="vectorPath" android:animation="@anim/path_morph" /> </animated-vector>
- XML-файлы Animator, которые используются в XML-файле AnimatedVectorDrawable:
rotation.xml
иpath_morph.xml
<objectAnimator android:duration="6000" android:propertyName="rotation" android:valueFrom="0" android:valueTo="360" />
<set xmlns:android="http://schemas.android.com/apk/res/android"> <objectAnimator android:duration="3000" android:propertyName="pathData" android:valueFrom="M300,70 l 0,-70 70,70 0,0 -70,70z" android:valueTo="M300,70 l 0,-70 70,0 0,140 -70,0 z" android:valueType="pathType"/> </set>
Один XML-файл
Используя этот подход, вы можете объединить связанные XML-файлы в один XML-файл с помощью формата XML Bundle. Во время создания приложения тег aapt
создает отдельные ресурсы и ссылается на них в анимированном векторе. Для этого подхода требуются инструменты сборки 24 или более поздней версии, а выходные данные обратно совместимы.
Пример одного XML-файла
<animated-vector xmlns:android="http://schemas.android.com/apk/res/android" xmlns:aapt="http://schemas.android.com/aapt"> <aapt:attr name="android:drawable"> <vector android:width="24dp" android:height="24dp" android:viewportWidth="24" android:viewportHeight="24"> <path android:name="root" android:strokeWidth="2" android:strokeLineCap="square" android:strokeColor="?android:colorControlNormal" android:pathData="M4.8,13.4 L9,17.6 M10.4,16.2 L19.6,7" /> </vector> </aapt:attr> <target android:name="root"> <aapt:attr name="android:animation"> <objectAnimator android:propertyName="pathData" android:valueFrom="M4.8,13.4 L9,17.6 M10.4,16.2 L19.6,7" android:valueTo="M6.4,6.4 L17.6,17.6 M6.4,17.6 L17.6,6.4" android:duration="300" android:interpolator="@android:interpolator/fast_out_slow_in" android:valueType="pathType" /> </aapt:attr> </target> </animated-vector>
Решение обратной совместимости векторных рисунков
Для поддержки рисования векторных и анимированных векторов на устройствах с версиями платформы ниже Android 5.0 (уровень API 21) или использования функций fillColor
, fillType
и strokeColor
ниже Android 7.0 (уровень API 24), VectorDrawableCompat
и AnimatedVectorDrawableCompat
доступны через две библиотеки поддержки: support-vector-drawable
animated-vector-drawable
соответственно.
В Android Studio 1.4 появилась ограниченная поддержка совместимости для векторных изображений путем создания PNG-файлов во время сборки. Однако библиотеки поддержки векторного рисования и анимированного векторного рисования обеспечивают как гибкость, так и широкую совместимость — это библиотека поддержки, поэтому вы можете использовать ее со всеми версиями платформы Android, начиная с Android 2.1 (уровень API 7+). Чтобы настроить приложение для использования библиотек поддержки векторов, добавьте элемент vectorDrawables
в файл build.gradle
в модуле приложения.
Используйте следующий фрагмент кода для настройки элемента vectorDrawables
:
классный
// For Gradle Plugin 2.0+ android { defaultConfig { vectorDrawables.useSupportLibrary = true } }
Котлин
// For Gradle Plugin 2.0+ android { defaultConfig { vectorDrawables.useSupportLibrary = true } }
классный
// For Gradle Plugin 1.5 or below android { defaultConfig { // Stops the Gradle plugin’s automatic rasterization of vectors generatedDensities = [] } // Flag notifies aapt to keep the attribute IDs around aaptOptions { additionalParameters "--no-version-vectors" } }
Котлин
// For Gradle Plugin 1.5 or below android { defaultConfig { // Stops the Gradle plugin’s automatic rasterization of vectors generatedDensities() } // Flag notifies aapt to keep the attribute IDs around aaptOptions { additionalParameters("--no-version-vectors") } }
Вы можете использовать VectorDrawableCompat
и AnimatedVectorDrawableCompat
на всех устройствах под управлением Android 4.0 (уровень API 14) и выше. Способ, которым Android загружает объекты рисования, не каждое место, где принимается идентификатор рисования, например, в XML-файле, поддерживает загрузку векторных объектов рисования. В пакет android.support.v7.appcompat
добавлен ряд функций, упрощающих использование векторных изображений. Во-первых, когда вы используете пакет android.support.v7.appcompat
с ImageView
или с подклассами, такими как ImageButton
и FloatingActionButton
, вы можете использовать новый атрибут app:srcCompat
для ссылки на векторные объекты рисования, а также на любые другие объекты рисования, доступные для android:src
:
<ImageView android:layout_width="wrap_content" android:layout_height="wrap_content" app:srcCompat="@drawable/ic_add" />
Чтобы изменить объекты рисования во время выполнения, вы можете использовать метод setImageResource()
как и раньше. Использование AppCompat
и app:srcCompat
— это наиболее надежный метод интеграции векторных изображений в ваше приложение.
Библиотека поддержки версии 25.4.0 и выше поддерживает следующие функции:
- Морфинг пути (оценщик PathType) Используется для преобразования одного пути в другой путь.
- Интерполяция пути Используется для определения гибкого интерполятора (представленного в виде пути) вместо определяемых системой интерполяторов, таких как LinearInterpolator.
Библиотека поддержки версии 26.0.0-beta1 и выше поддерживает следующие функции:
- Перемещение по пути Геометрический объект может перемещаться по произвольному пути как часть анимации.
Пример нескольких файлов XML с использованием библиотеки поддержки
Следующие файлы XML демонстрируют подход к использованию нескольких файлов XML для анимации векторной графики.
- XML-файл VectorDrawable:
vd.xml
<vector xmlns:android="http://schemas.android.com/apk/res/android" android:height="64dp" android:width="64dp" android:viewportHeight="600" android:viewportWidth="600" > <group android:name="rotationGroup" android:pivotX="300.0" android:pivotY="300.0" android:rotation="45.0" > <path android:name="vectorPath" android:fillColor="#000000" android:pathData="M300,70 l 0,-70 70,70 0,0 -70,70z" /> </group> </vector>
- XML-файл AnimatedVectorDrawable:
avd.xml
<animated-vector xmlns:android="http://schemas.android.com/apk/res/android" android:drawable="@drawable/vd" > <target android:name="rotationGroup" android:animation="@anim/rotation" /> </animated-vector>
- XML-файл Animator, который используется в XML-файле AnimatedVectorDrawable:
rotation.xml
<objectAnimator android:duration="6000" android:propertyName="rotation" android:valueFrom="0" android:valueTo="360" />
Один XML-файл
Следующий XML-файл демонстрирует подход к использованию одного XML-файла для анимации векторной графики. Во время создания приложения тег aapt
создает отдельные ресурсы и ссылается на них в анимированном векторе. Для этого подхода требуются инструменты сборки 24 или более поздней версии, а выходные данные обратно совместимы.
Пример одного XML-файла с использованием библиотеки поддержки
<animated-vector xmlns:android="http://schemas.android.com/apk/res/android" xmlns:aapt="http://schemas.android.com/aapt"> <aapt:attr name="android:drawable"> <vector xmlns:android="http://schemas.android.com/apk/res/android" android:width="64dp" android:height="64dp" android:viewportWidth="600" android:viewportHeight="600"> <group android:name="rotationGroup" android:pivotX="300" android:pivotY="300" android:rotation="45.0" > <path android:name="vectorPath" android:fillColor="#000000" android:pathData="M300,70 l 0,-70 70,70 0,0 -70,70z" /> </group> </vector> </aapt:attr> <target android:name="rotationGroup"> <aapt:attr name="android:animation"> <objectAnimator android:propertyName="rotation" android:valueFrom="0" android:valueTo="360" android:duration="6000" android:interpolator="@android:interpolator/fast_out_slow_in" /> </aapt:attr> </target> </animated-vector>