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

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

Примечание. С выпуском библиотеки поддержки 28.0.0 библиотеки, упакованные в android.support , устарели и заменены библиотеками Jetpack с индивидуальной версией, упакованными как androidx . Первоначальный выпуск библиотек Jetpack 1.0.0 обеспечивает равенство с библиотекой поддержки 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-интерфейсов по сравнению с другими библиотеками, включая поддержку компонентов приложения, функций пользовательского интерфейса, специальных возможностей, обработки данных, сетевого подключения и утилит программирования.

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

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

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

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

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

com.android.support:support-compat:28.0.0

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

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

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

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

библиотека ядра v4

Реализует различные компоненты, связанные с пользовательским интерфейсом, такие как 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 .

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

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

com.android.support:support-fragment:28.0.0

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

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

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

com.android.support:multidex:1.0.0

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

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

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

Примечание. Библиотека appcompat мигрировала в библиотеку AndroidX , которая является компонентом Android Jetpack . Посмотрите, как это работает, в демо-приложении Sunflower .

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

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

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

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

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

com.android.support:appcompat-v7:28.0.0

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

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

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

com.android.support:cardview-v7:28.0.0

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

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

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

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

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

com.android.support:palette-v7:28.0.0

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

Библиотека 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 ) и дополнительных классов поддержки фрагментов. Дополнительные сведения о фрагментах см. в руководстве разработчика по фрагментам . Подробную информацию об API библиотеки поддержки версии 13 см. в пакете android.support.v13 в справочнике по API.

Примечание. Библиотека фрагментов версии 4 предоставляет класс Fragment . Класс Fragment версии 4 — это отдельный класс, который предоставляет исправления ошибок, которые были добавлены в более поздних версиях платформы, тогда как класс FragmentCompat версии 13 предоставляет прокладки совместимости для реализации класса 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

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

Пакет 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 в ваши приложения.

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

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

com.android.support:design:28.0.0

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

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

Библиотека поддержки пользовательских вкладок добавляет поддержку различных классов, таких как Служба пользовательских вкладок и Обратный вызов пользовательских вкладок .

Для этого пакета требуется уровень 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 и необработанных файлов (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 в библиотеке поддержки носимых устройств.

Дополнительные сведения см. в разделе Использование библиотеки пользовательского интерфейса Wear .

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

com.android.support:wear:28.0.0