Эта страница переведена с помощью Cloud Translation API.

Поддержка пакетов библиотек

Примечание: С выпуском Support Library 28.0.0 библиотеки, упакованные в android.support , устарели и заменены библиотеками Jetpack с индивидуальными версиями, упакованными как androidx . Первоначальный выпуск 1.0.0 библиотек Jetpack обеспечивает паритет с Support Library 28.0.0 и служит отправной точкой для перехода на новую упаковку androidx .

Существующие библиотеки, упакованные в android.support продолжат работать; однако они не будут получать никаких обновлений после 28.0.0 и не будут совместимы с новыми библиотеками Jetpack. Исторические артефакты (версии 27 и более ранние, упакованные как android.support ) останутся доступными в Google Maven. Все новые артефакты будут упакованы как androidx и потребуют миграции с android.support на androidx .

Мы рекомендуем использовать библиотеки androidx во всех новых проектах. Вам также следует рассмотреть возможность миграции существующих проектов, чтобы гарантировать, что они продолжат получать исправления ошибок и другие улучшения библиотеки.

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

Чтобы использовать любую из следующих библиотек, необходимо загрузить файлы библиотеки в вашу установку Android SDK. Следуйте инструкциям по загрузке библиотек поддержки в разделе «Настройка библиотеки поддержки», чтобы завершить этот шаг. Необходимо выполнить дополнительные шаги для включения определенной библиотеки поддержки в ваше приложение. В конце каждого раздела библиотеки ниже приведена важная информация о том, как включить библиотеку в ваше приложение.

Примечание: Минимальная версия SDK для всех пакетов библиотек поддержки — не ниже уровня API 14. Для некоторых пакетов требуется более высокий уровень API, как указано ниже.

Библиотеки поддержки v4

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

Полную и подробную информацию о классах и методах, предоставляемых библиотеками поддержки v4, см. в пакете android.support.v4 в справочнике по API.

Примечание: До версии Support Library 24.2.0 существовала одна библиотека поддержки v4. Эта библиотека была разделена на несколько модулей для повышения эффективности. Для обратной совместимости, если вы перечислите support-v4 в своем скрипте Gradle, ваше приложение будет включать все модули v4. Однако, чтобы уменьшить размер приложения, мы рекомендуем вам просто перечислить конкретные модули, необходимые вашему приложению.

библиотека совместимости v4

Предоставляет оболочки совместимости для ряда API-интерфейсов фреймворка, таких как Context.obtainDrawable() и View.performAccessibilityAction() .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:support-compat:28.0.0

v4 core-utils библиотека

Предоставляет ряд служебных классов, таких как AsyncTaskLoader и PermissionChecker .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:support-core-utils:28.0.0

v4 core-ui библиотека

Реализует различные компоненты, связанные с пользовательским интерфейсом, такие как ViewPager , NestedScrollView и ExploreByTouchHelper .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:support-core-ui:28.0.0

библиотека совместимости с медиа v4

Выполняет бэкпортирование частей медиа- фреймворка, включая MediaBrowser и MediaSession .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:support-media-compat:28.0.0

библиотека фрагментов v4

Добавляет поддержку инкапсуляции пользовательского интерфейса и функциональности с фрагментами , позволяя приложениям предоставлять макеты, которые подстраиваются под устройства с малым и большим экраном. Этот модуль имеет зависимости от compat , core-utils , core-ui и media-compat .

Примечание: библиотека поддержки v13 предоставляет класс FragmentCompat . Класс Fragment v4 — это автономный класс, который предоставляет исправления ошибок, добавленные в более поздних версиях платформы, тогда как класс FragmentCompat v13 предоставляет прокладки совместимости для реализации фреймворка класса Fragment .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:support-fragment:28.0.0

Библиотека поддержки Multidex

Эта библиотека обеспечивает поддержку для создания приложений с несколькими исполняемыми файлами Dalvik (DEX). Приложения, ссылающиеся на более чем 65536 методов, должны использовать конфигурации multidex. Для получения дополнительной информации об использовании multidex см. раздел Создание приложений с более чем 64K методов .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:multidex:1.0.0

Библиотеки поддержки v7

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

Библиотека v7 appcompat Часть Android Jetpack .

Примечание: Библиотека appcompat перешла в библиотеку AndroidX , которая является компонентом Android Jetpack . Посмотрите, как она используется в демонстрационном приложении Sunflower .

Эта библиотека добавляет поддержку шаблона проектирования пользовательского интерфейса Action Bar . Эта библиотека включает поддержку реализаций пользовательского интерфейса Material Design .

Примечание: эта библиотека зависит от библиотеки поддержки v4.

Вот несколько ключевых классов, включенных в библиотеку appcompat v7:

