Appcompat

Appcompat

Пример кода руководства пользователя

Справочник по API
androidx.appcompat.app
androidx.appcompat.content.res
androidx.appcompat.graphics.drawable
androidx.appcompat.view
androidx.appcompat.widget

Предоставляет доступ к новым API на старых версиях API платформы (многие используют Material Design).

Последнее обновление	Стабильный выпуск	Кандидат на выпуск	Бета-версия	Альфа-релиз
29 мая 2024 г.	1.7.0	-	-	-

Объявление зависимостей

Чтобы добавить зависимость от Appcompat, вам необходимо добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .

Добавьте зависимости для нужных вам артефактов в файл build.gradle для вашего приложения или модуля:

классный

dependencies {
    def appcompat_version = "1.7.0"

    implementation "androidx.appcompat:appcompat:$appcompat_version"
    // For loading and tinting drawables on older versions of the platform
    implementation "androidx.appcompat:appcompat-resources:$appcompat_version"
}

Котлин

dependencies {
    val appcompat_version = "1.7.0"

    implementation("androidx.appcompat:appcompat:$appcompat_version")
    // For loading and tinting drawables on older versions of the platform
    implementation("androidx.appcompat:appcompat-resources:$appcompat_version")
}

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

Обратная связь

Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.

Создать новую задачу

Дополнительную информацию см . в документации по системе отслеживания проблем .

Версия 1.7

Версия 1.7.0

29 мая 2024 г.

Выпущены androidx.appcompat:appcompat:1.7.0 и androidx.appcompat:appcompat-resources:1.7.0 . Версия 1.7.0 содержит эти коммиты .

Важные изменения с версии 1.6.0

• AppCompatDialog теперь правильно устанавливает LifecycleOwner , SavedStateRegistryOwner и OnBackPressedDispatcherOwner в представлении декора диалогового окна через API ViewTree , устраняя проблемы при размещении ComposeView внутри AppCompatDialog .
• AppCompatActivity теперь устанавливает ViewTreeOnBackPressedDispatcherOwner , чтобы можно было получить диспетчер из представления.
• Значительно улучшена производительность SupportMenuInflater .
• Locale.getDefault() теперь возвращает языковой стандарт системы после холодного запуска.
• LinearLayoutCompat теперь сохраняет параметры макета полей.

Обновления зависимостей

• AppCompat теперь зависит от Activity 1.7.0.
• AppCompat теперь зависит от версии Fragment 1.5.4.

Версия 1.7.0-rc01

14 мая 2024 г.

Выпущены androidx.appcompat:appcompat:1.7.0-rc01 и androidx.appcompat:appcompat-resources:1.7.0-rc01 . Версия 1.7.0-rc01 содержит эти коммиты .

Версия 1.7.0-бета01

1 мая 2024 г.

Выпущены androidx.appcompat:appcompat:1.7.0-beta01 и androidx.appcompat:appcompat-resources:1.7.0-beta01 . Версия 1.7.0-beta01 содержит эти коммиты .

Версия 1.7.0-альфа03

26 июля 2023 г.

Выпущены androidx.appcompat:appcompat:1.7.0-alpha03 и androidx.appcompat:appcompat-resources:1.7.0-alpha03 . Версия 1.7.0-alpha03 содержит эти коммиты.

Новые возможности

• Поддержка получения локалей для каждого приложения в контекстах, не связанных с действиями ( I58e753 ). Для этой функции были добавлены четыре новых API:

  • LocaleManagerCompat.getApplicationLocales() : позволяет разработчикам вывести локали для каждого приложения из области действия.

  • ContextCompat.getString() : возвращает локализованные строки на основе локалей для каждого приложения.

  • ContextCompat.getContextForLanguage() : контекст, возвращаемый этим методом, будет учитывать локали каждого приложения.

  • ConfigurationCompat.setLocales() : для вышеуказанных API для установки языкового стандарта конфигурации.

Другие изменения API

• Добавлен setLineHeight(unit, lineHeight) в классы совместимости TextView ( Ia9fa9 ).
• Добавлен setLineHeight(unit, lineHeight) в классы совместимости TextView ( Ib2ee1 ).
• Добавлен setLineHeight(unit, lineHeight) в классы совместимости TextView ( I15716 ).

Исправления ошибок

• AppCompatDialog теперь правильно устанавливает LifecycleOwner , SavedStateRegistryOwner и OnBackPressedDispatcherOwner в представлении декора диалогового окна через API ViewTree , устраняя проблемы при размещении ComposeView внутри AppCompatDialog . AppCompat теперь зависит от Activity 1.7.0. ( Ib28ab , b/261314581 )
• Значительно улучшить производительность SupportMenuInflater ( I0b087 ).

Версия 1.7.0-альфа02

8 февраля 2023 г.

Выпущены androidx.appcompat:appcompat:1.7.0-alpha02 и androidx.appcompat:appcompat-resources:1.7.0-alpha02 . Версия 1.7.0-alpha02 содержит эти коммиты.

Исправления ошибок

• Исправлена ​​утечка памяти в AppCompatDelegate.getLocaleManagerForApplication() ( 44b57fd ).
• AppCompat теперь зависит от версии фрагмента 1.5.4 ( I54dcd ).

Версия 1.7.0-альфа01

5 октября 2022 г.

Выпущены androidx.appcompat:appcompat:1.7.0-alpha01 и androidx.appcompat:appcompat-resources:1.7.0-alpha01 . Версия 1.7.0-alpha01 содержит эти коммиты.

Исправления ошибок

