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

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

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

ПРИМЕЧАНИЕ. До поддержки пересмотра библиотеки 24.2.0 была одна библиотека поддержки V4. Эта библиотека была разделена на несколько модулей для повышения эффективности. Для обратной совместимости, если вы перечислите support-v4 в своем скрипте Gradle, ваше приложение будет включать все модули V4. Однако, чтобы уменьшить размер приложения, мы рекомендуем вам просто перечислить конкретные модули, которые нуждаются в вашем приложении.

V4 Compat Library

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

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

com.android.support:support-compat:28.0.0

V4 Core-Utils Library

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

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

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

V4 Core-UI Библиотека

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

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

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

V4 Media-Compat Library

Запальные порции медиа -фреймворка, включая MediaBrowser и MediaSession .

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

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

V4 Fragment Library

Добавляет поддержку инкапсуляции пользовательского интерфейса и функциональности с помощью фрагментов , позволяя приложениям предоставлять макеты, которые корректируются между устройствами для малых и крупных экранов. Этот модуль имеет зависимости от Compat , Core-Outils , Core-UI и Media-Compat .

Примечание. Библиотека поддержки V13 предоставляет класс FragmentCompat . Класс Fragment V4 - это автономный класс, который обеспечивает ошибки, которые были добавлены в более поздних версиях платформы, тогда как класс FragmentCompat V13 обеспечивает совместимость SLIM для реализации Fragment .

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

com.android.support:support-fragment:28.0.0

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

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

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

com.android.support:multidex:1.0.0

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

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

V7 AppCompat Библиотека часть Android JetPack .

Примечание. Библиотека AppCompat мигрировала в библиотеку Androidx , которая является компонентом Android JetPack . Посмотрите на это в приложении для демонстрации подсолнечника .

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

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

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

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

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

com.android.support:appcompat-v7:28.0.0

V7 CardView Library

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

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

com.android.support:cardview-v7:28.0.0

V7 Gridlayout Library

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

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

com.android.support:gridlayout-v7:28.0.0

V7 Mediarouter Library

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

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

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

com.android.support:mediarouter-v7:28.0.0

API -интерфейсы библиотеки Mediarouter V7, представленные в библиотеке поддержки R18, могут быть изменены в последующих пересмотрах библиотеки поддержки. В настоящее время мы рекомендуем использовать библиотеку только в связи с Google Capt .

V7 Palette Library

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

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

com.android.support:palette-v7:28.0.0

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

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

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

com.android.support:recyclerview-v7:28.0.0

V7 Предпочтения Библиотека поддержки

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

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

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

com.android.support:preference-v7:28.0.0

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

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

V8 renderscript Library

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

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

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

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

V13 БИБЛИОТЕКА ПОДДЕРЖКА

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

Примечание. Библиотека фрагментов V4 предоставляет класс Fragment . Класс Fragment V4 - это автономный класс, который обеспечивает ошибки, которые были добавлены в более поздних версиях платформы, тогда как класс FragmentCompat V13 обеспечивает совместимость SLIM для реализации Fragment .

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

com.android.support:support-v13:28.0.0

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

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

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

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 Build для этой библиотеки выглядит следующим образом:

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

V17 Leanback Library

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

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

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

com.android.support:leanback-v17:28.0.0

Векторная библиотека

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

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

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

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

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

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

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

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

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

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

com.android.support:support-annotations:28.0.0

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

Дизайн пакет предоставляет API для поддержки добавления компонентов и шаблонов дизайна материала в ваши приложения.

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

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

com.android.support:design:28.0.0

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

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

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

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

com.android.support:customtabs:28.0.0

Процентная библиотека поддержки

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

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

Библиотека поддержки в процентах добавляет поддержку интерфейса процентного интерфейса .

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

com.android.support:percent:28.0.0

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

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

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

com.android.support:exifinterface:28.0.0

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

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

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

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

com.android.support:recommendation:28.0.0

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

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

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

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

com.android.support:wear:28.0.0