ActionBar — обеспечивает реализацию шаблона пользовательского интерфейса панели действий. Для получения дополнительной информации об использовании панели действий см. руководство разработчика панели действий .
AppCompatActivity — добавляет класс активности приложения, который можно использовать в качестве базового класса для активностей, использующих реализацию панели действий библиотеки поддержки.
AppCompatDialog — добавляет класс диалога, который можно использовать в качестве базового класса для диалогов на тему AppCompat.
ShareActionProvider — добавляет поддержку стандартизированного действия по обмену (например, отправка по электронной почте или публикация в социальных приложениях), которое можно включить в панель действий.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:appcompat-v7:28.0.0

библиотека v7 cardview

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

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:cardview-v7:28.0.0

библиотека v7 gridlayout

После загрузки Android Support Libraries эта библиотека добавляет поддержку класса GridLayout , который позволяет размещать элементы пользовательского интерфейса с помощью сетки прямоугольных ячеек. Подробную информацию об API-интерфейсах библиотеки gridlayout v7 см. в пакете android.support.v7.widget в справочнике по API.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:gridlayout-v7:28.0.0

библиотека медиароутера v7

Эта библиотека предоставляет MediaRouter , MediaRouteProvider и связанные с ними медиаклассы, которые поддерживают Google Cast .

В целом, API в библиотеке mediarouter v7 предоставляют средства управления маршрутизацией медиаканалов и потоков с текущего устройства на внешние экраны, динамики и другие устройства назначения. Библиотека включает API для публикации поставщиков маршрутов медиа для конкретных приложений, для обнаружения и выбора устройств назначения, для проверки статуса медиа и т. д. Подробную информацию об API библиотеки mediarouter v7 см. в пакете android.support.v7.media в справочнике по API.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:mediarouter-v7:28.0.0

API библиотеки mediarouter v7, представленные в Support Library r18, могут быть изменены в более поздних версиях Support Library. В настоящее время мы рекомендуем использовать библиотеку только в сочетании с Google Cast .

библиотека палитр v7

Библиотека поддержки палитры v7 включает класс Palette , который позволяет извлекать основные цвета из изображения. Например, музыкальное приложение может использовать объект Palette для извлечения основных цветов из обложки альбома и использовать эти цвета для создания цветной заглавной карточки песни.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:palette-v7:28.0.0

библиотека v7 recyclerview

Библиотека recyclerview добавляет класс RecyclerView . Этот класс обеспечивает поддержку виджета RecyclerView , представления для эффективного отображения больших наборов данных путем предоставления ограниченного окна элементов данных.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:recyclerview-v7:28.0.0

Библиотека поддержки предпочтений v7

Пакет настроек предоставляет API для поддержки добавления объектов настроек, таких как CheckBoxPreference и ListPreference , чтобы пользователи могли изменять настройки пользовательского интерфейса.

Библиотека предпочтений v7 добавляет поддержку интерфейсов, таких как Preference.OnPreferenceChangeListener и Preference.OnPreferenceClickListener , а также классов, таких как CheckBoxPreference и ListPreference .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:preference-v7:28.0.0

Библиотека поддержки v8

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

библиотека рендерскриптов v8

Эта библиотека добавляет поддержку вычислительного фреймворка RenderScript . Эти API включены в пакет android.support.v8.renderscript . Вам следует знать, что шаги по включению этих API в ваше приложение сильно отличаются от других API библиотек поддержки. Для получения дополнительной информации об использовании этих API в вашем приложении см. руководство разработчика RenderScript .

Примечание: использование RenderScript с библиотекой поддержки поддерживается в сборках Android Studio и Gradle. Библиотека renderscript находится в папке build-tools/$VERSION/renderscript/ .

В следующем примере показаны свойства скрипта сборки Gradle для этой библиотеки:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Библиотека поддержки v13

Эта библиотека добавляет поддержку шаблона пользовательского интерфейса Fragment с классом ( FragmentCompat ) и дополнительными классами поддержки фрагментов. Для получения дополнительной информации о фрагментах см. руководство разработчика Fragments . Для получения подробной информации об API библиотеки поддержки v13 см. пакет android.support.v13 в справочнике по API.

Примечание: Библиотека фрагментов v4 предоставляет класс Fragment . Класс Fragment v4 — это автономный класс, который предоставляет исправления ошибок, добавленные в более поздних версиях платформы, тогда как класс FragmentCompat v13 предоставляет прокладки совместимости для реализации фреймворка класса Fragment .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:support-v13:28.0.0

Библиотека поддержки предпочтений v14

Пакет android.support.v14.preference предоставляет API для добавления поддержки интерфейсов предпочтений, таких как PreferenceFragment.OnPreferenceStartFragmentCallback и PreferenceFragment.OnPreferenceStartScreenCallback , а также такие классы, как MultiSelectListPreference и PreferenceFragment . Подробную информацию об API-интерфейсах библиотеки поддержки предпочтений v14 см. в пакете предпочтений в справочнике по API.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:preference-v14:28.0.0