• AppCompatActivity теперь устанавливает ViewTreeOnBackPressedDispatcherOwner , чтобы можно было получить диспетчер из представления. ( I1a115 , б/235416503 )
• Locale.getDefault() теперь возвращает языковой стандарт системы после холодного запуска ( I6a94b ).
• LinearLayoutCompat теперь сохраняет параметры макета полей ( Id2af4 ).

Версия 1.6.1

Версия 1.6.1

8 февраля 2023 г.

androidx.appcompat:appcompat:1.6.1 и androidx.appcompat:appcompat-resources:1.6.1 выпущены. Версия 1.6.1 содержит эти коммиты.

Исправления ошибок

• Исправлена ​​утечка памяти в AppCompatDelegate.getLocaleManagerForApplication() ( 44b57fd ).

Версия 1.6.0

Версия 1.6.0

11 января 2023 г.

Выпущены androidx.appcompat:appcompat:1.6.0 и androidx.appcompat:appcompat-resources:1.6.0 . Версия 1.6.0 содержит эти коммиты.

Важные изменения с версии 1.5.0

• Добавлена ​​поддержка настройки локалей приложения. Дополнительные сведения см. в разделе AppCompatDelegate.setApplicationLocales(LocaleListCompat) . Обеспечивает обратную совместимость для нового API языковых настроек, доступного в Android 13.
• Обновления для поддержки нулевых значений для совместимости с SDK Android 13 (Тирамису, уровень API 33).
• Добавлены совместимые классы DrawableWrapper , DrawableContainer и StateListDrawable в общедоступную поверхность API.

Версия 1.6.0-rc01

7 сентября 2022 г.

Выпущены androidx.appcompat:appcompat:1.6.0-rc01 и androidx.appcompat:appcompat-resources:1.6.0-rc01 . Версия 1.6.0-rc01 содержит эти коммиты.

Исправления ошибок

• AppCompatActivity теперь устанавливает ViewTreeOnBackPressedDispatcherOwner , чтобы можно было получить диспетчер из представления. ( I1a115 , б/235416503 )
• Отменено исправление ошибки, которая перезаписывала конфигурацию, переданную в onConfigurationChanged , что вызывало проблемы для тестов, которые вводили свои собственные конфигурации через onConfigurationChanged .

Версия 1.6.0-бета01

10 августа 2022 г.

Выпущены androidx.appcompat:appcompat:1.6.0-beta01 и androidx.appcompat:appcompat-resources:1.6.0-beta01 . Версия 1.6.0-beta01 содержит эти коммиты.

Изменения API

• Переместите совместимые классы DrawableWrapper , DrawableContainer и StateListDrawable в общедоступный API. ( I37f3e , б / 227789566 )
• Представляет новую фабрику для асинхронного надувателя макета. ( Ia657b )

Исправления ошибок

• Toolbar теперь будет вызывать onPrepareMenu() перед отображением меню, а не безоговорочно при его создании. ( I2a58d , б/232206677 )
• AppCompat теперь явно зависит от Lifecycle 2.5.1 и SavedState 1.2.0 . ( I7e3e2 )
• Добавлена ​​поддержка обратного вызова AppCompatDelegate и реализации панели инструментов, предоставляемой AppCompat . ( I24062 )
• Завершение API AppCompat для 1.5.0-beta01 ( I2a43d , b/236866227 )
• Завершение API AppCompat для 1.5.0-beta01 ( I2a43d , b/236866227 )

Версия 1.6.0-альфа05

15 июня 2022 г.

Выпущены androidx.appcompat:appcompat:1.6.0-alpha05 и androidx.appcompat:appcompat-resources:1.6.0-alpha05 . Версия 1.6.0-alpha05 была разработана в частной предварительной версии и не содержит публичных коммитов.

Изменения API

• Обновления обнуляемости для приведения в соответствие с окончательной версией API в Tiramisu Beta 3 SDK.
• minCompileSdk теперь равен 33, чтобы соответствовать Tiramisu Beta 3 SDK.

Версия 1.6.0-альфа04

18 мая 2022 г.

Выпущены androidx.appcompat:appcompat:1.6.0-alpha04 и androidx.appcompat:appcompat-resources:1.6.0-alpha04 . Эта библиотека была разработана для частной предварительной версии, поэтому журнал коммитов недоступен.

Изменения API

• Добавьте API для отмены ограничения ширины SwitchCompat для использования MDC-Android.

Исправления ошибок

• Избегайте управляемой конфигурации, когда конфигурация изменяется за пределами AttachBaseConfig.

Версия 1.6.0-альфа03

27 апреля 2022 г.

Выпущены androidx.appcompat:appcompat:1.6.0-alpha03 и androidx.appcompat:appcompat-resources:1.6.0-alpha03 .

Для компиляции этой версии требуется Android 13 Beta 1, и ее совместимость с будущими предварительными версиями для разработчиков не гарантируется.

Новые возможности

• Поддержка выбора пользовательского языка для всего приложения с помощью AppCompatDelegate.setApplicationLocales() . Делегирует реализацию платформы на API 33 и выше.

Версия 1.6.0-альфа01

23 февраля 2022 г.

Выпущены androidx.appcompat:appcompat:1.6.0-alpha01 и androidx.appcompat:appcompat-resources:1.6.0-alpha01 . Версия 1.6.0-alpha01 была собрана из внутренней ветки и не имеет общедоступных коммитов.

Для компиляции этой версии требуется Android Tiramisu DP1, и ее совместимость с будущими предварительными версиями для разработчиков не гарантируется.

Новые возможности

• Добавлена ​​поддержка настройки локалей приложения. Дополнительные сведения см. в разделе AppCompatDelegate.setApplicationLocales(LocaleListCompat) . Обеспечивает обратную совместимость для нового API языковых настроек, доступного в Android 13.

Версия 1.5.1

Версия 1.5.1

7 сентября 2022 г.

androidx.appcompat:appcompat:1.5.1 и androidx.appcompat:appcompat-resources:1.5.1 выпущены. Версия 1.5.1 содержит эти коммиты.

Обновления зависимостей

• AppCompat теперь явно зависит от Lifecycle 2.5.1 и SavedState 1.2.0 . ( I7e3e2 )

Версия 1.5.0

Версия 1.5.0

10 августа 2022 г.

Выпущены androidx.appcompat:appcompat:1.5.0 и androidx.appcompat:appcompat-resources:1.5.0 . Версия 1.5.0 содержит эти коммиты.

Важные изменения с версии 1.4.0

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

Версия 1.5.0-rc01

27 июля 2022 г.

Выпущены androidx.appcompat:appcompat:1.5.0-rc01 и androidx.appcompat:appcompat-resources:1.5.0-rc01 . Версия 1.5.0-rc01 содержит эти коммиты.

Исправления ошибок

• Устраняет проблему, из-за которой оболочка контекста AppCompat повторно использовала реализацию резервного ресурса контекста приложения, в результате чего uiMode перезаписывался в контексте приложения. ( Idf9d5 )

Версия 1.5.0-бета01

13 июля 2022 г.

Выпущены androidx.appcompat:appcompat:1.5.0-beta01 и androidx.appcompat:appcompat-resources:1.5.0-beta01 . Версия 1.5.0-beta01 содержит эти коммиты.

Изменения API

• Добавьте переопределяемый флаг, чтобы отключить регулировку ширины переключателя по умолчанию. ( I37cb7 )
• Добавьте аннотацию @FloatRange в API получения положения ползунка ( If524c )
• Добавьте отсутствующие аннотации об отсутствии значений в AnimatedStateListDrawableCompat ( Ieb4ec ).

Исправления ошибок

• Завершение API AppCompat для 1.5.0-beta01 ( I2a43d , b/236866227 )
• Изменение значения className для ActionMenuItemView , чтобы оно рассматривалось как Button ( I5ee1c )

Версия 1.5.0-альфа01

6 апреля 2022 г.

Выпущены androidx.appcompat:appcompat:1.5.0-alpha01 и androidx.appcompat:appcompat-resources:1.5.0-alpha01 . Версия 1.5.0-alpha01 содержит эти коммиты.

Изменения API

• Добавлен новый API для предоставления подклассам положения ползунка переключателя ( I9bfb4 ).
• Обновлена ​​возможность обнуления для соответствия Тирамису DP2 ( I0cbb7 ).
• Перенесено составное прорисовываемое окрашивание в виджеты, производные от TextView ( Idf98c , b/165822337 ).
• AppCompatDialog теперь расширяет ComponentDialog для совместимости с OnBackPressedDispatcher ( Id9b91 , b/217620781 ).
• SearchView.onQueryRefine() теперь имеет защищенную видимость, позволяющую переопределять ( I6cce0 , b/212882845 ).

Исправления ошибок

• Toolbar AppCompat теперь вызывает API onPrepareMenu() MenuHostHelper . ( I9b9b5 , б/227376894 )
• AppCompatEditText , AppCompatAutoCompleteEditText , AppCompatMultiAutoCompleteEditText больше не сбрасывает кликабельность или longClickable в конструкторе, если они установлены в XML ( Ic5066 , b/221094907 ).
• AppCompatEditText , AppCompatAutoCompleteTextView и AppCompatMultiAutoCompleteTextView не будут вызывать переопределенный setKeyListener во время конструктора ( I5c13a , b/208480173 ).
• Appcompat не будет обертывать экземпляры NumberKeyListener , переданные в setKeyListener , что позволяет TextView правильно настроить локаль в NumberKeyListeners ( Ibf113 , b/207119921 ).
• Исправлена ​​проблема со всеми подклассами NumberKeyListener представленными в AppCompat 1.4.0, которая позволяла вводить неожиданные символы, такие как знаки препинания ( Iede7a , b/207119921 ).

Версия 1.4.2

Версия 1.4.2

1 июня 2022 г.

androidx.appcompat:appcompat:1.4.2 и androidx.appcompat:appcompat-resources:1.4.2 выпущены. Версия 1.4.2 содержит эти коммиты.

Исправления ошибок

• Исправлен сбой, при котором AppCompatDelegateImpl выполнял внутренний вызов ensureSubDecor перед созданием панели действий ( aosp/2048349 , b/226648941 ).

Версия 1.4.1

12 января 2022 г.

androidx.appcompat:appcompat:1.4.1 и androidx.appcompat:appcompat-resources:1.4.1 выпущены. Версия 1.4.1 содержит эти коммиты.

Исправления ошибок

• AppCompatEditText , AppCompatAutoCompleteTextView и AppCompatMultiAutoCompleteTextView не будут вызывать переопределенный setKeyListener во время работы конструктора. ( I5c13a , б / 208480173 )
• Emoji2 не будет обертывать экземпляры NumberKeyListener , позволяя настраивать локаль с помощью текстового представления.
  • Appcompat не будет обертывать экземпляры NumberKeyListener переданные в setKeyListener , что позволяет TextView правильно настроить локаль в NumberKeyListeners . ( Ibf113 , б/207119921 )
• Устранена проблема со всеми подклассами NumberKeyListener , представленными в appcompat 1.4.0, которые позволяли вводить неожиданные символы, такие как знаки препинания (b/207119921) ( Iede7a , b/207119921 ).