Библиотека поддержки предпочтений v17 для ТВ

Пакет android.support.v17.preference предоставляет API для предоставления интерфейсов предпочтений на ТВ-устройствах, включая поддержку интерфейса LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener и классов, таких как BaseLeanbackPreferenceFragment и LeanbackPreferenceFragment . Подробную информацию об API библиотеки поддержки предпочтений v17 см. в пакете предпочтений в справочнике по API.

Для этого пакета требуется API уровня 17 или выше. Идентификатор зависимости скрипта сборки Gradle для этой библиотеки следующий:

 com.android.support:preference-leanback-v17:28.0.0

v17 Библиотека Leanback

Пакет android.support.v17.leanback предоставляет API для поддержки создания пользовательских интерфейсов на ТВ-устройствах. Он предоставляет ряд важных виджетов для ТВ-приложений. Некоторые из примечательных классов включают:

BrowseFragment — фрагмент для создания основного макета для просмотра категорий и строк медиа-элементов.
DetailsFragment — фрагмент-оболочка для экранов сведений Leanback.
PlaybackOverlayFragment — подкласс DetailsFragment для отображения элементов управления воспроизведением и связанного содержимого.
SearchFragment — фрагмент для обработки поисков. Фрагмент получает поисковый запрос пользователя и передает его в SearchResultProvider , предоставленный приложением. SearchResultProvider возвращает результаты поиска в SearchFragment , который отображает их в RowsFragment .

com.android.support:leanback-v17:28.0.0

Библиотека векторной графики

Обеспечивает поддержку статической векторной графики.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:support-vector-drawable:28.0.0

Библиотека анимированных векторных рисунков

Обеспечивает поддержку анимированной векторной графики.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:animated-vector-drawable:28.0.0

Библиотека поддержки аннотаций

Пакет аннотаций предоставляет API-интерфейсы для поддержки добавления метаданных аннотаций в ваши приложения.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:support-annotations:28.0.0

Библиотека поддержки дизайна

Пакет Design предоставляет API-интерфейсы для поддержки добавления компонентов и шаблонов Material Design в ваши приложения.

Библиотека поддержки дизайна добавляет поддержку различных компонентов и шаблонов материального дизайна, на основе которых разработчики приложений могут создавать свои приложения, такие как навигационные панели, плавающие кнопки действий ( FAB ), снэк-бары и вкладки .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:design:28.0.0

Библиотека поддержки пользовательских вкладок

Пакет пользовательских вкладок предоставляет API-интерфейсы для поддержки добавления и управления пользовательскими вкладками в ваших приложениях.

Библиотека поддержки пользовательских вкладок добавляет поддержку различных классов, таких как Custom Tabs Service и Custom Tabs Callback .

Для этого пакета требуется API уровня 15 или выше. Идентификатор зависимости скрипта сборки Gradle для этой библиотеки следующий:

com.android.support:customtabs:28.0.0

Библиотека поддержки процентов

Пакет Percent предоставляет API для поддержки добавления и управления процентными измерениями в вашем приложении.

Примечание: Начиная с версии 26.0.0 библиотека Percent Support устарела. Клиенты этого модуля должны перейти на новый виджет ConstraintLayout , который предоставляется как отдельный артефакт в SDK Manager.

Библиотека Percent Support добавляет поддержку интерфейса PercentLayoutHelper.PercentLayoutParams и различных классов, таких как PercentFrameLayout и PercentRelativeLayout .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:percent:28.0.0

Библиотека поддержки ExifInterface

Теги Exif хранят информацию, такую как ориентация, дата и время, информация о камере и местоположение непосредственно в файле JPEG или RAW. Класс ExifInterface разделяет поддержку чтения информации Exif из файлов в формате JPEG и raw (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW и RAF) и установку информации Exif в файлах изображений JPEG.

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:exifinterface:28.0.0

Библиотека поддержки рекомендаций приложений для ТВ

Пакет рекомендаций приложений предоставляет API-интерфейсы для поддержки добавления рекомендаций по контенту в приложение, работающее на ТВ-устройствах.

Библиотека приложений добавляет поддержку аннотаций, таких как ContentRecommendation.ContentMaturity , и различных классов, таких как ContentRecommendation и RecommendationExtender .

Для этого пакета требуется API уровня 21 или выше. Идентификатор зависимости скрипта сборки Gradle для этой библиотеки следующий:

com.android.support:recommendation:28.0.0

Библиотека пользовательского интерфейса Wear

Эта библиотека имеет API для создания пользовательских интерфейсов для приложений Wear. API, доступные в пакете android.support.wear.widget , заменяют соответствующие API в библиотеке Wearable Support Library.

Более подробную информацию см. в разделе Использование библиотеки пользовательского интерфейса Wear .

Идентификатор зависимости скрипта сборки Gradle для этой библиотеки выглядит следующим образом:

com.android.support:wear:28.0.0