Версия 1.4.0

Версия 1.4.0

17 ноября 2021 г.

Выпущены androidx.appcompat:appcompat:1.4.0 и androidx.appcompat:appcompat-resources:1.4.0 . Версия 1.4.0 содержит эти коммиты.

Важные изменения с версии 1.3.0

• Библиотека теперь ориентирована на уровень языка Java 8.
• Поддержка обновляемых эмодзи включена по умолчанию через библиотеку androidx.emoji2.
• Улучшена проверка атрибутов в инспекторе макетов Android Studio ( I02d55 ).
• Добавлена ​​поддержка вложенных тонированных ресурсов и векторных изображений в бэкпортах загрузки ресурсов AppCompat. Однако обратите внимание, что это означает, что приложения не могут переопределить getDrawable() для пользовательского объекта Resources, если включены бэкпорты. ( Ia6b03 , б/176129022 )
• Перенесенный тонируемый фон и галочка для CheckedTextView ( I8575c )

Версия 1.4.0-rc01

27 октября 2021 г.

Выпущены androidx.appcompat:appcompat:1.4.0-rc01 и androidx.appcompat:appcompat-resources:1.4.0-rc01 . Версия 1.4.0-rc01 содержит эти коммиты.

Версия 1.4.0-бета01

29 сентября 2021 г.

Выпущены androidx.appcompat:appcompat:1.4.0-beta01 и androidx.appcompat:appcompat-resources:1.4.0-beta01 . Версия 1.4.0-beta01 содержит эти коммиты.

Изменения API

• Toolbar AndroidX AppCompat теперь является MenuHost и может управлять MenuProvider . ( I5cd95 )

Исправления ошибок

• Исправлена ​​обработка AppCompatProgressBar индикаторов выполнения списка слоев ( I6ece3 , b/142004509 ).
• Правильно сохраняйте android:digits в AppCompatEditText . Это исправляет ошибку 193047889, появившуюся в AppCompat 1.4.0-alpha03. ( I4b4fc , б/193047889 )
• Интегрированный SDK OnReceiveContentListener и поддержка API-интерфейсов lib. ( Ic6914 , б/173814913 )

Версия 1.4.0-альфа03

30 июня 2021 г.

Выпущены androidx.appcompat:appcompat:1.4.0-alpha03 и androidx.appcompat:appcompat-resources:1.4.0-alpha03 . Версия 1.4.0-alpha03 содержит эти коммиты.

Новые возможности

• Библиотека теперь ориентирована на уровень языка Java 8.
• Добавьте поддержку emoji2 для большего количества подклассов TextView ( AppCompatMultiAutoCompleteTextView , AppCompatAutoCompleteTextView , AppCompatRadioButton , AppCompatCheckBox ).

Изменения API

• Добавлен API для настройки InputConnection для использования View.performReceiveContent для обработки вызовов IME к InputConnection.commitContent. ( I3a2ad )
• Добавить поддержку EmojiCompat в AppCompatMultiAutoCompleteTextView ( Ifece0 ).
• Добавить поддержку EmojiCompat в AppCompatAutoCompleteTextView ( Ia1f4b ).
• Добавьте поддержку EmojiCompat в AppCompatRadioButton ( If08af ).
• Добавьте поддержку EmojiCompat в AppCompatCheckBox ( I2b3bc ).
• Разрешить нулевой KeyListener в AppCompatEditText . Это отменяет ненулевую аннотацию, которая была добавлена ​​в AppCompatEditText в версии 1.4-alpha01, и восстанавливает предыдущее поведение при передаче значения null. ( I21482 , б / 189559345 )
• Добавьте PopupMenu.setForceShowIcon для контроля четности с API платформы ( I43bb3 , b/182789798 ).

Исправления ошибок

• Исправьте ошибку в AppCompatEditText, из-за которой входной тип, указанный в XML, будет сброшен, чтобы удалить варианты. Эта ошибка появилась в AppCompat 1.4.0-alpha01. ( I9df36 , б/191061070 )

Версия 1.4.0-альфа02

2 июня 2021 г.

Выпущены androidx.appcompat:appcompat:1.4.0-alpha02 и androidx.appcompat:appcompat-resources:1.4.0-alpha02 . Версия 1.4.0-alpha02 содержит эти коммиты.

Изменения API

• Добавлен конструктор AppCompatDialogFragment , который принимает идентификатор макета ( Icbf22 , b/188119987 ).
• Улучшенная поддержка инспектора макета ( I02d55 ).
• Пакет в emoji2-views-helper переименован в androidx.emoji2.viewsintegration . Это критическое изменение для AppCompat 1.4.0-alpha01 , и приложения должны обеспечить обновление зависимости AppCompat для использования новой версии emoji2. ( Ie8397 )

Исправления ошибок

• Исправлена ​​проблема, из-за которой остановленные действия не получали изменения конфигурации из-за изменений ночного режима, реализованных с помощью AppCompat. ( I8fa8f , б / 188681415 )
• Исправлена ​​ошибка в AppCompatEditText , из-за которой представления могли быть фокусируемыми, даже если в xml был указан android:focusable="false" (ошибка появилась в AppCompat 1.4.0-alpha01 ) ( Ib9412 ).

Версия 1.4.0-альфа01

18 мая 2021 г.

Выпущены androidx.appcompat:appcompat:1.4.0-alpha01 и androidx.appcompat:appcompat-resources:1.4.0-alpha01 . Версия 1.4.0-alpha01 содержит эти коммиты.

Изменения API

• Интегрированная поддержка EmojiCompat для различных виджетов AppCompat ( Id409b , If7a1a , Ic262d , Ib5f4a , I4fb3c ).
• Добавлена ​​поддержка вложенных тонированных ресурсов и векторных изображений в бэкпортах загрузки ресурсов AppCompat. Однако обратите внимание, что это означает, что приложения не могут переопределить getDrawable() для пользовательского объекта Resources, если включены бэкпорты. ( Ia6b03 , б/176129022 )
• Улучшенная поддержка инспектора макета ( I6d771 ).

Исправления ошибок

• Исправлен сценарий, при котором вызов setSupportActionBar после установки обратного вызова окна перезаписывал обратный вызов. ( Ie43ee , б/186791590 )
• Добавлен обходной путь для проблемы в SDK 29 и 30, из-за которой ресурсы ColorStateListDrawable, клонированные из кэша с возможностью рисования, не загружают цвет по умолчанию до тех пор, пока не получат изменение состояния. ( Iedb4b )
• Избегайте NPE при обработке нулевых обратных вызовов режима действия пользовательского выбора в представлениях, поддерживаемых AppCompat. ( I033c7 , б/173435375 )

Обновления зависимостей

• Из AppCompat 1.5.0 : AppCompat теперь зависит от Fragment Fragment 1.3.4 . ( I13089 )
• Начиная с AppCompat 1.5.0 : AppCompat теперь зависит от действия 1.2.3 . ( I815b7 )
• Из AppCompat 1.5.0 : AppCompat теперь зависит от жизненного цикла 2.3.1 . ( Я75а1 )

Внешний вклад

• Backport тонируемого фона и флажок для CheckedTextView ( I8575c )

Версия 1.3.1

Версия 1.3.1

21 июля 2021 г.

androidx.appcompat:appcompat:1.3.1 и androidx.appcompat:appcompat-resources:1.3.1 выпущены. Версия 1.3.1 содержит эти коммиты.

Обновления зависимостей

• AppCompat теперь зависит от Activity 1.2.4 и Fragment 1.3.6 , поэтому исправления из этих выпусков включены по умолчанию при использовании AppCompat 1.3.1 . ( I8fbec )

Версия 1.3.0

Версия 1.3.0

18 мая 2021 г.

Выпущены androidx.appcompat:appcompat:1.3.0 и androidx.appcompat:appcompat-resources:1.3.0 . Версия 1.3.0 содержит эти коммиты.

Важные изменения с версии 1.2.0

• Исправлено распространение атрибутов android:theme в макетах <include> d на устройствах до Lollipop.
• Уменьшен размер библиотеки за счет преобразования многих ресурсов PNG в VectorDrawables.
• Добавлена ​​поддержка событий перетаскивания в AppCompatEditText с помощью OnReceiveContentListener
• Обновлено для поддержки изменений в обработке вставок окон Android 11.
• Добавлена ​​поддержка RTL в пунктах меню со значками.

• Добавлена ​​поддержка вставки расширенного контента (например, вставки изображения) в AppCompatEditText

• Обновленные зависимости : appcompat обновил многие из своих транзитивных зависимостей для поддержки новых функций и исправлений:

  • Обновлено с фрагмента 1.1.0 до фрагмента 1.3.4
  • Обновлено с Действия 1.0.0 до Действия 1.2.3
  • Обновлен с жизненного цикла 2.0.0 до жизненного цикла 2.3.1 .
  • Обновлено с Core 1.3.0 до Core 1.5.0

Версия 1.3.0-rc01

24 марта 2021 г.

Выпущены androidx.appcompat:appcompat:1.3.0-rc01 и androidx.appcompat:appcompat-resources:1.3.0-rc01 . Версия 1.3.0-rc01 содержит эти коммиты.

Исправления ошибок

• Предотвращает преждевременный отзыв разрешений при обработке вставки содержимого IME.

Обновления зависимостей

• AppCompat теперь зависит от Activity 1.2.2 , Fragment 1.3.2 и Lifecycle 2.3.1 . ( Я75а1 )

Внешний вклад

• Исправлено распространение атрибута android:theme в макетах <include> d на устройствах до Lollipop (Саймон Бергнер из Opera).

Версия 1.3.0-бета01

13 января 2021 г.

Выпущены androidx.appcompat:appcompat:1.3.0-beta01 и androidx.appcompat:appcompat-resources:1.3.0-beta01 . Версия 1.3.0-beta01 содержит эти коммиты.

Новые возможности

• Рисуемые элементы режима действий на уровне темы были заменены векторными источниками. Это может привести к небольшим изменениям внешнего вида отдельных значков. ( I741a6 )

Изменения API

• Интегрированное перетаскивание (события перетаскивания) в AppCompatEditText с помощью OnReceiveContentListener. ( Ib26c9 , б/175343405 )
• Обновлен OnReceiveContentListener и связанные API. Дополнительную информацию см. в изменениях в библиотеке androidx.core. ( Ib4616 , б/173814913 )
• Виджет.RichContentReceiverCompat перемещен в view.OnReceiveContentListener. ( Ifdab7 , б / 173814913 )
• API для предоставления и получения исходного окружающего текста были перенесены в EditorInfoCompat . Они позволяют приложениям IME избежать дополнительной задержки IPC. ( Ie3809 )

Версия 1.3.0-альфа02

19 августа 2020 г.

Выпущены androidx.appcompat:appcompat:1.3.0-alpha02 и androidx.appcompat:appcompat-resources:1.3.0-alpha02 . Версия 1.3.0-alpha02 содержит эти коммиты.

Исправления ошибок

• Изображения AppCompatRatingBar PNG были заменены векторными источниками. Это может вызвать небольшие изменения во внешнем виде отдельных звезд. ( I6b99d )
• Обновление WindowInsetsCompat для API Android 11 ( I3df9e )
• Поддержка RTL в пунктах меню с иконками ( I2f5c5 )

Обновления зависимостей

• AppCompat обновил свою зависимость с Fragment 1.1.0 до Fragment 1.3.0-alpha08 . Настоятельно рекомендуется прочитать примечания к выпуску Fragment 1.2.0 , чтобы понять основные изменения, внесенные в предыдущий выпуск Fragment.
• AppCompat обновил свою зависимость с Activity 1.0.0 до Activity 1.2.0-alpha08 . Настоятельно рекомендуется прочитать примечания к выпуску Activity 1.1.0 , чтобы понять основные изменения, представленные в предыдущем выпуске Activity.
  • AppCompatActivity теперь использует API OnContextAvailableListener представленный в действии 1.2.0-alpha08 для настройки AppCompatDelegate . Любые прослушиватели, добавленные в подклассы AppCompatActivity будут запускаться после этого прослушивателя. ( I513da )

Версия 1.3.0-альфа01

20 мая 2020 г.

Выпущены androidx.appcompat:appcompat:1.3.0-alpha01 и androidx.appcompat:appcompat-resources:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит эти коммиты.

Новые возможности

• Добавьте новое правило Lint, чтобы помечать вызовы setActionBar для действий, расширяющих AppCompatActivity.
• Добавлена ​​поддержка ViewTreeLifecycleOwner из Lifecycle 2.3.0-alpha01 , ViewTreeViewModelStoreOwner из Lifecycle 2.3.0-alpha03 и ViewTreeSavedStateRegistryOwner из SavedState 1.1.0-alpha01 при использовании View в AppCompatActivity . ( б/151603528 , аосп/1300264 )
• Добавьте общий API для вставки расширенного контента (например, вставки изображения). Новый обратный вызов предоставляет единый API, который приложения могут реализовать для поддержки различных способов вставки расширенного контента. На данный момент API добавлен только в AppCompatEditText и будет вызываться для следующих путей кода:
  • вставить из буфера обмена
  • вставка контента из IME ( InputConnection.commitContent ) ( I22bf7 )

Исправления ошибок

• Из AppCompat 1.2.0-rc01 : AppCompat больше не вызывает onMenuOpened() с null меню. ( б / 142843126 )
• Правильное разрешение цветов текстовых ссылок и подсказок на старых устройствах, когда TextViewCompat.setTextAppearance вызывается со стилем внешнего вида текста, имеющим списки состояний цвета, которые ссылаются на атрибуты цвета темы ( b/154702995 ).

Версия 1.2.0

Версия 1.2.0

5 августа 2020 г.

Выпущены androidx.appcompat:appcompat:1.2.0 и androidx.appcompat:appcompat-resources:1.2.0 . Версия 1.2.0 содержит эти коммиты.

Основные изменения с версии 1.1.0

• Исправлена ​​поддержка вариантов использования переопределения конфигурации, включая пользовательские локали и масштабы шрифтов. См. здесь пример того, как правильно реализовать переопределения с помощью appcompat:1.2.0 .
• Устаревший AppCompatDelegate.attachBaseContext() . Если вы вызываете или переопределяете этот метод, используйте вместо него AppCompatDelegate.attachBaseContext2() .
• Устаревший CollapsibleActionView . Этот интерфейс больше не нужен, используйте интерфейс android.view.CollapsibleActionView , предоставляемый платформой.

Версия 1.2.0-rc02

22 июля 2020 г.

androidx.appcompat:appcompat:1.2.0-rc02 и androidx.appcompat:appcompat-resources:1.2.0-rc02 выпущены. Версия 1.2.0-rc02 содержит эти коммиты.

Исправления ошибок

• Исправлена ​​проблема, связанная с ночным режимом, из-за которой при вызове AppCompatDelegate.setDefaultNightMode из диалогового окна иногда не удавалось воссоздать действия и применить новый режим. ( аосп/1348308 , б/158923881 )

Версия 1.2.0-rc01

14 мая 2020 г.

androidx.appcompat:appcompat:1.2.0-rc01 и androidx.appcompat:appcompat-resources:1.2.0-rc01 выпущены. Версия 1.2.0-rc01 содержит эти коммиты.

Изменения API

• AppCompatDelegate.setLocalNightMode помечен как требующий SDK версии 17 или выше из-за проблемы с платформой, связанной с утечкой изменений конфигурации между действиями в более ранних SDK.

Исправления ошибок

• AppCompatDelegate.setLocalNightMode теперь можно вызывать до Activity.attachBaseContext
• Исправлено потребление вставок ActionBarOverlayLayout , при котором неправильно использовались кэшированные вставки.
• AppCompat больше не вызывает onMenuOpened() с null меню. ( б / 142843126 )

Версия 1.2.0-бета01

1 апреля 2020 г.

Выпущены androidx.appcompat:appcompat:1.2.0-beta01 и androidx.appcompat:appcompat-resources:1.2.0-beta01 . Версия 1.2.0-beta01 содержит эти коммиты.

Новые возможности

• Добавлены следующие новые правила проверки, которые будут отмечать неправильное использование AppCompat в следующих сценариях:
  • Загрузка списков состояний цвета: предлагает использовать API ContextCompat и AppCompatResources для обратной совместимости.
  • Загрузка чертежей: предлагает использовать API-интерфейсы ContextCompat и ResourcesCompat для обратной совместимости.
  • Использование списков состояний цвета с атрибутом альфа: отмечается отсутствие атрибута android:alpha , что приведет к некорректному отображению на некоторых версиях платформы.
  • Тонировка изображений: флаги, не использующие app:tint , что приведет к некорректному отображению на старых версиях платформы.
  • Использование составных рисунков и тонирования в текстовых представлениях: предлагает использовать атрибуты совместимости и API-интерфейсы для обратной совместимости.

Исправления ошибок

• Исправлена ​​проблема, из-за которой ActionBarOverlayLayout (действие оформления окна) некорректно отправляло WindowInsets.
• Исправлены проблемы с оттенком прорисовки и внешним видом текста в старых версиях платформы.
• Исправлена ​​проблема, из-за которой androidx.appcompat:appcompat:1.1.0 приводил к сбою веб-просмотра при длительном нажатии веб-просмотра ( b/141351441 ).
• Реализованы исправления проблем с манипулированием базовым контекстом и получением системных служб во время запуска активности.

Версия 1.2.0-альфа03

4 марта 2020 г.

Выпущены androidx.appcompat:appcompat:1.2.0-alpha03 и androidx.appcompat:appcompat-resources:1.2.0-alpha03 . Версия 1.2.0-alpha03 содержит эти коммиты.

Исправления ошибок

• Исправлена ​​проблема, из-за которой индикатор состояния режима действия ошибочно выходил на панель навигации и имел неправильный цвет ( Ia4a09 ).
• Исправлена ​​проблема, из-за которой остановленные действия не возобновлялись на уровне API 23 и ниже ( I45201 ).

Версия 1.2.0-альфа02

29 января 2020 г.

Выпущены androidx.appcompat:appcompat:1.2.0-alpha02 и androidx.appcompat:appcompat-resources:1.2.0-alpha02 . Версия 1.2.0-alpha02 содержит эти коммиты .

Исправления ошибок

• Исправлена ​​проблема, из-за которой appcompat 1.1.0 приводил к сбою веб-просмотра при длительном нажатии ( b/141351441 ).
• Исправлена ​​возможность рисования в TextView относительно составных рисунков на уровне API 23 ( aosp/1172194 ).
• Обеспечено, что базовый контекст всегда является оболочкой ( aosp/1194355 ).
• Добавлены некоторые улучшения, позволяющие более разумно изменять конфигурацию базового контекста ( aosp/1204543 ).
• Отключено createConfigurationContext() для Robolectric ( aosp/1186218 ).

Версия 1.2.0-альфа01

4 декабря 2019 г.

Выпущены androidx.appcompat:appcompat:1.2.0-alpha01 и androidx.appcompat:appcompat-resources:1.2.0-alpha01 . Версия 1.2.0-alpha01 содержит эти коммиты .

Исправления ошибок

• Вызовы PackageManager.getActivityInfo больше не приводят к сбою в строгом режиме с включенными проверками загрузки.
• Исправления для тонирования рисунков в AppCompatButton.
• Исправления оттенка и внешнего вида текста в старых версиях платформы.

Версия 1.1.0

Версия 1.1.0

5 сентября 2019 г.

Выпущены androidx.appcompat:appcompat:1.1.0 и androidx.appcompat:appcompat-resources:1.1.0 . Коммиты, включенные в эту версию, можно найти здесь .

Важные изменения с версии 1.0.0

• Улучшения темного режима : MODE_NIGHT_AUTO и переключение темного/светлого режима в зависимости от текущего времени больше не поддерживаются. Учитывая использование явной настройки или MODE_NIGHT_AUTO_BATTERY .
• Действие 1.0 : AppCompatActivity теперь транзитивно расширяется от ComponentActivity от действия 1.0.0 через фрагмент 1.1.0 . Информацию об изменениях в каждой библиотеке см. в соответствующих примечаниях к выпуску.
• Конструктор AppCompatActivity LayoutId : подклассы AppCompatActivity теперь могут дополнительно вызывать конструктор AppCompatActivity , который принимает идентификатор R.layout , указывающий макет, который должен быть установлен в качестве представления содержимого в качестве альтернативы вызову setContentView() в onCreate() . Это не меняет требования, чтобы у вашего подкласса был конструктор без аргументов.

Версия 1.1.0-rc01

2 июля 2019 г.

androidx.appcompat:appcompat:1.1.0-rc01 и androidx.appcompat:appcompat-resources:1.1.0-rc01 выпущены. Коммиты, включенные в эту версию, можно найти здесь .

Примечание. Эта версия будет компилироваться только с Q Beta 4 SDK.

Исправления ошибок

• DayNight теперь правильно учитывает configChanges ( aosp/981105 ).
• Вызов onConfigurationChanged только для запущенных действий ( aosp/987483 )

Версия 1.1.0-бета01

5 июня 2019 г.

Выпущены androidx.appcompat:appcompat:1.1.0-beta01 и androidx.appcompat:appcompat-resources:1.1.0-beta01 . Коммиты, включенные в эту версию, можно найти здесь .

Исправления ошибок

• Убедитесь, что мы очистили получатели в AppCompatDialogs ( aosp/959376 ).
• Добавить поддержку buttonGravity=center_vertical на панели инструментов ( b/130361721 ).
• Исправить горизонтальное смещение счетчика ( b/79477181 )

Версия 1.1.0-альфа05

7 мая 2019 г.

Выпущены androidx.appcompat:appcompat:1.1.0-alpha05 и androidx.appcompat:appcompat-resources:1.1.0-alpha05 . Коммиты, включенные в эту версию, можно найти здесь .

Новые возможности

• setDefaultNightMode() теперь автоматически воссоздает все запущенные действия.

Исправления ошибок

• Различные исправления режима DayNight.
• Недействительный контур при любом изменении фона в ActionBar
• Исправить прокрутку виджета Spinner
• Исправлена ​​ошибка, из-за которой фон окна пользовательского набора переопределялся в AlertDialog.

Версия 1.1.0-альфа04

3 апреля 2019 г.

Выпущены androidx.appcompat:appcompat:1.1.0-alpha04 и androidx.appcompat:appcompat-resources:1.1.0-alpha04 . Коммиты, включенные в эту версию, можно найти здесь .

Новые возможности

• Добавлено новое семейство тем ThemeOverlay.AppCompat.DayNight . Их следует использовать при использовании функции DayNight.

Изменения API

• AppCompatActivity теперь содержит второй конструктор, который принимает @LayoutRes int , который заменяет предыдущее поведение аннотирования вашего класса AppCompatActivity с помощью @ContentView . Этот подход работает как в приложениях, так и в модулях библиотеки. ( б / 128352521 )

Исправления ошибок

• Закрепил внутренние зависимости к стабильным версиям, где это возможно.
• Исправлена ​​прокрутка AppCompatSpinner в раскрывающемся режиме) b/124274573 )
• Вызывает applyOverrideConfiguration() только в том случае, если это необходимо для DayNight.

Версия 1.1.0-альфа03

13 марта 2019 г.

Выпущены androidx.appcompat:appcompat:1.1.0-alpha03 и androidx.appcompat:appcompat-resources:1.1.0-alpha03 . Это первый выпуск appcompat-resources . Полный список коммитов, включённых в эту версию, можно найти здесь .

Новые возможности

• Новая библиотека appcompat-resources содержит API, которые позволяют приложениям загружать и окрашивать объекты рисования (включая векторные объекты) в старых версиях платформы. Это та же функциональность, которая ранее была частью модуля appcompat, но теперь доступна без накладных расходов на полную поддержку AppCompat Material Design, которая включает виджеты, диалоги, ночной режим и т. д.
• Основные исправления в поддержке режима DayNight.
• Новая опция MODE_NIGHT_AUTO_BATTERY для режима DayNight.
• Рисуемая тонировка в AppCompatTextView
• Переполнение панели инструментов теперь можно стилизовать с помощью тематических списков состояний цвета.
• Значки меню теперь могут использовать цвета, соответствующие атрибутам темы.
• Новый атрибут app:menu можно установить на панели инструментов, чтобы отображать содержимое меню во время инфляции.

Исправления ошибок

• Исправлен режим оттенка по умолчанию в ImageView в версии 21.
• Исправлено неправильное закрытие всплывающего окна счетчика при повороте устройства.
• Исправлена ​​ошибка, из-за которой DayNight не учитывает configChanges в манифесте.
• Исправлено неработающее переключение на MODE_NIGHT_FOLLOW_SYSTEM ( b/111345020 ).
• Исправлен WebView, сбрасывающий ресурсы DayNight ( b/37124582 ).

Версия 1.1.0-альфа02

7 февраля 2019 г.

androidx.appcompat:appcompat 1.1.0-alpha02 выпущен.

Новые возможности

• Извлеченная обработка рисования для конкретного ресурса в перехватчик ( aosp/870976 )
• Разрешенная панель инструментов titleTextColor и subtitleTextColor для использования ColorStateList и добавленных перегрузки ColorStateList в методах setTitleTextColor и setSubtitleTextColor ( AOSP/867489 )

Исправления ошибок

• Фиксированная fontFamily не работает над Pre API 24 ( AOSP/807054 )
• Исправлена ​​ошибка, в которой textFontWeight не работал, когда деятельность простирается от AppCompatActivity ( AOSP/847640 )
• Исправлена ​​ошибка, которая вызвала текст заголовка во всплывающем окне «Виджет спиннера» (при использовании диалогового режима), чтобы не использовать шрифт, указанный в fontFamily ( AOSP/789994 )
• Исправьте ошибку, которая не позволяла виджетам AppCompatCheckBox и AppCompatRadioButton , чтобы изменить фоновый оттенок ( AOSP/825160 )
• Исправлена ​​ошибка, где AppCompat не переопределял android: list styles ( AOSP/862350 )

Версия 1.1.0-Alpha01

3 декабря 2018 г.

Новые возможности

• AppCompatTextView теперь поддерживает app:drawableLeftCompat , app:drawableTopCompat , app:drawableRightCompat , App app:drawableBottomCompat , app:drawableStartCompat и app:drawableEndCompat составные притягивания, поддерживающие обратные вытягиваемые типы, такие как VectorDrawableCompat .

• AppCompatCheckBox и AppCompatRadioButton Dakeables теперь аниматические проверки изменений состояния.

API меняется

• AOSP/740385 : ActionBaroverLaylayout теперь реализует InterestScrollingParent2 и IntedScrollingParent3, позволяя ему облегчить последнюю функциональность при вложенном прокрутке 3. Если код разработчика в настоящее время переопределяет ActionBarOverLayLayout.onNestedScroll(View, int, int, int, int) и ActionBarOverLayLayout.onNestedScroll(View, int, int, int, int, int, int[]) должен быть переопределен.

Версия 1.0.2

Версия 1.0.2

7 ноября 2018 г.

Выпуск Bugfix core-1.0.1 и appcompat-1.0.2 .

Исправления ошибок

• Исправлена ​​ошибка, в которой PrecomputedTextCompat отключился при использовании при использовании с RTL AppCompatTextView . B/113070424

Версия 1.0.0

Версия 1.0.0

7 ноября 2018 г.

Новые возможности

• AnimatedStateListDrawableCompat обеспечивает анимированные переходы между натягиваемыми состояниями.