Создать фонд
androidx.compose.foundation
androidx.compose.foundation.layout
androidx.compose.foundation.gestures
androidx.compose.foundation.selection
androidx.compose.foundation.lazy
androidx.compose.foundation.interaction
androidx.compose.foundation.text
( См. справочную документацию по API для всех пакетов создания )
Последнее обновление | Стабильный выпуск | Кандидат на выпуск | Бета-версия | Альфа-релиз |
---|---|---|---|---|
26 февраля 2025 г. | 1.7.8 | - | 1.8.0-бета03 | - |
Структура
Compose — это комбинация 7 идентификаторов групп Maven в androidx
. Каждая группа содержит целевой подмножество функций, каждая из которых имеет свой собственный набор примечаний к выпуску.
В этой таблице описаны группы и ссылки на каждый набор примечаний к выпуску.
Группа | Описание |
---|---|
сочинить.анимацию | Создавайте анимацию в своих приложениях Jetpack Compose, чтобы улучшить взаимодействие с пользователем. |
compose.compiler | Преобразуйте функции @Composable и включите оптимизацию с помощью плагина компилятора Kotlin. |
compose.foundation | Создавайте приложения Jetpack Compose с готовыми к использованию стандартными блоками и расширяйте основу для создания собственных элементов системы проектирования. |
составить.материал | Создавайте пользовательские интерфейсы Jetpack Compose с готовыми к использованию компонентами Material Design. Это точка входа более высокого уровня в Compose, предназначенная для предоставления компонентов, соответствующих описанным на сайте www.material.io. |
Compose.material3 | Создавайте пользовательские интерфейсы Jetpack Compose с помощью компонентов Material Design 3 — следующего этапа развития Material Design. Material 3 включает в себя обновленные темы и компоненты, а также функции персонализации Material You, такие как динамический цвет, и разработан с учетом нового визуального стиля Android 12 и системного пользовательского интерфейса. |
Compose.runtime | Фундаментальные строительные блоки модели программирования Compose и управления состоянием, а также основная среда выполнения для целевого подключаемого модуля Compose Compiler. |
Compose.ui | Фундаментальные компоненты пользовательского интерфейса, необходимые для взаимодействия с устройством, включая макет, рисование и ввод. |
Объявление зависимостей
Чтобы добавить зависимость от Compose, вам необходимо добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .
Добавьте зависимости для нужных вам артефактов в файл build.gradle
для вашего приложения или модуля:
Groovy
dependencies { implementation "androidx.compose.foundation:foundation:1.7.5" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.5.15" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.foundation:foundation:1.7.5") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.5.15" } kotlinOptions { jvmTarget = "1.8" } }
Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .
Обратная связь
Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.
Дополнительную информацию см. в документации по системе отслеживания проблем .
Версия 1.8
Версия 1.8.0-бета03
26 февраля 2025 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-beta03
. Версия 1.8.0-beta03 содержит эти коммиты .
Исправления ошибок
- Добавлено новое семантическое свойство
InputText
, которое фиксирует значение текстового поля перед применением выходного преобразования. ( Iae46a , б/395911609 , б/176949051 ) - Удалены устаревшие перегрузки
AutoSize
. Используйте APITextAutoSize
, выполняющие ту же функцию. ( I2c90f ) - Исправлена проблема с кэшированием
TextAutoSize
, из-за которой второй проход макета с теми же ограничениями мог привести к использованию второго по величине подходящего размера шрифта вместо самого большого. ( Id367f )
Версия 1.8.0-бета02
12 февраля 2025 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-beta02
. Версия 1.8.0-beta02 содержит эти коммиты .
Исправления ошибок
- Исправлена проблема, из-за которой реализации чрезмерной прокрутки с использованием
LayoutModifierNode
не работали правильно внутри контейнеров прокрутки.
Версия 1.8.0-бета01
29 января 2025 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-beta01
. Версия 1.8.0-beta01 содержит эти коммиты .
Изменения API
-
SemanticsNodeInteraction.semanticsId()
был удален. Вместо этого используйтеSemanticsNodeInteraction.fetchSemanticsNode().id
. ( Ie397a ) - Перепишите API
requestAutofill
, чтобы он существовал вне диспетчера автозаполнения. ( ID1929 ) -
ContextualFlowRow
иContextualFlowColumn
помечены как устаревшие. Этот экспериментальный компонент был представлен в версии 1.7 и еще не стабилизирован, поэтому его реализация была признана нежелательной. В будущем может быть предоставлен компонент, решающий случаи использования, для решения которых этот компонент предназначен.-
FlowRow
иFlowColumn
имеют экспериментальные перегрузки, которые были представлены в версии 1.7 и включают параметрoverflow
. Использование этого параметра устарело, вместо него можно использовать перегрузки без этого параметра. Поведением «переполнения» по умолчанию для этих перегрузок будет «Клип», как и было с момента его появления. - Многие варианты использования
ContextualFlowRow
могут быть реализованы с помощьюFlowRow
, но мы признаем, что в целом это не так.ContextualFlowRow
полностью реализуем в пользовательском пространстве, и при желании можно попытаться скопировать его реализацию и адаптировать. В будущем мы надеемся решить эти варианты использования другим способом. ( Ибафек )
-
Исправления ошибок
- Исправить макет текста с многоточием, который иногда неправильно переводился во время анимации, см. b/389707025 для получения дополнительной информации ( Ie55b1 , b/389707025 ).
- Исправлена ошибка в
BasicText
сTextAutoSize
иmaxLines
, установленными на 1. ( Ic0450 , b/376834366 ). - Минимальная внутренняя высота текста теперь учитывает параметр
minLines
. Это означает, что минимальная сообщаемая высота встроенных элементов не будет меньше высоты, необходимой для удовлетворения параметраminLines
( I225f9 , b/388299762 ).
Версия 1.8.0-альфа08
15 января 2025 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-alpha08
. Версия 1.8.0-alpha08 содержит эти коммиты .
Изменения API
- AutoSize:
AutoSize
переименован вTextAutoSize
и опубликованы API, которые позволяют создавать собственные реализацииTextAutoSize
. См.TextAutoSizeSample
для примера реализации пользовательского автоматического размера текста. ( I85756 ) - Флаг функции
DetectTapGesturesEnableNewDispatchingBehavior
перемещен вComposeFoundationFlags
и переименован вisDetectTapGesturesImmediateCoroutineDispatchEnabled
. Старый флаг устарел и теперь вместо него будет делегироватьсяComposeFoundationFlags.isDetectTapGesturesImmediateCoroutineDispatchEnabled
. ( I62932 )
Исправления ошибок
- По умолчанию
DetectTapGesturesEnableNewDispatchingBehavior
включен. API-интерфейсыTapGestureDetector
теперь по умолчанию используют новое поведение отправки (немедленную отправку). ( I9f2bc , б/369648479 ) - Исправлены
requiredWidth/Height/Size
для правильной обработки внутренних размеров. ( Ie3d7d , б/368113212 )
Внешний вклад
- Унифицированная
BasicTooltip
в Foundation иBasicTooltip/Tooltip
в материале3. ( Ifc2e6 ) - Добавлен новый интерфейс буфера обмена и локальная композиция для него. ( I80809 )
Версия 1.8.0-альфа07
11 декабря 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-alpha07
. Версия 1.8.0-alpha07 содержит эти коммиты .
Изменения API
- Удален флаг
ComposeFoundationFlags.RemoveBasicTextGraphicsLayerEnabled
, который помог отменить удаление внутреннегоgraphicsLayer
изBasicText
. Если вы использовали этот флаг, сообщите нам о причинах, сообщив об ошибке. Также вы можете просто передатьModifier.graphicsLayer()
в вызовыBasicText
, чтобы добиться того же поведения, что и раньше. ( ID9f90 ) - Добавлена реализация по умолчанию для нового
stickyHeader
DSL. ( I68986 ) - Имеет локальную композицию
LocalAutofillHighlightColor
, использующую тип цвета. ( I0e05b ) -
OverscrollEffect#withoutDrawing
переименован вOverscrollEffect#withoutVisualEffect
. ( I1a154 )
Исправления ошибок
- Последующее исправление проблемы в расчете цели
AnchoredDraggable
, из-за которой он мог остановиться на неправильной привязке для определенных движений. ( I23b87 , б/367660226 )
Внешний вклад
- Добавьте
BringIntoViewResponderModifierNode
в пользовательский интерфейс, который обеспечивает новый способ реализации функции Bring Into View, а также позволяет реализовать ее на уровне платформы ( Ia6dd8 ). - Мы постоянно немного меняем способ рисования курсора. Вы можете использовать
LocalCursorBlinkEnabled
, чтобы отключить отрисовку курсора в тестах. ( I4c697 )
Версия 1.8.0-альфа06
13 ноября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-alpha06
. Версия 1.8.0-alpha06 содержит эти коммиты .
Изменения API
- Добавляет модификатор
stylusHoverIcon
. ( Iff20a , b/331289114 ) - Устаревшее
confirmValueChange
AnchoredDraggableState
. Вместо наложения вето на изменения состояния запрещенные привязки не должны находиться в активном наборе привязок, аOverscrollEffect
следует использовать для указания недоступности запрошенного действия. ( Ia717f ) - Превращает диспетчер автозаполнения в интерфейс. ( I84914 , б/376080755 )
- Добавляет API
OverscrollEffect#withoutDrawing
иOverscrollEffect#withoutEventHandling
— эти API создают обернутый экземпляр предоставленного эффекта прокрутки, который не рисует и не обрабатывает события соответственно, что позволяет отображать прокрутку в отдельном компоненте от компонента, который отправляет события. Например, отключить отрисовку прокрутки внутри ленивого списка, а затем отрисовывать прокрутку отдельно сверху/в другом месте. ( Idbb3d , б/266550551 , б/204650733 , б/255554340 , б/229537244 ) - Добавление поддержки автозаполнения на текстовой панели инструментов. ( Ie6a4c )
- Устаревшие
OverscrollConfiguration
иLocalOverscrollConfiguration
и добавленrememberPlatformOverscrollFactory
для создания экземпляра/настройки параметров реализации чрезмерной прокрутки по умолчанию. Чтобы отключить избыточную прокрутку, вместоLocalOverscrollConfiguration provides null
, используйтеLocalOverscrollFactory provides null
. Чтобы изменить цвет свечения/отступы, вместоLocalOverscrollConfiguration provides OverscrollConfiguration(myColor, myPadding)
, используйтеLocalOverscrollFactory provides rememberPlatformOverscrollFactory(myColor, myPadding)
. ( Ie71f9 , б/255554340 , б/234451516 ) - Свойство
effectModifier
вOverscrollEffect
изменено наnode: DelegatableNode
, что соответствует другим API. ( Ic0b46 , б/255554340 ) - Удален экспериментальный API
GlobalAssertions
. Его предполагаемое использование заключалось в запуске проверок доступности, вместо этого см.enableAccessibilityChecks()
для этой цели. ( I59322 )
Версия 1.8.0-альфа05
30 октября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-alpha05
. Версия 1.8.0-alpha05 содержит эти коммиты .
Новые возможности
- Поддержка автоматического изменения размера текста. Передайте экземпляр
AutoSize
(например,AutoSize.StepBased
) в свой любимый компонуемый текст (например,BasicText
) и увидите, как размер вашего текста адаптируется к доступному пространству! ( Ice7e0 , б/139320827 ) - Добавляет API
OverscrollFactory
иLocalOverscrollFactory
, позволяющие настраивать избыточную прокрутку в иерархии. Значение, предоставленное черезLocalOverscrollFactory
будет использоваться по умолчанию для созданияOverscrollEffect
. Чтобы создать и запомнить эффект из текущей предоставленной фабрики, используйтеrememberOverscrollEffect()
. ( I51ca4 , б / 255554340 )
Изменения API
- Представьте
CompositionLocal
, который можно использовать для изменения оттенка выделения успешного заполнения автозаполнения. ( I32092 ) - Удален
ScrollableDefaults.overscrollEffect
— вместо этого вы должны использоватьrememberOverscrollEffect
. Это создаст экземпляр текущей реализации избыточной прокрутки, предоставленнойLocalOverscrollFactory
. ( I1651a , б / 255554340 ), ( б / 234451516 ) - Представляет новый интерфейс
AutofillManager
, который можно использовать для точной настройки пути пользователя к автозаполнению, а также флагisSemanticAutofillEnabled
для включения этой новой версии автозаполнения. ( I9d484 ) - Удаляет
CombinedClickableNode
. Этот экспериментальный API временно использовался для разблокировки производительности, но больше не нужен. Вместо этого вам следует напрямую использоватьModifier.combinedClickable
, как и другие API-модификаторы. ( I4b658 ) - Добавляет перегрузки для
horizontalScroll
,verticalScroll
,LazyColumn
,LazyRow
,LazyHorizontalGrid
,LazyVerticalGrid
,LazyHorizontalStaggeredGrid
,LazyVerticalStaggeredGrid
,HorizontalPager
иVerticalPager
с поддержкой указания пользовательскогоOverscrollEffect
. ПредоставленныйOverscrollEffect
будет получать события и отображаться в пределах этих компонентов. Обратите внимание, что рисование одного и того жеOverscrollEffect
дважды не поддерживается, поэтому вы не можете нарисовать один и тот жеOverscrollEffect
, предоставленный одному из этих компонентов, отдельно с помощьюModifier.overscroll
. Вариант использования прорисовки чрезмерной прокрутки за пределами этих компонентов будет рассмотрен отдельно в будущем. ( I2dc42 , б/266550551 , б/234274772 , б/224572538 , б/353805117 )
Версия 1.8.0-альфа04
16 октября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-alpha04
. Версия 1.8.0-alpha04 содержит эти коммиты .
Изменения API
- Добавляет обратные вызовы
DelegatableNode#onDensityChange
иDelegatableNode#onLayoutDirectionChange
позволяющие обновлять состояние узла при их изменении. ( I04f3e , б/340662451 ) - Paragraph и
ParagraphIntrinsics
теперь принимают список всех аннотаций, примененных кAnnotatedString
, раньше у него был только списокSpanStyles
. ( I12f80 ) - Представлен
PointerInputModifierNode#touchBoundsExpansion
, который можно использовать для увеличения границ касания одного модификатора ввода указателя. ( Iccf02 , б/335339283 )
Исправления ошибок
- Исправлена ошибка, из-за которой позиционные пороги, передаваемые в
AnchoredDraggableDefaults.flingBehavior
, не учитывались правильно в некоторых сценариях. ( Ifdf0d , b/367660226 ) - Внедрить исправление для вложенных прокручиваемых элементов, которые удаляются из дерева узлов во время текущего выброса. Теперь эти узлы отменят бросок и правильно отправят событие
onPostFling
с оставшейся скоростью. Мы также вводим флагNewNestedScrollFlingDispatchingEnabled
для управления поведением в случае регрессии. Флаг будет удален перед бета-тестированием. ( I05c37 , б/371168883 ) - Исправлена ошибка, из-за которой
OverscrollEffects
, передаваемый вModifier.anchoredDraggable
, получал 2D-дельты вместо 1D. ( Ie52c0 )
Версия 1.8.0-альфа03
2 октября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-alpha03
. Версия 1.8.0-alpha03 содержит эти коммиты .
Изменения API
- Обновление версии Kotlin до 1.9 ( I1a14c )
- Представлен флаг
DraggableAddDownEventFixEnabled
( I848d5 ). - Представлена новая роль семантики под названием «Карусель» для эмуляции поведения списка в пейджерах для служб a11y. ( Id354b , б/354109776 , б/239672673 )
- Удален неявный модификатор
graphicsLayer
из составного элементаBasicText
. Добавлен экспериментальный флагComposeFoundationFlags.RemoveBasicTextGraphicsLayerEnabled
, позволяющий вернуться к старому поведению. ( Ie478d ) - Добавлен
Modifier.recalculateWindowInsets()
чтобы позволить дочерним элементам в иерархии использоватьinsetsPadding
, даже если родители выровняли их безconsumeWindowInsets()
. ( I7f9e4 )
Исправления ошибок
- Реализуйте распознавание жестов в
detectDragGestures
, перетаскиваемых и прокручиваемых объектах. Теперь, если перетаскиваемый ребенок отказывается от жеста, у родителя есть возможность его поднять. Это обеспечивает более непрерывную и интегрированную обработку жестов. ( Ic88fe ) - Обновите поведение отмены броска в прокручиваемых объектах. Теперь, если прокручиваемый объект прокручивается и достигает границ, он правильно передает скорость прокрутки следующему прокручиваемому объекту в цепочке, вместо того, чтобы продолжать движение. ( I9326a )
Версия 1.8.0-альфа02
18 сентября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-alpha02
. Версия 1.8.0-alpha02 содержит эти коммиты .
Изменения API
-
TextOverflow.StartEllipsis
иTextOverflow.MiddleEllipsis
теперь доступны, что позволяет размещать многоточие в начале или середине строки однострочного текста ( I38913 , b/185418980 ).
Версия 1.8.0-альфа01
4 сентября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.8.0-alpha01
. Версия 1.8.0-alpha01 содержит эти коммиты .
Версия 1.7
Версия 1.7.8
12 февраля 2025 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.8
. Версия 1.7.8 содержит эти коммиты .
Исправления ошибок
- Исправлен сбой в
BasicTextField
с преобразованием ввода при замене части вставленного текста. ( I73702 )
Версия 1.7.7
29 января 2025 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.7
. Версия 1.7.7 содержит эти коммиты .
Исправления ошибок
- Исправлен сбой
IndexOutOfBound
с аннотацией ссылки. ( Ic96d2 ) - Исправлена бесконечная рекомпозиция в некоторых крайних случаях со ссылками. ( I04a03 )
Известные ошибки
- Была обнаружена ошибка, которая в редких случаях может привести к неожиданному переносу текста на уровне Android API 35. Ее нельзя исправить в версии 1.7, поэтому она будет исправлена в версии 1.8. ( б/391378120 )
Версия 1.7.6
11 декабря 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.6
. Версия 1.7.6 содержит эти коммиты .
Исправления ошибок
- Исправлен встроенный текстовый контент, который не был виден службам специальных возможностей.
- Исправлена проблема, из-за которой
AndroidEmbeddedExternalSurface
не сбрасывался должным образом и зависал при повторном использовании в ленивом списке.
Версия 1.7.5
30 октября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.5
. Версия 1.7.5 содержит эти коммиты .
Исправления ошибок
- Убедитесь, что закрепленные элементы не разделены дважды в области заполнения содержимого. ( Ic6224 )
Версия 1.7.4
16 октября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.4
. Версия 1.7.4 содержит эти коммиты .
Исправления ошибок
- Исправлена ошибка, приводившая к редкому сбою в текстовых полях. ( I475c6 , б/313010266 )
- Удален
ReusableContentHost
в корне элементов ленивого макета. Это было потенциальной основной причиной сбоев «меры, вызванной на деактивированном узле». ( ID6e60 )
Версия 1.7.3
2 октября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.3
. Версия 1.7.3 содержит эти коммиты .
Исправления ошибок
- Исправлена утечка памяти в
BasicText
, когда для minLines установлено значение, отличное от значения по умолчанию.
Версия 1.7.2
18 сентября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.2
. Версия 1.7.2 содержит эти коммиты .
Исправления ошибок
- Исправлена проблема с перетаскиванием, в которой отсутствовали события опускания, из-за чего перемещения выглядели медленнее, чем обычно.
Версия 1.7.1
10 сентября 2024 г.
- Никаких изменений в артефактах Android. Артефакты
-desktop
были удалены и добавлены артефакты-jvmStubs
и-linuxx64Stubs
. Ни одна из этих целей не предназначена для использования, они являются заполнителями, помогающими Jetbrains Compose.
Версия 1.7.0
4 сентября 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0
. Версия 1.7.0 содержит эти коммиты .
Важные изменения с версии 1.6.0
- Производительность
Modifier.clickable
,Modifier.focusable
,Modifier.indication
,Modifier.scrollable
иModifier.draggable
была значительно улучшена. В рамках этой работы в дополнение к внутренним изменениям были внесены следующие изменения API.- Добавлен новый API индикации,
IndicationNodeFactory
. Это приводит к более производительным реализациям индикации по сравнению с предыдущим (теперь устаревшим) APIrememberUpdatedInstance
. Информацию о миграции см. на сайте Developer.android.com . -
clickable
/combinedClickable
/selectable
/toggleable
теперь принимает параметрMutableInteractionSource
, допускающий значение NULL. Если значение равно нулю и предоставленное указание являетсяIndicationNodeFactory
, указание можно создавать лениво только при необходимости, что повышает производительность. Если вы не поднимаете и не используетеMutableInteractionSource
, рекомендуется передавать null вместо передачиremember { MutableInteractionSource() }
. -
Indication#rememberUpdatedInstance
устарела. Он имеет высокий неизбежный недостаток производительности и препятствует другим оптимизациям. Вместо этого вам следует использовать новый APIIndicationNodeFactory
.
- Добавлен новый API индикации,
-
BasicTextField
использующийTextFieldState
, теперь стабилен, и мы советуем всем сайтам вызова начать миграцию сBasicTextField(value, onValueChange)
наBasicTextField(TextFieldState)
. -
ClickableText
устарел. Чтобы добавить в текст интерактивные ссылки, используйтеBasicText
с новой аннотациейLinkAnnotation
в вашемAnnotatedString
.LinkAnnotation
позволяет настраивать стили в зависимости от состояния ссылки (например, в фокусе, при наведении). - Представляем
ContextualFlowRow
иEnhanced FlowRow/Column
сMaxLines
иOverflow
. Мы рады объявить об улучшениях экспериментальныхFlowRow
иFlowColumn
, которые теперь включают поддержкуmaxLines
и переполнения, а также дебютContextualFlowRow
иContextualFlowColumn
. Это обновление предназначено для обеспечения компонентов с оптимальной производительностью, гдеContextualFlow*
идеально подходит для большого количества элементов, использующих небольшую конфигурацию maxLines и динамические кнопки +N «Просмотреть больше», аFlowRow
иFlowColumn
идеально подходят для небольшого количества элементов, менее 100 элементов. Важно: Чтобы сохранить существующее поведение вFlowRow
илиFlowColumn
, где все элементы составлены независимо от того, соответствуют ли они максимальному значению поперечной оси, задайте для переполнения значениеFlowRowOverflow.Visible
илиFlowColumnOverflow.Visible
во время инициализации. ИзучитеContextualFlowRowSample
иFlowRowSample
, чтобы увидеть примеры этих новых функций в действии. ( Ib9135 , б / 293577082 ) - Поддержка анимации появления и исчезновения элементов была добавлена в
LazyColumn
иLazyRow
. Ранее можно было добавить модификаторModifier.animateItemPlacement()
для поддержки анимации размещения (переупорядочения). Мы упразднили этот модификатор и представили новый неэкспериментальный модификатор под названиемModifier.animateItem()
, который позволяет поддерживать все три типа анимации: появление (появление), исчезновение (появление) и изменение порядка. ( I2d7f7 , б/150812265 ) - Реализована экспериментальная поддержка длинных снимков экрана в контейнерах прокрутки Compose с использованием официального API Android (
ScrollCaptureCallback
). - Источники
NestedScroll
Drag и Fling заменяютсяUserInput
иSideEffect
, чтобы обеспечить расширенное определение этих источников, которые теперь включают анимацию (Side Effect) и колесо мыши и клавиатуру (UserInput
). - Запросы предварительной выборки
LazyLayout
теперь могут быть помечены как срочные. Это означает, что мы ожидаем, что этот элемент понадобится в следующем кадре, и хотим игнорировать бюджет кадра, чтобы заранее выполнить дополнительную работу ( Id513f ). - Поддержка функции рукописного ввода стилусом на устройствах после Android U. ( I002e4 )
- Различные API переведены в стабильную версию.
- Пейджеры, привязки, оконные вставки
Версия 1.7.0-rc01
21 августа 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-rc01
. Версия 1.7.0-rc01 содержит эти коммиты .
Исправления ошибок
- Исправлена регрессионная ошибка, при которой происходил сбой, когда любой элемент фокусировался внутри родительского элемента, который доступен для фокусировки (или кликабельен) и отключен. ( б / 317561689 )
Версия 1.7.0-beta07
7 августа 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-beta07
. Версия 1.7.0-beta07 содержит эти коммиты .
Исправления ошибок
- Функции
SemanticsNodeInteraction
, связанные с вводом текста,performTextReplacement
,performTextInput
иperformTextClearance
теперь будут выдавать ошибки утверждения, когда они вызываются дляTextFields
только для чтения. ( I4ae8f ) - Исправлен визуальный сбой в гиперссылках. ( I23311 )
- Исправлен модификатор
contentReceiver
, не работавший с некоторыми IME. - Генерация скорости: предотвращение распространения значений NaN в пользовательском интерфейсе Compose и Foundation.
Версия 1.7.0-beta06
24 июля 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-beta06
. Версия 1.7.0-beta06 содержит эти коммиты .
Версия 1.7.0-бета05
10 июля 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-beta05
. Версия 1.7.0-beta05 содержит эти коммиты .
Исправления ошибок
- Исправлена обработка значений Nan в
SnapFlingBehavior
и Pager.
Версия 1.7.0-beta04
26 июня 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-beta04
. Версия 1.7.0-beta04 содержит эти коммиты .
Исправления ошибок
- Избегайте сбоев при измерении очень больших текстовых строк (например, 10 тыс. символов) ( 8157ab ).
- Исправлено измерение очень большого текста, вызывающее сбой в новом
BasicTextField
( 6b7575 ). - Отменяет изменение поведения при измерении строк/столбцов, которое нарушает использование текста в определенных сценариях ( 69e8ba ).
Версия 1.7.0-бета03
12 июня 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-beta03
. Версия 1.7.0-beta03 содержит эти коммиты .
Версия 1.7.0-бета02
29 мая 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-beta02
. Версия 1.7.0-beta02 содержит эти коммиты .
Изменения API
- Добавляет экспериментальный API для настройки поведения предварительной выборки
LazyGrids
, аналогичный существующему экспериментальному API дляLazyLists
. Сюда входит поддержка предварительной выборки элементов во вложенныхLazyGrids
. Как и в случае сLazyListPrefetchStrategy
, реализация по умолчанию предполагает предварительную выборку первых двух вложенных элементов каждой сетки, но это можно настроить с помощью новых APILazyGridPrefetchStrategy(nestedPrefetchItemCount)
иLazyListPrefetchStrategy#onNestedPrefetch
. ( I591c4 ) -
SemanticsProperties.Editable
переименован вIsEditable
и замененSemanticsPropertyReceiver.editable
на значениеisEditable
. Свойство теперь является логическим и всегда указывается в текстовых полях. ( I8acd8 ) - Значения по умолчанию
basicMarquee
перенесены в объектMarqueeDefaults
. ( I12ff6 ) - Параметр
basicMarquee
delayMillis
переименован вrepeatDelayMillis
. ( I12ff6 ) - Обновите API для стилизации ссылок:
TextLinkStyles
перемещены вTextStyle
и удаленыTextDefaults
из материала ( I5477b ).
Исправления ошибок
-
LayoutCoordinates.introducesFrameOfReference
переименован вLayoutCoordinates.introducesMotionFrameOfReference
, чтобы лучше отражать его назначение. Переименована связанная функция для расчета координат на основе этого флага. ( I3a330 ) - Из свойств
MarqueeDefaults
удалено значение «По умолчанию». ( I1d8a0 ) - Удалена надпись «Marquee» из свойств
MarqueeDefaults
. ( Iad4f4 ) - Удалены
TextLinkStyles
из классаTextStyle
. Вместо этогоTextLinkStyles
является частью конструктораLinkAnntation
и методаAnnotatedString.fromHtml
( I90b2b ). - Исправлена ошибка, из-за которой Пейджер щелкал при броске к прыжку, уже находясь на прыжке. ( I9f373 , б/339171222 )
- BTF2 теперь имеет правильные жесты выбора мыши. ( Ibe8c6 )
Внешний вклад
- Повторно отправьте «Создать тип контента для расчета времени компоновки/измерения на основе предварительной выборки для повышения точности» ( Iea622 ).
- Сделайте тип контента расчета времени составления/измерения на основе предварительной выборки для повышения точности ( Ibccb1 ).
- Сделать модификаторы
WindowInsetsPadding
доступными из общего исходного набора ( I070b2 ).
Версия 1.7.0-бета01
14 мая 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-beta01
. Версия 1.7.0-beta01 содержит эти коммиты .
Изменения API
- Добавлено свойство
KeyboardOptions.shouldShowKeyboardOnFocus
обратно как устаревшее скрытое для двоичной совместимости. ( I15cfe ) -
Modifier.anchoredDraggable
теперь по умолчанию меняет дельту перетаскивания для компонентов с горизонтальной ориентацией при использовании в макете RTL. ( I3c6d9 ) -
AnnotatedString.hasEqualsAnnotations
теперь имеетhasEqualAnnotations
. ( I685c0 ) - Обновлен API для получения тематических ссылок Material в тексте. В частности, из
TextDefaults
удалены методы для создания тематическихLinkAnnotations
и анализа HTML с тематическими ссылками. Вместо этого добавлен классTextLinkStyles
, который позволяет стилизовать ссылки в качестве параметра составного текста. ( I31b93 ) - Заменены
onDragStarted
иonDragStopped
обратными вызовами без приостановки. ( I59de8 )
Исправления ошибок
- Исправлена ошибка, из-за которой Pager аварийно завершал работу, если
contentPadding
превышал входящие ограничения. Пейджер теперь приводит отрицательные значения, возвращаемые изPageSize
, к 0. ( Iba5d8 , b/314008560 )
Версия 1.7.0-альфа08
1 мая 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-alpha08
. Версия 1.7.0-alpha08 содержит эти коммиты .
Новые возможности
- В
BasicTextField
иSelectionContainer
добавлено контекстное меню, вызываемое правой кнопкой мыши, с элементами для действий вырезания, копирования, вставки и выбора всех. ( If8c93 , Ia2b49 , I6f268 )
Изменения API
- Запросы предварительной выборки
LazyLayout
теперь могут быть помечены как срочные. Это означает, что мы ожидаем, что этот элемент понадобится в следующем кадре, и хотим игнорировать бюджет кадра, чтобы заранее выполнить дополнительную работу ( Id513f ). - Переименован
isPositionedByParentWithDirectManipulation
, чтобыintroducesFrameOfReference
. Обратите внимание, что теперь это имеет обратный эффект: по умолчанию большинствоLayoutCoordinates
вводят систему отсчета, и только при прямом манипулировании свойство будет иметь значение false. Чтобы запросить позицию только тех, которые вводят систему отсчета, используйтеpositionInLocalFrameOfReference(...)
. ИлиpositionInLocalLookaheadFrameOfReference
изLookaheadScope
. ( Ifc5f7 ) - Переименован
onClicked
вonClick
внутриLinkInteractionListener
( Iaa35c ). - Измените лямбду действия для
getScrollViewportLength
в соответствии с отзывами совета API. ( Ibc74a ) - Переименованы API-интерфейсы делегирования рукописного ввода стилуса. ( Ica45f , б/327271923 )
- Переименуйте
TextInclusionStrategy.isInside
вisIncluded
. Сделайте тип возвращаемого значенияParagraph/MultiParagraph#getRangeForRect()
не допускающим значения NULL. ( I51f26 )
Исправления ошибок
- Добавлен параметр «Выбрать все» во все текстовые контекстные меню в
SelectionContainer
. ( Ib750e , б/240143283 ) - Исправлен длинный снимок экрана для прокручиваемых контейнеров с
reverseScrolling=true
. ( I7c59c ) - Исправлена проблема, из-за которой
currentValue
AnchoredDraggableState
менялся при приближении к границам состояния. ( Iea30b , б/333846848 )
Внешний вклад
-
PrefetchExecutor
переименован вPrefetchScheduler
, чтобы лучше отражать его обязанности. ( Ib9154 ) - Добавлена поддержка предварительной выборки элементов во вложенных
LazyLists
(например,LazyColumn
, который отображает вложенныеLazyRows
). Ожидается, что это изменение уменьшит выпадение кадров во время прокрутки для этихLazyLists
. По умолчанию реализация выполняет предварительную выборку первых двух вложенных элементов, однако этим поведением можно управлять с помощью новых APILazyLayoutPrefetchStrategy(nestedPrefetchItemCount)
иLazyListPrefetchStrategy#onNestedPrefetch
. ( I51952 )
Версия 1.7.0-альфа07
17 апреля 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-alpha07
. Версия 1.7.0-alpha07 содержит эти коммиты .
Новые возможности
- Добавлен объект
TextDefaults
, содержащий методы для созданияLinkAnnotation
и анализа строки с HTML-тегом, которая применяетMaterialTheme
к ссылкам. ( I98532 , б / 139312671 ) - Поддержка анимации появления и исчезновения элементов была добавлена в
LazyVerticalGrid
иLazyHorizontalGrid
. Ранее можно было добавить модификаторModifier.animateItemPlacement()
для поддержки анимации размещения (переупорядочения). Мы упразднили этот модификатор и представили новый неэкспериментальный модификатор под названиемModifier.animateItem()
, который позволяет поддерживать все три типа анимации: появление (появление), исчезновение (появление) и изменение порядка. ( Ib7d12 , б/330510929 ) - Поддержка анимации появления и исчезновения элементов была добавлена в
LazyVerticalStaggeredGrid
иLazyHorizontalStaggeredGrid
. Ранее можно было добавить модификаторModifier.animateItemPlacement()
для поддержки анимации размещения (переупорядочения). Мы упразднили этот модификатор и представили новый неэкспериментальный модификатор под названиемModifier.animateItem()
, который позволяет поддерживать все три типа анимации: появление (появление), исчезновение (появление) и изменение порядка. ( I69bc9 , б/330511290 )
Изменения API
- Добавляет
ContextMenuColors
и связанный с нимLocalContextMenuTheme
ProvidableCompositionLocal
. Цвета контекстного меню текстовых полей и выбираемого текста можно изменить, предоставив локальную композицию. ( Ифа154 ) - Текстовые ссылки получили возможность стилизации нажатого состояния в дополнение к обычному стилю, наведению курсора и фокусу. ( I5f864 , б / 139312671 )
- Представьте
ViewConfiguration.HandwritingGestureLineMargin
для жестов рукописного ввода. Поддержка жестов рукописного ввода дляBasicTextField
. ( Ie6e13 , б/325660505 ) - Удален
DelegatableNode.scrollIntoView
для версии 1.7, поскольку у нас не было времени завершить стабилизацию остальной части связанной поверхности API. Эта функция будет вновь представлена в версии 1.8 ( I6cf61 , b/333421581 , b/332900232 ). - При запросе координат макета теперь вы можете использовать аргумент
excludeDirectManipulationOffset
, чтобы исключить смещение, установленное родительскими макетами, которые разместили своих дочерних элементов с помощьюPlaceable.PlacementScope.withDirectManipulationPlacement
. Аналогично, макет, который часто меняет положение своих дочерних элементов, теперь может размещать их с помощьюwithDirectManipulationPlacement
(например, Scroll, реализованного по умолчанию). Это помогает анимации, основанной наapproachLayout
, стать более интуитивно понятными, поскольку теперь у вас есть возможность различать, какое смещение нужно анимировать, а что применять непосредственно при принятии решения о анимации их подхода. ( I60ec7 ) - Представьте
requestScrollToItem
дляLazyStaggeredGrid
. Для каждого прохода измерения клиент теперь может отказаться от поддержки индекса на основе ключа, вызвавrequestScrollToItem
. Это никак не меняет существующее поведение, если не вызываетсяrequestScrollToItem
. ( I63983 ) - Введите
requestScrollToPage
в Pager. Для каждого прохода измерения клиент теперь может отказаться от поддержки индекса на основе ключа, вызвавrequestScrollToPage
. Это никак не меняет существующее поведение, если не вызываетсяrequestScrollToPage
. ( Ic4213 ) - Представлен
requestScrollToItem
дляLazyGrids
. Для каждого прохода измерения клиент теперь может отказаться от поддержки индекса на основе ключа, вызвавrequestScrollToItem
. Это никак не меняет существующее поведение, если не вызываетсяrequestScrollToItem
. ( I0a7a0 ) -
ClickableText
помечен как устаревший. Чтобы добавить ссылки в текст, создайтеAnnotatedString
сLinkAnnotation
, соответствующим вашей ссылке, и передайте этуAnnotatedString
в компонуемыйText
( I34d4b , b/323346994 ). -
UrlAnnotation
устарел, используйте вместо негоLinkAnnotation.Url
. Если вы используете тему Material, используйте объектTextDefaults
для создания аннотации с примененной к ней темой Material ( I8d180 , b/323346545 ). -
String.parseAsHtml
переименован вAnnotatedString.Companion.fromHtml
( I43dcd ). - В метод
parseAsHtml
добавлены аргументы стиля (linkStyle
,focusedLinkStyle
,hoveredLinkStyle
) и прослушиватель взаимодействия ссылок. При анализе строки с HTML-тегом с помощью тегов<a>
метод создаетLinkAnnotation.Url
для каждого такого тега и передает объекты стиля и прослушиватель взаимодействия ссылок в каждую аннотацию. ( I7c977 ) -
LinkAnnotation
теперь принимает аргументы стиля на основе состояния иLinkInteractionListener
. Добавьте эту аннотацию вAnnotatedString
, чтобы получить гиперссылку. ПередаваяfocusedState
и/илиhoveredState
вы можете определить визуальную конфигурацию ссылок, когда они находятся в фокусе и/или наведены. ( I81ce4 , б/139312671 ) - Флаг функции для длинных снимков экрана был удален. ( I28648 , б/329128246 )
-
LazyColumn
теперь правильно отображает прикрепленные заголовки на длинных скриншотах. ( I8d239 , б/329296635 ) - Стабилизировано большинство оставшихся экспериментальных API, которые были представлены с новым
BasicTextField
. ( I714e2 ) - В
BasicSecureTextField
добавлен параметрtextObfuscationCharacter
, который определяет, какой символ использовать при запутывании содержимого. ( I0588b ) - Источники
NestedScroll
Drag и Fling заменяютсяUserInput
иSideEffect
, чтобы учесть расширенное определение этих источников, которые теперь включают анимацию (Side Effect) и колесо мыши и клавиатуру (UserInput
). ( I40579 ) - Представьте
LocalBringIntoViewSpec
— поведение прокрутки фокуса, зависящее от платформы, которое применяется на слое модификатора Scrollable. ( I27aa5 , б/317453911 ) - Удален
TextFieldCharSequence
.TextFieldBuffer.originalValues
заменяется наTextFieldBuffer.originalText
иTextFieldBuffer.originalSelection
. ( I2c7d6 ) -
ImeOptions.hintLocales
больше не имеет значения NULL. Если вы хотите передать пустой список локалей, используйтеLocaleList.Empty
. ( Ic5bc4 ) -
getOffsetFractionForPage
переименован вgetOffsetDistanceInPages
. ( Ia05e2 )
Исправления ошибок
- Когда
InputTransformations
соединяются сnext
, ихKeyboardOptions
теперь правильно объединяются по отдельным параметрам с помощью нового методаKeyboardOptions.merge
. ( Ie5304 , б/295951492 ) -
targetValue
AnchoredDraggableState
теперь больше не учитывает позиционные пороги. Теперь он имеет неявный порог 50 %, что означает, чтоtargetValue
изменяется в средней точке между двумя привязками. ( I82c2c )
Внешний вклад
- Переименованы 2 API прокрутки ( I56a75 ).
Версия 1.7.0-альфа06
3 апреля 2024 г.
Выпущен androidx.compose.foundation:foundation-*:1.7.0-alpha06
. Версия 1.7.0-alpha06 содержит эти коммиты .
Новые возможности
- Поддержка анимации появления и исчезновения элементов была добавлена в
LazyColumn
иLazyRow
. Ранее можно было добавить модификаторModifier.animateItemPlacement()
для поддержки анимации размещения (переупорядочения). Мы упразднили этот модификатор и представили новый неэкспериментальный модификатор под названиемModifier.animateItem()
, который позволяет поддерживать все три типа анимации: появление (появление), исчезновение (появление) и изменение порядка. ( I2d7f7 , б/150812265 ) - Клиенты
LazyColumn/LazyRow
теперь могут отказаться от поддержки индекса на основе ключа для предстоящего прохода измерения, вызвав не приостанавливаемыйLazyListState.requestToScroll
. ( I98036 , б/209652366 ) - Добавлен метод
parseAsHtml
для стилизованных строк: он позволяет конвертировать строку, помеченную HTML-тегами, вAnnotatedString
. Обратите внимание, что не все теги поддерживаются, например, вы пока не сможете отображать маркированные списки. ( I84d3d ) - Реализована экспериментальная поддержка длинных снимков экрана в контейнерах прокрутки Compose с использованием официального API Android (
ScrollCaptureCallback
). Эта функция является экспериментальной и в настоящее время может обрабатывать не все случаи правильно. По этой причине в настоящее время по умолчанию он отключен. Чтобы принять участие, установите для флагаComposeFeatureFlag_LongScreenshotsEnabled
значение true. Этот флаг будет удален перед бета-версией 1.7. ( I2b055 , б/329296471 ) - Внедрите новый API
GraphicsLayer
, чтобы обеспечить большую гибкость при размещении и рендеринге экземпляровGraphicsLayer
и поддерживать встроенные функции рендеринга без необходимости координации с реализациями Composable для указания экземпляров модификатораGraphicsLayer
.
Изменения API
- Все параметры
KeyboardOptions
теперь по умолчанию имеют неопределенное значение. Добавлен методKeyboardOptions.merge
. -
KeyboardOptions.autoCorrect
переименован вautoCorrectEnabled
и сделал его допускающим значение NULL, где значение NULL означает, что значение не было указано. ( Ia8ba0 , б/295951492 ) -
outOfBoundsPageCount
переименован вbeyondViewportPageCount
. ( I129c6 ) -
fun ClipEntry.getMetadata()
заменено наval ClipEntry.clipMetadata
. ( I50155 ) - Удален
TextFieldState.valueAsFlow()
. Предпочитаю использоватьsnapshotFlow { state.text }
илиsnapshotFlow { TextFieldCharSequence(state.text, state.selection) }
( I7d629 ) - Реорганизованы параметры
InputTransformation.transformInput
. УдаленoriginalValue: TextFieldCharSequence
. Вместо этогоTextFieldBuffer
теперь содержит это значение с тем же именем. Также удален параметрvalueWithChanges: TextFieldBuffer
.TextFieldBuffer
теперь является областью получателя функции. ( I919cc ) - Вариант
BasicTextField(state)
иBasicSecureTextField
теперь используютKeyboardActionHandler
вместоKeyboardActions
для обработки действий, выполняемых программной клавиатурой. ( I58dda ) - API-интерфейсы делегирования рукописного ввода стилусом для поддержки рукописного ввода стилусом в «поддельных» полях ввода текста. ( I9c09c , б/327271923 )
- Переименован
KeyboardOptions.shouldShowKeyboardOnFocus
вshowKeyboardOnFocus
. ( Ib4b7a , б/295951492 ) - Удален
hintMediaTypes
изModifier.contentReceiver
. Разработчикам уже было предложено проверить тип носителя полученногоTransferableContent
, поскольку он может быть несовместим сhintMediaTypes
. ( I82f99 ) - Изменен порядок параметров
BasicSecureTextField
. Удалены параметрыkeyboardType
иimeAction
в пользу полного классаKeyboardOptions
, при этом сохранены те же значения по умолчанию, которые подходят дляBasicSecureTextField
. Также удален параметрscrollState
. ( Иббфа9 ) - Тип
TextFieldState.text
изменяется отTextFieldCharSequence
на JustCharSequence
. Поэтому добавленоTextFieldState.selection: TextRange
иTextFieldState.composition: TextRange?
Чтобы прочитать текущие значения выбора и композиции непосредственно из объекта состояния. - Удален
TextFieldState.forEachTextValue
. ( IDB2A2 ) - Удален
ClipboardManager.getClipMetadata
иClipboardManager.hasClip
. Пожалуйста, используйтеclipEntry.getMetadata()
чтобы прочитать метаданные текущего записи клипа. Также проверьте результатClipboardManager.getClip
, если он нулевой или не понимает, имеет ли буфер обмена текущим клип. ( I50498 ) -
ClipboardManager.setClip
теперь принимает NULL, чтобы иметь возможность очистить буфер обмена. ( I7d2e9 ) -
ReceiveContentListener
преобразуется в функциональный интерфейс. ТакжеModifier.receiveContent
Повторная перегрузка, которая принимает Lambda, удаляется, посколькуReceiveContentListener
теперь является интерфейсом функции. -
Modifier.receiveContent
переименован вModifier.contentReceiver
. ( I1e6af ) -
TransferableContent.consumeEach
вTransferableContent.consume
. ( I1e462 ) -
rememberTextFieldState
закончила стабильный API. ( I37999 )
Исправления ошибок
- Исправлена ошибка, в которой вариант
BasicTextField(state)
не работал с клавиатурами CJK (на основе композиции). ( I54425 ) - Исправлена ошибка, в которой
Modifier.dragAndDropTarget()
может ссылаться на устаревшие данные в определенных сценариях сModifier.Node
повторный использование. ( I05BB1 ) - Вернуло недавнее изменение контракта, в котором
AnchoredDraggableState#anchoredDrag
вызовы будут обновляться в конце операцииanchoredDrag
. ( I95715 )
Версия 1.7.0-альфа05
20 марта 2024 г.
androidx.compose.foundation:foundation-*:1.7.0-alpha05
выпущена. Версия 1.7.0-alpha05 содержит эти коммиты .
Изменения API
- Удален экспериментальный композиция
LocalTextLinkStyle
Local для стиля гиперссылок. ( IEBFA7 ) - Удален экспериментальный переопределение
BasicText
с помощьюonLinkClicked
Arcome. Замена API для поддержки гиперссылок будет следовать в будущем. ( I107d5 ) - Удаленные методы и свойства, связанные с кодепоинтами, под
TextFieldState
иTextFieldBuffer
. Также удалили суффиксыinChars
из оставшихся API, связанных с выбором и композицией. ( IEF7CE ) -
AnchoredDraggable
currentValue
теперь будет обновляться при прохождении через якорную точку. ИспользуйтеsettledValue
, чтобы получить предыдущую семантикуcurrentValue
, обновив только при оседании на якоре. Прогресс теперь выявляется как функция (требующая начальной и конечной точки) вместо свойства. ( IBE6E8 , B/318707189 , B/298271489 , B/294991954 ) -
BasicTextField(state)
,TextFieldState
,InputTransformation
,OutputTransformation
,TextFieldLineLimits
,TextFieldDecorator
( I9582b ) - Введен
InterceptPlatformTextInput
для помощи в написании низкоуровневых тестов, связанных с IME, и других низкоуровневых вариантов использования IME.PlatformTextInputTestOverride
устарел. ( I862ed , b/322680547 ) - Split
restrictedConstraints()
на два метода:fitPrioritizingWidth()
иfitPrioritizingHeight()
( i6d7fd )
Внешний вклад
- Добавлено 2 новых API
isLastScrollForward
/isLastScrollBackward
чтобы проверить направление прокрутки для последнего действия прокрутки, верните False, если пока нет действия прокрутки. ( I63a0e )
Версия 1.7.0-альфа04
6 марта 2024 г.
androidx.compose.foundation:foundation-*:1.7.0-alpha04
выпускается. Версия 1.7.0-alpha04 содержит эти коммиты .
Изменения API
- Поддержка стилуса функции почерка на устройствах после Android U. ( i002e4 )
- Добавлены
hintLocales
вKeyboardOptions
, чтобы предоставитьTextFields
возможность намекнуть на IMES конкретными локалами для предварительного выставления предпочтительного языка. ( ID18C2 ) - Удалили экспериментальные перегрузки
BasicTextField2
иBasicSecureTextField
, которые принялиvalue: String
иonValueChange: () -> String
параметры. ( I568b4 ) - Добавьте необязательную функцию
applySemantics
вInputTransformation
, чтобы повлиять на семантикуBasicTextField2
, к которой она применяется. ( I74a2f , b/170648072 ) - В этом CL мы добавляем семантическое действие
GetScrollViewportLength
, чтобы мы могли подготовить информацию о компонентах, прокручиваемых в системе A11Y. Этот CL также применяет использование указанного имущества в прокручиваемых списках Foundation. ( IC5FA2 ) -
BasicTextField2
переименован вBasicTextField
. ( IE5713 ) -
FocusRequester.createRefs
теперь стабилен ( i4d92c , b/261436820 ) - Введен
DelegatableNode.scrollIntoView()
чтобы разрешить модификаторные узлы для прямого запросаscrollIntoView
. ( I2b3b7 , b/299939840 ) - Введен
DelegatableNode.requireView()
, чтобы позволить модификаторам узлы для получения текущегоView
Android без чтения локального композиции. ( I40768 ) - Внедрение информации о контекстном макете в области контекстуальной области строки потока и применения столбца контекстуального потока, включающая индекс линии, позицию и ограничения на максимальную ширину и высоту, чтобы оставаться в указанной положении. Элементы, превышающие максимальную ширину/высоту, могут переходить к следующей строке или быть опущены на основе настройки переполнения. ( Id13f8 , b/292114798 )
Исправления ошибок
- Исправлена ошибка, в которой в определенных условиях переключение
enabled
или атрибутыreadOnly
TextField
, вызовут сбой. ( IAE17B )
Версия 1.7.0-альфа03
21 февраля 2024 г.
androidx.compose.foundation:foundation-*:1.7.0-alpha03
выпускается. Версия 1.7.0-alpha03 содержит эти коммиты.
Изменения API
- Введен
DelegatableNode.requireLayoutCoordinates()
LayoutCoordinates
способ получить текущиеModifier.Node
onPlaced
( IA8657 ) - Введен
DelegatableNode.currentLayoutCoordinates
как способ получить текущиеLayoutCoordinates
onPlaced
Modifier.Node
. ( IAEBAA ) - Оптимизация производительности в
DraggableAnchors
, используемыхAnchoredDraggable
. ( I89cff ) -
BasicTextField2
и связанные с ними API -интерфейсы вandroidx.compose.foundation.text2
Пакет перемещены наandroidx.compose.foundation.text
. ( I9f635 ) -
BasicTextField2
больше не принимает параметрCodepointTransformation
. ИспользуйтеBasicSecureTextField
илиOutputTransformation
. ( Id34ff ) - Добавлен метод для сравнения только аннотаций двух
AnnotatedStrings
. ( I32659 ) - Введение
ContextualFlowRow
и улучшенногоFlowRow
/Column
сMaxLines
иOverflow
. Мы рады объявить об усовершенствованиях экспериментальнойFlowRow
иFlowColumn
, в настоящее время показываяmaxLines
и поддержку переполнения, наряду с дебютомContextualFlowRow
иContextualFlowColumn
. Это обновление предназначено для обеспечения оптимальных компонентов производительности, гдеContextualFlow*
идеально подходит для большого количества элементов, использующих небольшую конфигурациюmaxLines
и Dynamic +N, см. Больше кнопок, аFlowRow
иFlowColumn
идеально подходит для небольшого количества элементов, менее 100 элементов. Важно: для поддержания существующего поведения вFlowRow
илиFlowColumn
, где все элементы составляются независимо от того, соответствуют ли они максимум поперечной оси, установитеoverflow
дляFlowRowOverflow.Visible
илиFlowColumnOverflow.Visible
во время инициализации. ИсследуйтеContextualFlowRowSample
иFlowRowSample
для примеров этих новых функций в действии. ( IB9135 , B/293577082 )
Исправления ошибок
- Анимация курсора больше не запрашивает кадры между состояниями на и за ее пределами. ( IA2253 )
- Клавианые конструкторы
KeyboardOptions
теперь правильно скопируют все свойства. ( If12de )
Версия 1.7.0-альфа02
7 февраля 2024 г.
androidx.compose.foundation:foundation-*:1.7.0-alpha02
выпускается. Версия 1.7.0-alpha02 содержит эти коммиты.
Изменения API
-
HorizontalPager
,VerticalPager
иPagerState
продвигаются до стабильного. ( I67660 , B/316966909 ) - Добавлена локальная композиция
LocalTextLinkStyle
Local, которая позволяет изменить стиль ссылок в тексте через приложение. Если вы используете свою собственную тему в приложении, вы должны установить эту композицию в соответствии с вашей темой. При использовании темы материала цвет ссылки по умолчанию будет установлен на основной цвет материала. ( I7eb10 ) - Введенный модификатор
receiveContent
, который предоставляет разработчикам способ получить богатый контент в JetPack Compose. -
receiveContent
интегрируется сBasicTextField2
, чтобы принять богатый контент, предоставляемый программной клавиатурой, или через действие в буферном обмене. ( I81b72 ) - В этом изменении мы заменяем
SnapFlingBehavior
наTargetedFlingBehavior
в пейджере, чтобы разблокировать другие варианты использования и обеспечить большую гибкость. ( I762ea ) - В этом изменении мы делаем конюшню API. Мы также очищаем часть кода тестирования и добавляем больше образцов в съемку. ( Id8da9 )
- Введите
TargetedFlingBehavior
,FlingBehavior
, который позволяет распространять информацию о состоянии продолжающейся анимации и его смещении Target Scroll. ( I6a207 )
Исправления ошибок
-
BasicTextField2
теперь поддерживает курсор во время печати, когда он был прокручен из виду или будет выходить из виду из -за ввода. ( IEB856 , B/237190748 )
Внешний вклад
- Добавляет экспериментальный API для настройки поведения лазилоков предварительного выфширования. ( I022A4 )
Версия 1.7.0-альфа01
24 января 2024 г.
androidx.compose.foundation:foundation-*:1.7.0-alpha01
выпускается. Версия 1.7.0-alpha01 содержит эти коммиты.
Новые возможности
- Добавлен новый
Indication API
,IndicationNodeFactory
. Это приводит к более эффективным реализациямIndication
по сравнению с предыдущими (теперьrememberUpdatedInstance
) API API. Для получения информации о миграции см. Developer.android.com . -
clickable / combinedClickable / selectable / toggleable
теперь принимает нулевой параметрMutableInteractionSource
.Indication
NULL, и предоставленнаяIndication
являетсяIndicationNodeFactory
. Если вы не поднимаете и используетеMutableInteractionSource
, рекомендуется пройти NULL.
Изменения API
- Ввести
DecayAnimation
вAnchoredDraggable
, это изменение добавляет параметрdecayAnimationSpec
вAnchoredDraggable
, позволяющий использовать анимацию распада при оседании одного из якоря. Изменение также включает в себя переименование существующихanimationSpec
вsnapAnimationSpec
, чтобы помочь понять использование случая каждой спецификации. -
BasicTextField2
доступен для экспериментального использования. Это должно быть примерно в функционировании сBasicTextField
, и поведение должно быть готовым к производству. Тем не менее, API пока остается экспериментальным. Перед стабилизацией он будет переименован вBasicTextField
и перенесен в тот же пакет. - Представил первый черновик API
OutputTransformation
дляBasicTextField2
. Этот API заменяет большинство вариантов использованияVisualTransformation
в старомBasicTextField
. Однако это еще не завершено, и некоторые вещи не будут работать правильно, но мы будем признателен за любые отзывы об удобстве использования API для ваших вариантов использования. ( AOSP/2708848 ) - Введено
LinkAnnotation
, которое позволяет добавлять ссылки и клики в текст. Особенность ссылок еще не завершена, и наступает больше изменений API. - Введенный модификатор
receiveContent
, который предоставляет разработчикам способ получить богатый контент в JetPack Compose. -
receiveContent
интегрируется сBasicTextField2
, чтобы принять богатый контент, предоставляемый программной клавиатурой, или через Paste из буфера обмена. -
KeyboardOptions.shouldShowKeyboardOnFocus
позволяет отключить поведение по умолчаниюBasicTextField
с запросом программной клавиатуры на фокусе. -
TextInputService
иLocalTextInputService
теперь устаревают. Вместо этого используйтеPlatformTextInputModifierNode
для непосредственной интеграции с API платформы IME. ( AOSP/2862698 ) -
Indication#rememberUpdatedInstance
что вырвалось на устаревшее. Он имеет высокий неизбежный штраф за производительность и предотвращает другие оптимизации. Вместо этого вы должны использовать новый APIIndicationNodeFactory
.
Исправления ошибок
-
BasicTextField
теперь будет предварительно предоставлять небольшой выбор сопоставлений о смещении при прохожденииVisualTransformation
. Это помогает поймать общие ошибки кодирования, которые приводят к невозможным исключениям в более поздних измерениях или проходах. Благодаря композиции, скорее всего, разработчики увидят эти ошибки во время разработки, помогая избежать сбоев производства. ( I0fd42 ) -
VisualTransformation
не будет выбросить, если вы вернете неверный индекс для неверного индекса ( B/316401857 )
Версия 1.6
Версия 1.6.8
12 июня 2024 г.
androidx.compose.foundation:foundation-*:1.6.8
выпускается. Версия 1.6.8 содержит эти коммиты .
Версия 1.6.7
1 мая 2024 г.
androidx.compose.foundation:foundation-*:1.6.7
выпускается. Версия 1.6.7 содержит эти коммиты .
Версия 1.6.6
17 апреля 2024 г.
androidx.compose.foundation:foundation-*:1.6.6
выпускается. Версия 1.6.6 содержит эти коммиты .
Исправления ошибок
- Исправлена ошибка, в которой в определенных условиях переключение
enabled
или атрибутыreadOnly
TextField
, вызовут сбой. ( IAE17B )
Версия 1.6.5
3 апреля 2024 г.
androidx.compose.foundation:foundation-*:1.6.5
выпускается. Версия 1.6.5 содержит эти коммиты .
Исправления ошибок
- Добавляет журналы отладки в трудные ошибки в строке/столбце: ( B/300280216 и B/297974033 )
Версия 1.6.4
20 марта 2024 г.
androidx.compose.foundation:foundation-*:1.6.4
выпускается. Версия 1.6.4 содержит эти коммиты .
Исправления ошибок
- Жест отбора с длинным прессом и драгами, который выходит из границ макета текста в первом кадре сопротивления, больше не сбои. ( ICDF90 , B/325307463 )
Версия 1.6.3
6 марта 2024 г.
androidx.compose.foundation:foundation-*:1.6.3
выпущена. Версия 1.6.3 содержит эти коммиты .
Версия 1.6.2
21 февраля 2024 г.
androidx.compose.foundation:foundation-*:1.6.2
выпущена. Версия 1.6.2 содержит эти коммиты.
Исправления ошибок
- Исправить
AnimateContentSize
не сбросить должным образом. ( I07051 ) - Исправить проблему, где в некоторых обстоятельствах будет
intrinsicHeight
текста. ( 3CD398 , B/217910352 )
Версия 1.6.1
7 февраля 2024 г.
androidx.compose.foundation:foundation-*:1.6.1
выпускается. Версия 1.6.1 содержит эти коммиты.
Исправления ошибок
- Исправьте шахмальную меру сетки при прокрутке через предел. ( BFFC39 )
- Добавьте проверку для макета с большими размерами. ( E74AF5 )
- Исправьте размещение предметов размером 0 в начале шахматной сетки. ( 785F94 )
- Позвоните в обратный вызов в том же порядке, что и OnForGotten. ( 31ce3b )
Версия 1.6.0
24 января 2024 г.
androidx.compose.foundation:foundation-*:1.6.0
выпускается. Версия 1.6.0 содержит эти коммиты.
Важные изменения с версии 1.5.0
- Новый
Modifier.anchoredDraggable
модификатора. AnchoredDraggable, который разблокирует способность перетаскивать и оживить между предопределенным набором якорей. Этот модификатор предназначен для замены дляModifier.swipeable
. Узнайте , как его использовать и мигрировать изModifier.swipeable
. - Была добавлена функциональность перетаскивания между приложениями и компонентами. Обратитесь к
DragAndDropTarget
,Modifier.dragAndDropSource
и другим API, чтобы начать -
Modifier.draggable2D
- это новый модификатор, который обеспечивает легкую поддержку 2D -перетаскивания. См. Образец . -
AndroidExternalSurface
иAndroidEmbeddedExternalSurface
были добавлены, чтобы облегчить добавление поверхностных компонентов в Compose - Различные изменения и улучшения API в
Pager
иsnapFlingBehaviour
- Различные фокусы, текст и вставки API были продвинуты на стабильные APIS
Версия 1.6.0-rc01
10 января 2024 г.
androidx.compose.foundation:foundation-*:1.6.0-rc01
выпускается. Версия 1.6.0-rc01 содержит эти коммиты.
Изменения API
- Расширение
DragAndDropTarget()
удлинители был удален. Создайте новый экземпляр с помощьюobject: DragAndDropTarget {}
. ( I32318 )
Версия 1.6.0-бета03
13 декабря 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-beta03
выпускается. Версия 1.6.0-beta03 содержит эти коммиты.
Исправления ошибок
- Исправить сбой, который повлиял на очень большой текст, измеренный с помощью бесконечных ограничений. ( I1a7df , b/312294386 )
-
PlatformImeOptions
теперь является конкретным классом, а не интерфейсом. ( IF40A4 )
Версия 1.6.0-бета02
29 ноября 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-beta02
выпускается. Версия 1.6.0-beta02 содержит эти коммиты.
Исправления ошибок
- Исправление для
canScroll
не обновляется после прокрутки только для реле. ( I60a86 ) - Исправлено для
Modifier.animateItemPlacement()
иLookaheadScope
после небольших свитков. ( I3a2b7 )
Версия 1.6.0-бета01
15 ноября 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-beta01
выпускается. Версия 1.6.0-beta01 содержит эти коммиты.
Изменения API
- Модификатор
DragAndDropTarget
теперь явно принимает приемаDragAndDropTarget
и имеет лямбду, чтобы выбрать сеанс перетаскивания. Сейчас есть две заводские функции дляDragAndDropModifierNode
. Один для получения переводов и один для передачи данных ( i69481 ) - Обновленная
maximumFlingVelocity
, которая будет представлена как Float. Обновленная документация, чтобы быть более ясной в отношении единстваmaximumFlingVelocity
. ( I8Adc7 ) onDragAndDropStart
на фабрикеDragAndDropModifierNode
был переименован вacceptDragAndDropTransfer
.acceptsDragAndDropTransfer
был добавлен вModifier
dragAndDropTarget
, чтобы принять с сеанса перетаскивания. Эта Lambda возвращает жизнеспособнуюDragAndDropTarget
если заинтересован в сессии перетаскивания. Другие Lambdas для обработки событий сопротивления были заменены на это.Функция заводской фабрики
DragAndDropTarget
была добавлена для получения с сеансов перетаскивания ( IEBF3A )Открытие
startDragImmediately
вAnchoredDraggable
дает контроль для обнаружения жестов перетаскивания при его использовании. Полезно установить его, когда виджет анимирует целевой якорь. См. Образец . ( IE6D13 , B/285139987 )API Foundation Tooltip теперь
@ExperimentalFoundationApi
( i30b0b )Удален
DragAndDropInfo
как типDragAndDropModifierNode.drag
теперь принимает параметры дляtransferData
, размер украшения и украшенияDrawScope
LambdaDragAndDropTarget
имеет методы для определенных событий перетаскивания и выпадения вместо того, чтобы быть единственным абстрактным методомonDragAndDropEvent
в заводской функции дляDragAndDropModifierNode
был переименован вonDragAndDropStart
, чтобы лучше сообщить, что предоставленнаяDragAndDropTarget
действителен только для данного перетаскивания и сброса.DragAndDropEventType
был удален ( i645b1 )Переименованная
PlatformTextInputModifierNode.runTextInputSession
establishTextInputSession
. ( I03CD0 )Замените
OriginalText
текстаTextSubstitution
. ( IFA5A8 )Переименованная
PlatformTextInputModifierNode.textInputSession
модификация.textInpessessessessest дляrunTextInputSession
. ( IE9C6B )Дети
SubcomposeLayout
(и такие макеты, какLazyColumn
основанные на нем), которые сохраняются для повторного использования в будущем, считаются деактивированными. НовыйassertIsDeactivated()
тестовый API был введен для проверки таких узлов. Остальная часть испытательных API будет отфильтровывать деактивированные узлы по умолчанию. ( I2ef84 , b/187188981 )Параметр
Modifier.magnifier
clippingEnabled
clip
Параметр
magnifierCenter
Modifier.magnifier
сделан нулевым сохранением того же поведения по умолчанию. ( I6aa66 )Материальные API
SwipeToReveal
(для карт и чипов) теперь полагаются на API на основе слотов (как рекомендовано Compose) вместо экземпляров на основе класса данных для создания этих слотов. Это нарушающее изменение, см. Демо и примеры кода для примеров, как использовать новый API. ( IA8943 )
Исправления ошибок
- Реализуйте равенство и хэш-код для
PageSize.Fixed
. ( Ие3еде , б/300134276 ) - Исправлена ошибка, которая приведет к тому, что макет
BasicText
не сокращается, когдаminWidth
изменилась, аminWidth
меньше, чем ограничения начальной меры,maxWidth
( IDB19C ) - Добавьте поддержку средства визуализации для Sweep Gradient в
ArcLine
. ( I4d5bb ) - Исправьте проблему бинарной совместимости с изменением вставки в окне ( IEE695 )
- Удалите основной слой материала для чипа/кнопки Material3, поскольку без него микротесты показывают лучшую производительность. ( I55555 )
Версия 1.6.0-альфа08
18 октября 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-alpha08
выпускается. Версия 1.6.0-alpha08 содержит эти коммиты.
Новые возможности
-
Modifier.draggable2D
- это новый модификатор, который обеспечивает легкую поддержку 2D -перетаскивания. См. Пример ( ID95F5 , B/214412658 )
Изменения API
-
Modifier.dragAndDrawSource
имел лямбдаonDrawDragShadow
переименованную вdrawDragDecoration
, иDragAndDropInfo
имел параметр размера, переименованный вdragDecorationSize
. ( Id0e30 , b/303904810 ) - Параметр
decorationBox
BasicTextField2
переименован вdecorator
. Его тип также изменяется на эквивалентный забавный интерфейсTextFieldDecorator
. ( I23c1c )
Исправления ошибок
- Улучшенная документация по
BasicTextField
в отношении требованийonValueChange
. ( I90fc9 , b/160257648 )
Версия 1.6.0-альфа07
4 октября 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-alpha07
выпущен. Версия 1.6.0-alpha07 содержит эти коммиты.
Изменения API
- Представлен
PlatformTextInputMethodTestOverride
для написания тестов для пользовательских текстовых редакторов. ( ID159b ) - Переименованная в
GraphicsSurface
вAndroidExternalSurface
( i11680 ) - Добавлен
DisableNonLinearFontScalingInCompose
линейный флаг, чтобы отключить нелинейное масштабирование шрифтов. УстановитеDisableNonLinearFontScalingInCompose = true
в ваших тестах, если вам нужно время для их очистки. Этот флаг будет удален в Compose 1.6.0-BETA01. ( IC9486 ) - Добавлены
ColorList
иColorSet
Collections, которые избегают распределений. ( I744bd ) - Это изменение устраняет
shortSnapVelocityThreshold
, которая была превращена в детали реализации реализацийSnapLayoutInfoProvider
. ( I65f6d ) - Добавляет модификатор
dragAndDropSource
для начальных сеансов перетаскивания и модификатораdragAndDropTarget
для получения с сеансов перетаскивания ( IB7828 , B/286038936 ) - Обновите
SnapPositionInLayout
документацию и метод положения. Введите контент -пачки в метод положения вSnapPositionInLayout
. ( ID7938 , B/300116110 ) -
UndoState
что вTextFieldState
предоставлена возможность отменить/переделать изменения, внесенные пользователем. ( ICC024 )
Исправления ошибок
- Исправлен
basicMarquee
не анимируя после изменения скорости. ( Id2e77 , b/297974036 )
Версия 1.6.0-альфа06
20 сентября 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-alpha06
выпускается. Версия 1.6.0-alpha06 содержит эти коммиты.
Новые возможности
- Новые композиционные обертки для
SurfaceView
иTextureView: GraphicsSurface()
иEmbeddedGraphicsSurface()
. Это экспериментальный API и подвержен изменениям и модификациям. ( I9ddb2 ) -
Modifier.magnifier()
теперь стабильный API. Это включает в себя удалениеMagnifierStyle
в пользу встроенных параметров в самом модификаторе. ( I83BEC , B/298381260 , B/262367109 , B/261438887 )
Изменения API
- Введенная
updateCurrentPage
иupdateTargetPage
ВScrollScope
, это последние части, необходимые для обеспечения настройки анимированного прокрутки черезPagerState.scroll
. ( I9cad5 , b/2677444105 , b/243786897 ) - Удалить плотность из
SnapFlingBehavior
. Все реализацииSnapLayoutInfoProvider
уже имеют способ получить доступ к плотности, можно удалить область приемника, что приведет к менее сложной реализации какSnapFlingBehavior
, так иSnapLayoutInfoProviders
. ( I153C3 ) - Больше модификаторов отмечены как стабильные. ( I56af1 , b/298046462 )
- Удален
SnapStepSize
изSnapLayoutInfoProvider
. Расчет должен быть выполнен с использованием информации о макете и предоставлена с помощью подхода или схватывания. ( If320c )
Изменения поведения
- Compose теперь использует нелинейное масштабирование шрифтов для лучшей читаемости и доступности. Когда шрифт шрифт> 100% в настройках системы, небольшой текст будет нормально увеличиваться, но уже более широкий текст только немного увеличится. Кроме того, высота линии, определенные в SP, автоматически приспосабливаются к тому, чтобы оставаться пропорциональными 100% -ную масштабную высоту. Смотрите лучшие практики масштабирования шрифта для получения дополнительной информации. ( I11518 )
Исправления ошибок
- Удалите использование
rememberSaveable
для подсказки инструментов. ( ICC131 , B/299500338 )
Версия 1.6.0-альфа05
6 сентября 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-alpha05
выпускается. Версия 1.6.0-alpha05 содержит эти коммиты.
Изменения API
- Добавьте перегрузки для
BasicSecureTextField
, которые принимают неизменное значение и обратный вызов, чтобы изменить это значение, как и текущий APIBasicTextField
. ( IA4882 ) - Добавить
Modifier.preferKeepClear()
, чтобы отметить так же, как предпочтение, чтобы не допустить плавающих окон на API 33 и выше. ( IB51D5 , B/297260115 ) - Скорости броска в виде компонентов, таких как
ScrollView
иRecyclerView
, ограничены наViewConfiguration.ScaledMaximumFlingVelocity
. Compose теперь содержит свою собственную версиюmaximumFlingVelocity
, которая теперь относится кDraggable
. ( IBF974 ) - Удаленное устаревшее
Pager
и перегрузкиPagerState
. ( IEA07E ) - Добавлен
BasicTooltipBox
дляcompose.foundation
и обновленногоPlainTooltipBox
иRichTooltipBox
для использованияTooltipBox
с новыми композициямиPlainTooltip
иRichTooltip
. ( I79e1d )
Версия 1.6.0-альфа04
23 августа 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-alpha04
выпускается. Версия 1.6.0-alpha04 содержит эти коммиты.
Изменения API
- Добавьте интерфейс
ReusableComposition
для управления жизненным циклом и повторного использования подкомпозиций. ( I812d1 , б/252846775 ) -
Modifier.focusGroup
был продвинут до стабильных API. ( I7ffa3 ) - Добавьте перегрузки для
BasicTextField2
, которые принимают неизменное значение и обратный вызов, чтобы изменить это значение, как и текущий APIBasicTextField
. ( I3f2b8 ) -
GridItemSpan::currentLineSpan
теперь стабильный API. ( ICC29C ) - Canvas, который принимает
contentDescription
, теперь является стабильным API. ( IB3D29 ) - Введен
viewportSize
вScrollState
, способ узнать размерviewPort
компонента, который используетScrollState
после измерения. ( I8b85a , b/283102682 ) - Исправлена проблема, в которой предварительная выборка в пейджере не соответствовала поведению в взглядах. ( I93352 , B/289088847 )
-
Modifier.consumeWindowInsets(PaddingValues)
теперь стабилен.-
Deprecated Modifier.consumedWindowInsets
API ConsumedWindowinsets теперь удален. Вместо этого используйтеModifier.consumeWindowInsets
. ( ID72BB )
-
Версия 1.6.0-альфа03
9 августа 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-alpha03
выпускается. Версия 1.6.0-alpha03 содержит эти коммиты.
Изменения API
- Перегрузка
LazyLayout
добавлена, он принимает лямбдуLazyLayoutItemProvider
, а не простой объект, как это было раньше. Предыдущая перегрузка устарела. ( I42a5a ) - Добавлена поддержка для настройки
privateImeOptions
( IDB772 )
Исправления ошибок
- Исправлены текстовые поля, отображающие клавиатуру и доступные для редактирования, если
readOnly
установлено значение true. Также исправлена ошибка, из-за которой клавиатура не отображалась, когдаreadOnly
менялось с true на false во время фокусировки. ( I34a19 , б / 246909589 )
Версия 1.6.0-альфа02
26 июля 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-alpha02
выпускается. Версия 1.6.0-alpha02 содержит эти коммиты.
Изменения API
- Представил
PagerLayoutInfo
с информацией, собранной после прохода меры вPager
. Также представилPageInfo
, информация о одной измеренной странице вPager
. ( IAD003 , B/283098900 ) - Дополнительные аннотации для указания разрешенных входных данных для компонуемых объектов ( I51109 )
- Добавлен
SemanticsNodeInteraction.requestFocus
как более удобный и обнаруженный способ запросить фокус в тестах. ( IE8722 ) - Полностью переработанный
PlatformTextInput*
IPI. ( I6c93a , b/2746611182 , b/267235947 , b/277380808 ) -
SoftwareKeyboardController
иLocalSoftwareKeyboardController
больше не экспериментальны.LocalSoftwareKeyboardController
также теперь является правильнымCompositionLocal
. ( I4c364 ) -
Modifier.transformable
теперь предоставляет Pan Delta в параметреcanPan
, чтобы помочь определить направление сковороды, позволяющего его разрешить. ( I692AA , B/266829800 ) - Обновления модификатора
consumeWindowInsets
для расширения SuperClassAbstractComposeView
( IACD74 , B/269479941 )
Версия 1.6.0-альфа01
21 июня 2023 г.
androidx.compose.foundation:foundation-*:1.6.0-alpha01
выпускается. Версия 1.6.0-alpha01 содержит эти коммиты.
Новые возможности
- Представил новый
AnchoredDraggable
API в Foundation. Его можно использовать для создания компонентов, которые можно перетаскивать между дискретными состояниями, такими как модальные нижние листы. Этот API заменяетSwipeable
API материала. ( I4a2ed )
Изменения API
- Поддержка
InputConnection#requestCursorUpdates
( i0c69b ) - Представил
scrollAnimationSpec
, чтобы разрешить пользовательские анимационные характеристики. ОбновленоBringIntoViewCalculator
дляBringIntoViewScroller
. ( IDB741 ) - Добавить тип
ResourceResolutionException
, чтобы обернуть броски, брошенные при попытке загрузить растровые активы с описанием пути актива, который не удалось загрузить. ( I19F44 , B/230166331 , B/278424788 ) - Добавлены свойства семантики и действия для поддержки текстового перевода. ( I4a6bc )
- Представил API
BringIntoViewCalculator
, который можно использовать для настройки того, как компоненты, такие какScrollable
ответы наbringIntoView
. Изменил перегрузку прокрутки, чтобы необязательно принять экземплярBringIntoViewCalculator
. ( Iaf5af )
Исправления ошибок
- Добавлен проверка ворса, чтобы предупредить, если вы создаете
MutableInteractionSource
в композиции, не запомнив его, аналогично проверкам ворса для создания изменяемого состояния /Animatable
. ( I5daae ) - Добавлена поддержка для выбора мыши. Отбор на основе прикосновения будет расширяться по слову и сокращаться по характеру. ( IC0C6C , B/180639271 )
- Добавлен интерфейс
FocusTargetModifierNode
, который можно использовать для создания пользовательскойFocusTarget
. ( I9790e )
Версия 1.5
Версия 1.5.4
18 октября 2023 г.
androidx.compose.foundation:foundation-*:1.5.4
выпущен. Версия 1.5.4 содержит эти коммиты.
Версия 1.5.3
4 октября 2023 г.
androidx.compose.foundation:foundation-*:1.5.3
выпущен. Эта версия не имеет изменений.
Версия 1.5.2
27 сентября 2023 г.
androidx.compose.foundation:foundation-*:1.5.2
выпущен. Версия 1.5.2 содержит эти коммиты.
Исправления ошибок
- Исправлена ошибка в тексте, которая привела к сбоям в определенных обстоятельствах, когда семантика была признана недействительной.
Версия 1.5.1
6 сентября 2023 г.
Выпущен androidx.compose.foundation:foundation-*:1.5.1
. Версия 1.5.1 содержит эти коммиты.
Исправления ошибок
- Исправлены текстовые поля, отображающие клавиатуру и доступные для редактирования, если
readOnly
установлено значение true. Также исправлена ошибка, из-за которой клавиатура не отображалась, когдаreadOnly
менялось с true на false во время фокусировки. ( I34a19 , б / 246909589 )
Версия 1.5.0
9 августа 2023 г.
androidx.compose.foundation:foundation-*:1.5.0
выпущен. Версия 1.5.0 содержит эти коммиты.
Важные изменения с версии 1.4.0
- Многие основополагающие модификаторы, в
Modifier.scrollable
числеModifier.clickable
.Modifier.draggable
,Modifier.Node
. - Улучшения в стабильности пейджеров. Многие ошибки были адресованы.
- Параметры
pageCount
сейчас живет вPagerState
, а не на самом пейджере
Версия 1.5.0-rc01
26 июля 2023 г.
androidx.compose.foundation:foundation-*:1.5.0-rc01
выпускается. Версия 1.5.0-rc01 содержит эти коммиты.
Исправления ошибок
Доступна дополнительная проверка, рекомендующая перенести вызовы
mutableStateOf()
в соответствующие им специализированные типы для примитивов. Его идентификатор lint —AutoboxingStateCreation
. Ранее эта проверка была включена по умолчанию для всех проектов. Чтобы увидеть это предупреждение в редакторе Android Studio и в результатах lint вашего проекта, измените его серьезность с информационного на предупреждение (или выше), объявивwarning "AutoboxingStateCreation"
внутри конфигурации вашего модуляbuild.gradle
илиbuild.gradle.kts
, как показано ( I34f7e ):android { lint { warning "AutoboxingStateCreation" } ... }
Версия 1.5.0-бета03
28 июня 2023 г.
androidx.compose.foundation:foundation-*:1.5.0-beta03
: 1.5.0-бета03 выпускается. Версия 1.5.0-beta03 содержит эти коммиты.
Версия 1.5.0-бета02
7 июня 2023 г.
androidx.compose.foundation:foundation-*:1.5.0-beta02
: 1.5.0-бета02 выпускается. Версия 1.5.0-beta02 содержит эти коммиты.
Версия 1.5.0-бета01
24 мая 2023 г.
androidx.compose.foundation:foundation-*:1.5.0-beta01
: 1.5.0-бета01 выпускается. Версия 1.5.0-beta01 содержит эти коммиты.
Изменения API
- Реализуйте
PlatformDataProvider
для обеспечения частоты сердечных сокращений и ежедневных шагов. ИнтерфейсSensorGateway
удаляется из публичного API. ( I55b84 )
Исправления ошибок
- Уменьшите ассигнования во время ленивого списка/сетки/и т. Д. измерения ( iaf9e2 )
- Снижение распределения при применении снимков ( i65c09 )
- Удалены выделения из весенних анимаций ( Ie9431 ).
- Удаленное распределение из
TextLayout
( i0fd11 ) - Удалили множественные ассигнования в отслеживании скорости указателя ( i26bae )
Версия 1.5.0-альфа04
10 мая 2023 г.
androidx.compose.foundation:foundation:1.5.0-alpha04
и androidx.compose.foundation:foundation-layout:1.5.0-alpha04
выпускаются. Версия 1.5.0-alpha04 содержит эти коммиты.
Изменения API
- Добавлены оптимизированный
TextStyle.merge(...)
с полным списком параметров. ( IAD234 , B/246961787 ) - Представьте
SnapLayoutInfoProvider
, который можно использовать сLazyGridState
. ( I92134 , B/269237141 , B/260914964 ) - Экспериментальный
Modifier.animateItemPlacement()
был добавлен для Lazy Shaggered Grids Extame. Вы можете применить его на элементы, чтобы достичь анимации с изменением/переупорядочкой позиции автоматизации. ( I4b62d , b/257034719 ) - Продвигайте
GridCells.FixedSize
до стабильного.FixedSize
ОпределяетLazyGrid
, где каждая ячейка принимает точный размер на поперечной оси, а оставшееся пространство распределяется по расположению поперечной оси. ( I8542f ) - Введенный прицел приемника
PagerScope
для пейджера и функция утилиты для расчета смещения данной страницы. ( IF2577 ) - Введите
snapPositionalThreshold
при создании поведения Snap Fling. Используйте этот параметр, чтобы указать позиционный порог для короткого щелчка в пейджере. ( If8f7f ) - Заменил
SnapLayoutInfoProvider.calculateSnappingOffsetBounds
сcalculateSnappingOffset
. В этом новом методе мы просто просим следующее смещение, чтобы сделать. Расчет границ должен быть выполнен на уровне реализации, так как это может отличаться в зависимости от того, как нужно, чтобы произойти. ( I923a4 ) - API -интерфейсы
LazyStaggeredGrid
были повышены до стабильной. ( I633a5 ) - Удалите
pageCount
изHorizontal/VerticalPager
. Это должно быть предоставлено при создании государства. ОбновленоPagerState
иrememberPagerState
как PageState принятьpageCount
. ( IEB52D , B/266965072 ) - Удалите
pageCount
изHorizontal/VerticalPager
. Это должно быть предоставлено при создании государства. ОбновленоPagerState
иrememberPagerState
как PageState принятьpageCount
. ( IFA3CB , B/266965072 ) - Представьте
shortSnapVelocityThreshold
в пейджереSnapFlingBehavior
. ( I7379e , b/275579012 ) - Добавляет
FlowRowScope
иFlowColumnScope
. ( I54fe2 )
Исправления ошибок
- Вызовы, чтобы получить семантику в тексте, когда ограничения имеют
minWidth
, аminHeight
больше не потерпел крах. ( IBD072 ) - Фиксированная регрессия, где клавиатура не отображалась для текстовых полей внутри диалогов, не созданных
Dialog
композицией. ( I82551 , B/262140644 )
Версия 1.5.0-альфа03
19 апреля 2023 г.
androidx.compose.foundation:foundation:1.5.0-alpha03
и androidx.compose.foundation:foundation-layout:1.5.0-alpha03
выпускаются. Версия 1.5.0-alpha03 содержит эти коммиты.
Этот выпуск позволяет новой стек рендеринга текста для Compose. Новый стек оптимизирован производительность, и вы не увидите видимых изменений.
Если вы видите изменения в визуализированном тексту, вы можете отлаживать, установив NewTextRendering1_5 = false
чтобы подтвердить различие поведения. Установка это заставит переоборудование. Пожалуйста, подайте любые различия в поведении в качестве ошибок.
Флаг отладки будет удален до выпуска 1.5 Beta01 ( IADA23 , B/246960758 )
Изменения API
- Сделайте встроенный в линии
FlowColumn/FlowRow
. ( IDAB37 )
Версия 1.5.0-альфа02
5 апреля 2023 г.
androidx.compose.foundation:foundation:1.5.0-alpha02
и androidx.compose.foundation:foundation-layout:1.5.0-alpha02
выпускаются. Версия 1.5.0-alpha02 содержит эти коммиты.
Изменения API
- Добавлена поддержка ячеек фиксированного размера в
LazyGrid
и расположить их с помощью поперечной ось. ( I83ed9 , b/235121277 , b/267942510 ) - Добавлена поддержка полос фиксированного размера в
LazyStaggeredGrid
и организует их с расположением поперечной оси. ( I7d519 ) -
UrlAnnotation
S вAnnotatedString
S теперь может быть открыт через услуги доступности, такие какTalkBack
. ( IF4D82 , B/253292081 ) - Добавлено действие
InsertTextAtCursor
Semantics для текстовых полей. ( I11ed5 ) - Тестовые действия, связанные с текстами (например,
performTextInput
), теперь будут запрашивать фокус напрямую, используя действие семантики, вместо того, чтобы нажать на поле. ( I6ed05 ) - Добавляет поддержку между расстоянием/расположением поперечной оси с использованием
verticalArrangement
вFlowRow
иhorizontalArrangement
вFlowColumn
. Мы также удаляемverticalAlignment
иhorizontalAlignment
верхнего уровня вFlowRow/FlowColumn
. Разработчики могут использоватьModifier.align
Вместо этого. Это уменьшает путаницу между соглашениями об именованииverticalAlignment
иverticalArrangement
. ( I87B60 , B/268365538 )
Версия 1.5.0-альфа01
22 марта 2023 г.
androidx.compose.foundation:foundation:1.5.0-alpha01
и androidx.compose.foundation:foundation-layout:1.5.0-alpha01
выпускаются. Версия 1.5.0-alpha01 содержит эти коммиты.
Изменения API
- Текст и
BasicText
рефактируются для использования новой системы модификаторов. Это приводит к значительному улучшению производительности во многих случаях. Изменения не должны быть видны. ( If1d17 , b/246961435 ) - Добавлено действие Semantics
PerformImeAction
, чтобы вызвать действие IME на узлах текстового редактора. ( IC606F , B/269633506 )
Исправления ошибок
- Обновленные внутренние внутренности
Modifier.hoverable
. Hoverable. Модификаторhoverable
будет показан только в инспекторе только в том случае, если он включен. ( 182103 )
Версия 1.4
Версия 1.4.3
3 мая 2023 г.
androidx.compose.foundation:foundation:1.4.3
и androidx.compose.foundation:foundation-layout:1.4.3
выпускаются без изменений (только удар версии).
Версия 1.4.2
19 апреля 2023 г.
androidx.compose.foundation:foundation:1.4.2
и androidx.compose.foundation:foundation-layout:1.4.2
выпускаются. Версия 1.4.2 содержит эти коммиты.
Версия 1.4.1
5 апреля 2023 г.
androidx.compose.foundation:foundation:1.4.1
and androidx.compose.foundation:foundation-layout:1.4.1
are released. Версия 1.4.1 содержит эти коммиты.
Версия 1.4.0
22 марта 2023 г.
androidx.compose.foundation:foundation:1.4.0
and androidx.compose.foundation:foundation-layout:1.4.0
are released. Версия 1.4.0 содержит эти коммиты.
Важные изменения с версии 1.3.0
- Added Emoji compat integration to
Text
andTextField
, as well as the lower level Paragraph. It is enabled by default when emojicompat is configured. -
EmojiCompat
can be configured on a specific Text usingPlatformParagraphStyle
. - Added full line span support to
LazyStaggeredGrid
(I28252) - Adding experimental
onHover
toClickableText
(I6938f) - Introduced new experimental overloads for the
runComposeUiTest
function andcreate*ComposeRule
functions that acceptCoroutineContext
parameters. The context will be used for the test composition and anyLaunchedEffect
andrememberCoroutineScope()
calls in the composition. ( I10614 , b/265177763 ) -
FlowRow
andFlowColumn
are now available as@ExperimentalFoundationApi
that allow for a more flexible row and column based layout of components that will break to a new line if there is not enough space on the main axis. ( I3a7b2 ) -
Modifier.basicMarquee()
is available as experimental for displaying content with a scrolling marquee effect. ( I2df44 , b/139321650 )
Версия 1.4.0-rc01
8 марта 2023 г.
androidx.compose.foundation:foundation:1.4.0-rc01
and androidx.compose.foundation:foundation-layout:1.4.0-rc01
are released. Версия 1.4.0-rc01 содержит эти коммиты.
Изменения API
- Introduced new low-level
PlatformTextInputAdapter
API for building custom text input implementations that talk directly to platform APIs. ( I58df4 ) - Add support for reverse layout to
LazyStaggeredGrid
. ( I3ef4a )
Исправления ошибок
-
BasicTextField
'sSetText
semantics action will now update the text buffer using the same code path as IME updates and the testing functions (egperformTextReplacement
). - Text testing functions
performTextClearance
,performTextReplacement
, andperformTextSelection
now useSemanticsActions
. ( I0807d , b/269633168 , b/269624358 )
Версия 1.4.0-бета02
22 февраля 2023 г.
androidx.compose.foundation:foundation:1.4.0-beta02
and androidx.compose.foundation:foundation-layout:1.4.0-beta02
are released. Версия 1.4.0-beta02 содержит эти коммиты.
Изменения API
- Added a new
Modifier.Node.onReset()
callback allowing you to reset some local state to properly handle the case when theLayout
will be reused (for example as an item ofLazyColumn
). FixedFocusTargetModifierNode
to properly reset the focused state. ( I65495 , b/265201972 ) - Added
BlendMode
parameter toDrawScope.drawText
,Paragraph.paint
, andMultiParagraph.paint
methods to support different blending algorithms when drawing text on Canvas. ( I57508 ) - Removed the
modifierElementOf()
API. Please extend fromModifierNodeElement
directly instead. ( Ie6d21 )
Исправления ошибок
- Adjusting selection handles can no longer select a partial character. ( Idedd1 )
- Fix crash when ctrl+backspace on empty
TextField
( I0427f , b/244185537 )
Версия 1.4.0-бета01
8 февраля 2023 г.
androidx.compose.foundation:foundation:1.4.0-beta01
and androidx.compose.foundation:foundation-layout:1.4.0-beta01
are released. Версия 1.4.0-beta01 содержит эти коммиты.
Новые возможности
- Since 1.3, added Emoji compat integration to
Text
andTextField
, as well as the lower level Paragraph. It is enabled by default when emojicompat is configured. -
EmojiCompat
can be configured on a specific Text usingPlatformParagraphStyle
.
Изменения API
- Added common implementation of
PinnableContainer
API used in allLazyLayouts
to retain items that exit composition, but still need to be active. ( If45a4 ) -
PinnableContainer.PinnedHandle.unpin()
was renamed torelease()
( I4667a )
Внешний вклад
- Added
mainAxisItemSpacing
property toLazyListLayoutInfo
,LazyGridLayoutInfo
andLazyStaggeredGridItemInfo
( I52fad )
Версия 1.4.0-альфа05
25 января 2023 г.
androidx.compose.foundation:foundation:1.4.0-alpha05
and androidx.compose.foundation:foundation-layout:1.4.0-alpha05
are released. Версия 1.4.0-alpha05 содержит эти коммиты.
Новые возможности
- Added full line span support to
LazyStaggeredGrid
( I28252 ) - Adding experimental
onHover
toClickableText
( I6938f ) - Introduced new experimental overloads for the
runComposeUiTest
function andcreate*ComposeRule
functions that acceptCoroutineContext
parameters. The context will be used for the test composition and anyLaunchedEffect
andrememberCoroutineScope()
calls in the composition. ( I10614 , b/265177763 )
Изменения API
- Merges the pre/post APIs of
OverscrollEffect
into combined 'decorator'applyToScroll
andapplyToFling
functions. See the updated samples in the documentation for examples of how to implement an overscroll effect with the new API shape. ( I8a9c4 , b/255554340 ) - Больше типов/обнуляемости встроенных/устаревших скрытых функций ( I24f91 )
-
LineBreak
andHyphens
APIs inTextStyle
are graduated to stable. ( Ic1e1d )
Исправления ошибок
- The cursor in text fields will now continue to blink even when animations are disabled. ( I95e70 , b/265177763 )
-
Modifier.basicMarquee
now animates even when animations are disabled in the system settings. ( I23389 , b/262298306 , b/265177763 )
Внешний вклад
-
notifyFocusedRect
methods inTextInputSession
andTextInputService
are not deprecated again. ( I23a04 , b/262648050 )
Версия 1.4.0-альфа04
11 января 2023 г.
androidx.compose.foundation:foundation:1.4.0-alpha04
and androidx.compose.foundation:foundation-layout:1.4.0-alpha04
are released. Версия 1.4.0-alpha04 содержит эти коммиты.
Новые возможности
-
FlowRow
andFlowColumn
are now available as@ExperimentalFoundationApi
that allow for a more flexible row and column based layout of components that will break to a new line if there is not enough space on the main axis. ( I3a7b2 ) -
Modifier.basicMarquee()
is available as experimental for displaying content with a scrolling marquee effect. ( I2df44 , b/139321650 )
Изменения API
-
FocusRequesterModifier
is deprecated in favor ofFocusRequesterNode
( I7f4d7 , b/247708726 , b/255352203 , b/253043481 , b/247716483 , b/254529934 , b/251840112 , b/251859987 , b/257141589 ) -
AndroidFont
constructor withvariationSettings
is now a stable API, and can be used to create new types of font descriptors. ( I5adcc , b/261565807 ) - Introduced
PinnableContainer
api propagated by lazy lists via a composition local which allows to pin current item. This means such item will not be disposed when it is scrolled away from the view. For example,Modifier.focusable()
will pin the current focused item via this mechanism. ( Ib8881 , b/259274257 , b/195049010 ) - Rewrote the way scrollables respond to
bringIntoViewRequesters
and focusables to better model the complexity of those operations and handle more edge cases. ( I2e5fe , b/241591211 , b/192043120 , b/237190748 , b/230756508 , b/239451114 ) - More return type nullability of deprecated-hidden functions ( Ibf7b0 )
- Added experimental
TextMotion
toTextStyle
to define Text either to beStatic(default)
or Animated. UseTextMotion.Animated
if Text is going to be scaled, translated, or rotated via animation. ( I24dd7 ) - Add
TextFieldFocusModifier
to fix focus navigation behaviour for android platform ( I00303 ) - Replaced
maxSize: IntSize
argument indrawText
withsize: Size
to be inline with otherDrawScope
functions.size
is set toSize.Unspecified
by default which should not change the previous default behavior. ( Icd27d )
Исправления ошибок
- Adjustments in the snapping physics in
SnapFlingBehaviour
for a more natural feel.
Known Issue
- When updating from
androidx.compose.foundation:1.4.0-alpha03
toandroidx.compose.foundation:1.4.0-alpha04
, you might experience ajava.lang.NoSuchFieldError
error. Here is where the issue was orginially reported. A fix has been submitted, and will be available on the next Compose update. As a work around, update yourandroidx.compose.material
andandroidx.compose.material3
libraries to the latest version(1.1.0-alpha04) or downgrade yourandroidx.compose.foundation
to 1.4.0-alpha03.
Версия 1.4.0-альфа03
7 декабря 2022 г.
androidx.compose.foundation:foundation:1.4.0-alpha03
and androidx.compose.foundation:foundation-layout:1.4.0-alpha03
are released. Версия 1.4.0-alpha03 содержит эти коммиты.
Изменения API
- В тестах пользовательского интерфейса с использованием правила Compose продолжения, возобновленные во время обратных вызовов
withFrameNanos
, не будут отправляться до тех пор, пока не завершится выполнение всех обратных вызовов кадров. Это соответствует поведению Compose при нормальной работе. Однако тесты, основанные на старом поведении, могут завершиться неудачей. Это должно влиять только на код, который напрямую вызываетwithFrameNanos
илиwithFrameMillis
и имеет логику вне обратного вызова, передаваемую тем функциям, которые, возможно, потребуется переместить внутри обратных вызовов. Примеры см. в тестовых изменениях анимации в этом CL . - Добавлен необязательный параметр
onPerformTraversals: (Long) -> Unit
в конструкторTestMonotonicFrameClock
и фабричная функция для запуска кода после обратных вызововwithFrameNanos
, но перед возобновлением сопрограмм вызывающего объекта. ( Idb413 , б/254115946 , б/222093277 , б/255802670 ) - Introduce Page accessibility actions:
PageUp
,PageDown
,PageLeft
,PageRight
. Note that these are only available from API 29. ( Ida4ab ) - Introduce
HorizontalPager
andVerticalPager
, a way of showing composables in a Pager manner. IntroducedPagerState
to control the Pagers as well as query information about the Pager's current state. IntroducedPageSize
, a way of controlling the size of a Pager's page, this can be used to create a carousel like Pagers. IntroducedPagerSnapDistance
, a way to control how snapping will work in Pager's fling behavior. ( I01120 ) - Introduced an overload in
SnapFlingBehavior.performFling
to help to understand where the fling will settle. ( I569f6 ) - Removed
OverscrollEffect#isEnabled
. Instead of needing to remember and set this flag, just don't dispatch events to the overscroll effect in cases where you do not want overscroll to show (for example ifScrollableState#canScrollForward/backward
both return false). ( I1a4b0 , b/255554340 , b/255557085 ) - Added
ScrollableState#canScrollForward
andScrollableState#canScrollBackward
to query whether aScrollableState
has room to scroll in either direction (whether it is at the minimum / maximum of its range). This defaults to true for backwards compatibility with existing implementations ofScrollableState
. Consumers can use this to show indication to the user that there is still room to scroll, and this could also be used to avoid dispatching delta toScrollableStates
that have no room to scroll in a given direction, to reduce unnecessary work. ( Idf1a0 , b/255557085 ) - Added an Modifier API to query ancestors scroll info. ( I2ba9d , b/203141462 )
- Used in
Clickable
to correctly delay press interactions, when gestures could become scroll events. - Fixed
Clickables
not correctly delaying ripples, when used inside anScrollable ViewGroup
. - Updated Drawers and Sheets to correctly delay presses in case gestures can become scroll events.
- Update
snapStepSize
naming to be consistent with other methods inSnapLayoutInfoProvider
. ( Ife67c ) - Added
EmojiCompat
toCompose
( Ibf6f9 , b/139326806 ) - Renamed
consumedWindowInsets()
toconsumeWindowInsets()
andwithConsumedWindowInsets()
toonConsumedWindowInsetsChanged()
and made the Modifiers public. ( Ie44e1 )
Исправления ошибок
- The crash with
Modifier.animateItemPlacement()
and Lazy grids was fixed. It was happening in some conditions when the new items count is smaller then the previous one. ( I0bcac , b/253195989 )
Версия 1.4.0-альфа02
9 ноября 2022 г.
androidx.compose.foundation:foundation:1.4.0-alpha02
and androidx.compose.foundation:foundation-layout:1.4.0-alpha02
are released. Версия 1.4.0-alpha02 содержит эти коммиты.
Изменения API
-
awaitFirstDown
andwaitForUpOrCancellation
now accept aPointerEventPass
for greater flexibility. ( I7579a , b/212091796 ) - Revert
beyondBoundCount
API from Lazy* APIs ( I12197 ) - Introduced parameter in Lazy APIs to compose and place out of viewport items ( I69e89 , b/172029355 )
- Added
minLines
parameter to theBasicText
andBasicTextField
. It allows to set the minimum height of these composables in terms of number of lines ( I24294 , b/122476634 )
Версия 1.4.0-альфа01
24 октября 2022 г.
androidx.compose.foundation:foundation:1.4.0-alpha01
and androidx.compose.foundation:foundation-layout:1.4.0-alpha01
are released. Версия 1.4.0-alpha01 содержит эти коммиты.
Изменения API
- A new method,
awaitEachGesture()
, for gesture detectors was added. It operates similar toforEachGesture()
, but the loop over gestures operates entirely within theAwaitPointerEventScope
so events can't be lost between iterations. -
forEachGesture()
has been deprecated in favor ofawaitEachGesture()
because it allows events to be lost between gestures. ( Iffc3f , b/251260206 ) - Added
WindowInsets.imeAnimationSourc
e andWindowInsets.imeAnimationTarget
to determine the animation progress and know where the IME will be after animation completes. ( I356f1 , b/217770337 )
Версия 1.3
Версия 1.3.1
9 ноября 2022 г.
androidx.compose.foundation:foundation:1.3.1
and androidx.compose.foundation:foundation-layout:1.3.1
are released. Версия 1.3.1 содержит эти коммиты.
Исправления ошибок
- Fix performance issue in
BeyondBoundsLayout
( aosp/2255266 ) -
ContentInViewModifier
will not read layout coordinates unless attached ( aosp/2241316 )
Версия 1.3.0
24 октября 2022 г.
androidx.compose.foundation:foundation:1.3.0
and androidx.compose.foundation:foundation-layout:1.3.0
are released. Версия 1.3.0 содержит эти коммиты.
Важные изменения с версии 1.2.0
- Experimental versions of
LazyVerticalStaggeredGrid
andLazyHorizontalStaggeredGrid
were introduced. -
SnapFlingBehavior
,rememberSnapFlingBehavior
and other corresponding APIs were added as experimental. -
Modifier.clickable
,Modifier.toggleable
, andModifier.selectable
now show ripples if clicked with the keyboard or d-pad on a remote control.
Версия 1.3.0-rc01
5 октября 2022 г.
androidx.compose.foundation:foundation:1.3.0-rc01
and androidx.compose.foundation:foundation-layout:1.3.0-rc01
are released. Версия 1.3.0-rc01 содержит эти коммиты.
Изменения API
- Introduced
lowVelocityAnimationSpec
used by the approach step when there's not enough fling velocity to decay. ( Iaeb27 ) - Added new experimental API Hyphens to support automatic hyphenation in Text ( Iaa869 )
Версия 1.3.0-бета03
21 сентября 2022 г.
androidx.compose.foundation:foundation:1.3.0-beta03
and androidx.compose.foundation:foundation-layout:1.3.0-beta03
are released. Версия 1.3.0-beta03 содержит эти коммиты.
Изменения API
- Add options to customize line breaking in Text. ( I86907 )
-
BringIntoViewResponder
s are now able to get the most up-to-date bounds of a request while processing it. ( If86a5 , b/241591211 ) - Introduce support for spacings between items to experimental
Staggered Grid
( I10b82 ) - Introduce content padding to experimental
Staggered Grid
( I342ea ) - Changed
size:IntSize
argument withconstraints: Constraints
inTextMeasurer.measure
method to support minimum width constraints. ( I37530 , b/242707525 ) - Added
Modifier.withConsumedWindowInsets()
to get consumedWindowInsets
for use outsidewindowInsetsPadding
. - Added
MutableWindowInsets
to allow easily changingWindowInsets
without recomposition. ( I7fd28 , b/237019262 , b/243119659 )
Версия 1.3.0-beta02
7 сентября 2022 г.
androidx.compose.foundation:foundation:1.3.0-beta02
and androidx.compose.foundation:foundation-layout:1.3.0-beta02
are released. Версия 1.3.0-beta02 содержит эти коммиты.
Изменения API
- Initial version of experimental
StaggeredGrid
( Ia48be ) - Renamed
FocusDirection.In
andFocusDirection.Out
toFocusDirection.Enter
andFocusDirection.Exit
( Ia4262 , b/183746982 ) - Introduced a
rememberSnapFlingBehavior
overload that provides a quick way of enabling snapping inLazyLists
. ( Ifb48a ) - Replaced the
snapFlingBehavior
factory with a concreteSnapFlingBehavior
class. ScopedSnapLayoutInfoProvider
methods to Density to make Dp<->Px conversions easier for the API users. ( I54a11 ) - Update
LazyLayoutMeasureScope.measure
to return list of placeables, highlighting desired immutability of the returned value. ( I48b7c ) - Introduced
SnapLayoutInfoProvider
which takes aLazyListState
to create an instance ofSnapLayoutInfoProvider
that can be used to enable a snapFlingBehavior
forLazyLists
. ( I2dd10 )
Исправления ошибок
- Refactors
AwaitPointerEventScope#awaitLongPressOrCancellation
to match other await functions ( I646e6 )
Версия 1.3.0-бета01
24 августа 2022 г.
androidx.compose.foundation:foundation:1.3.0-beta01
and androidx.compose.foundation:foundation-layout:1.3.0-beta01
are released. Версия 1.3.0-beta01 содержит эти коммиты.
Изменения API
- Removed
pointerPosition
fromOverscrollEffect
- effects that care about pointer position can useModifier.pointerInput { }
in theeffectModifier
to get the current pointer position instead. ( I9f606 , b/241239306 ) - Exposed
AwaitPointerEventScope#awaitLongPressOrCancellation
as additional building block for more complex gesture detection ( I04374 , b/181577176 ) - Introduced
lazyListSnapLayoutInfoProvider
to enable snapping in Lazy Lists. ( I3ecdf ) - Introduced
SnapFlingBehavior
, a fling behavior that enables list snapping. Provide an instance ofSnapLayoutInfoProvider
with information about your snapping layout. ( Ie754c )
Версия 1.3.0-альфа03
10 августа 2022 г.
androidx.compose.foundation:foundation:1.3.0-alpha03
and androidx.compose.foundation:foundation-layout:1.3.0-alpha03
are released. Версия 1.3.0-alpha03 содержит эти коммиты.
Изменения API
- Resource Fonts now support setting font variation settings (API 26+). ( I900dd , b/143703328 )
- Variable font support in
DeviceFontFamilyNameFont
( Ic1279 , b/143703328 ) - Removed experimental annotation from
PlatformTextStyle
andLineHeightStyle
. ( I64bef ) - Text fields will now throw more detailed exceptions when the
OffsetMapping
provided by aVisualTransformation
returns invalid indices. ( Ie73f9 , b/229378536 ) - Introduce experimental APIs to share item provider logic between Lazy layouts. ( Ic891c )
-
ScrollableDefaults.reverseDirection()
is not experimental anymore. ( Iba646 ) - Deprecated
SemanticsModifier.id
and moved the semantics id toLayoutInfo.semanticsId
instead. ( Iac808 , b/203559524 ) -
checkScrollableContainerConstraints()
is not experimental anymore. ( I2c290 ) -
Modifier.clipScrollableContainer()
is not experimental anymore. ( Ia2b44 ) - Deprecate
TextInputService.show|hideSoftwareKeyboard
. Please useSoftwareKeyboardController
instead in app code andTextInputSession
in IME-management code. ( I14e4c , b/183448615 )
Версия 1.3.0-альфа02
27 июля 2022 г.
androidx.compose.foundation:foundation:1.3.0-alpha02
and androidx.compose.foundation:foundation-layout:1.3.0-alpha02
are released. Версия 1.3.0-alpha02 содержит эти коммиты.
Изменения API
- Added
drawText
extension function onDrawScope
to provide a way to draw multi-styled text on composables and modifiers that operate on aDrawScope
likeCanvas
anddrawBehind
. ( I16a62 , b/190787898 )
Исправления ошибок
- Soft keyboard will now be hidden when a text field is disabled while focused. ( I6e3e4 , b/237308379 )
- When adding
InputEventChange
events to Velocity Tracker we will consider now deltas instead of positions, this will guarantee the velocity is correctly calculated for all cases even if the target element moves ( Icea9d , b/216582726 , b/223440806 , b/227709803 ) - When a scrollable has a focused child, it will now correctly scroll to keep the focused child in view when its size is decreased, even when the size is animated. ( I80867 , b/230756508 , b/220119990 )
- Fixed a crash where
TextField
is cleared and refilled while selection is active. ( I1235b , b/208655565 , b/214253689 )
Версия 1.3.0-альфа01
29 июня 2022 г.
androidx.compose.foundation:foundation:1.3.0-alpha01
and androidx.compose.foundation:foundation-layout:1.3.0-alpha01
are released. Версия 1.3.0-alpha01 содержит эти коммиты.
Изменения API
- Introduced the
UrlAnnotation
annotation type and associated methods to supportTalkBack
link support inAnnotatedString
s. ( I1c754 , b/231495122 )
Исправления ошибок
-
BasicTextField
cursorBrush
may now be animated without restarting the cursor timer. ( I812e6 , b/236383522 )
Версия 1.2
Версия 1.2.1
10 августа 2022 г.
androidx.compose.foundation:foundation:1.2.1
and androidx.compose.foundation:foundation-layout:1.2.1
are released. Версия 1.2.1 содержит эти коммиты.
Версия 1.2.0
27 июля 2022 г.
androidx.compose.foundation:foundation:1.2.0
and androidx.compose.foundation:foundation-layout:1.2.0
are released. Версия 1.2.0 содержит эти коммиты.
Важные изменения с версии 1.1.0
-
LazyVerticalGrid
andLazyHorizontalGrid
are stable now. - You can now specify a content type for items in Lazy lists and grids. This will allow the components to reuse elements more efficiently.
- Lazy lists and grids now have
userScrollEnabled
param which allows to disable scrolling via the user gestures. - A new experimental API called
LazyLayout
was added. It It is the API we use internally to power Lazy lists and grids. -
OverscrollEffect
API has been introduced as experimental. You can define custom overscroll effects as well as adding a standard platform one to custom scrollable containers. - Nested scrolling interoperability APIs have been introduced to allow for interoperability between views and compose scrolling actors.
- Mouse and trackpad scrolling has been added to all scrolling containers.
Версия 1.2.0-rc03
29 июня 2022 г.
androidx.compose.foundation:foundation:1.2.0-rc03
and androidx.compose.foundation:foundation-layout:1.2.0-rc03
are released. Версия 1.2.0-rc03 содержит эти коммиты.
- Никаких изменений с версии 1.2.0-rc02.
Версия 1.2.0-rc02
22 июня 2022 г.
androidx.compose.foundation:foundation:1.2.0-rc02
and androidx.compose.foundation:foundation-layout:1.2.0-rc02
are released. Версия 1.2.0-rc02 содержит эти коммиты.
Версия 1.2.0-rc01
15 июня 2022 г.
androidx.compose.foundation:foundation:1.2.0-rc01
and androidx.compose.foundation:foundation-layout:1.2.0-rc01
are released. Версия 1.2.0-rc01 содержит эти коммиты.
Изменения API
- An experimental
OverscrollEffect
has been introduced to allow for custom overscroll effects, alongside theModifier.scrollable
overloads that accept it. - Experimental
LocalOverScrollConfiguration
has been moved fromfoundation.gesture
to foundation package and renamed toLocalOverscrollConfiguration
( If19fb , b/204650733 ) - Интерфейсы в библиотеках компоновки теперь создаются с использованием методов интерфейса jdk8 по умолчанию ( I5bcf1 ).
- Introduced an experimental api
checkScrollableContainerConstraints()
which allows to check that we do not nest scrollable containers. You can use it when create your own scrollable lazy layouts viaLazyLayout
. ( Id6fab , b/233352497 ) - Removed deprecated
LazyVerticalGrid
fromandroidx.compose.foundation.lazy
package. The new stable api is located inandroidx.compose.foundation.lazy.grid
( I73c76 , b/225192009 )
Версия 1.2.0-бета03
1 июня 2022 г.
androidx.compose.foundation:foundation:1.2.0-beta03
and androidx.compose.foundation:foundation-layout:1.2.0-beta03
are released. Версия 1.2.0-beta03 содержит эти коммиты.
Изменения API
- Added new experimental
IntervalList
andMutableIntervalList
. It allows to represent some list of values via multiple intervals. It will be useful when you want to define your own dsl similar to the one used byLazyColumn
where list items can be defined via multiple item/items calls. ( I2d05e , b/228580728 )
Исправления ошибок
- Clarified the documentation for
WindowInsets.ime
to state thatime
insets are reported as far back as API 23, but only animated on 30+. ( Ia7fc0 , b/230756508 ) - Pressing the forward delete key when the cursor is at the end of a text field will no longer crash.
-
DeleteSurroundingTextCommand
andDeleteSurroundingTextInCodePointsCommand
now require their constructor arguments to be non-negative. ( Ica8e6 , b/199919707 )
Версия 1.2.0-бета02
18 мая 2022 г.
androidx.compose.foundation:foundation:1.2.0-beta02
and androidx.compose.foundation:foundation-layout:1.2.0-beta02
are released. Версия 1.2.0-beta02 содержит эти коммиты.
- Downloadable font resolution that does not change the layout size of Text or
TextField
previously would not redraw, leading to stale font display. This bugfix ensures that text layout always triggers redraw (b/229727404). ( I1d49e , b/229727404 )
Версия 1.2.0-бета01
11 мая 2022 г.
androidx.compose.foundation:foundation:1.2.0-beta01
and androidx.compose.foundation:foundation-layout:1.2.0-beta01
are released. Версия 1.2.0-beta01 содержит эти коммиты.
Новые возможности
- Это первая бета-версия 1.2!
Изменения API
- Added experimental
BeyondBoundsInterval
that can be used by custom implementations ofLazyList
when they layout items beyond visible bounds ( Ifabfb , b/184670295 ) -
LineHeightBehavior
is renamed asLineHeightStyle
-
LineVerticalAlignment
is renamed asLineHeightStyle.Alignment
- Renames
LineHeightTrim
is renamed asLineHeightStyle.Trim
- Default constructor values from
LineHeightStyle
is removed ( I582bf , b/181155707 ) - Added default values for the optional members of
LazyLayoutItemProvider
interface. ( Iba8a0 ) - In the
LazyLayoutItemProvider
api instead of a factory returning the composable lambda by index we now have a simpler composable function Item accepting the index. ( Id2196 ) - LazyLayoutItemsProvider is renamed to LazyLayoutItemProvider ( I0638c )
-
LazyLayoutItemsProvider.itemsCount
is renamed toitemCount
( Id409c ) - Added Brush to
TextStyle
andSpanStyle
to provide a way to draw text with gradient coloring. ( I53869 , b/187839528 ) -
trimFirstLineTop
,trimLastLineBottom
attributes ofLineHeightBehavior
changed into a single enum:LineHeightTrim
.LineHeightTrim
have values of 4 states defined by two booleans:FirstLineTop
,LastLineBottom
, Both and None ( Ifc6a5 , b/181155707 ) Added
LineHeightBehavior
to theTextStyle
andParagraphStyle. LineHeightBehavior
controls whether line height is applied to the top of the first line and to the bottom of the last line. It also defines the alignment of line in the space provided byTextStyle
(lineHeight
).For example it is possible to get a behavior similar to what CSS defines via
LineHeightBehavior(alignment = LineVerticalAlignment.Center, trimFirstLineTop=false, trimLastLineBottom = false)
.trimFirstLineTop
,trimLastLineBottom
configurations works correctly only whenincludeFontPadding
is false. ( I97332 , b/181155707 )Added experimental
imeNestedScroll()
modifier so that developers can control the IME through scrolling. ( I60759 )
Исправления ошибок
- Fixed regression where text fields would not hide the keyboard when removed from the composition while focused. ( I7a410 , b/230536793 , b/225541817 )
- Support ellipsis when height is limited and doesn't fit all text lines ( Ie528c , b/168720622 )
-
BringIntoViewRequester.bringIntoView
will now always suspend until the request is either completed or was interrupted by a newer, non-overlapping request. Overlapping requests will be queued. ( I43e7f , b/216790855 ) - Concurrent
BringIntoViewRequester.bringIntoView
calls for rectangles that are completely overlapping will now only honor the larger rectangle's request. ( I34be7 , b/216790855 , b/184760918 ) - Turned on default
includeFontPadding
. It is possible to turn off theincludeFontPadding
usingTextStyle.platformTextStyle
attribute. In the near future we will change the default behavior however until that time this allows us to better integrate line height improvements (aosp/2058653) and solveTextField
clipping issues. ( I01423 , b/171394808 ) -
Modifier.bringIntoViewRequester
no longer usesonGloballyPositioned
. ( I630f5 )
Внешний вклад
-
MouseInjectionScope.scroll(delta = someDelta)
is now inverted on Android if we scroll vertically (if someDelta is positive, it will scroll downward) ( Ifb697 , b/224992993 )
Версия 1.2.0-альфа08
20 апреля 2022 г.
androidx.compose.foundation:foundation:1.2.0-alpha08
and androidx.compose.foundation:foundation-layout:1.2.0-alpha08
are released. Версия 1.2.0-alpha08 содержит эти коммиты.
Изменения API
- Display all available weights for systems fonts on Android when using
FontFamily.SansSerif
. This will use fallback font names like sans-serif-medium internally on API 21-28. This is a behavior change as previously only weights 400 and 700 were supported on API 21-28. ( I380fe , b/156048036 , b/226441992 ) - Paragraph and MultiParagraph are now accepting Constraints parameter. Passing
Constraints.maxHeight
is a no-op at the moment but will allow to do some calculation in the future, like ellipsizing based on the height. ( I6afee , b/168720622 ) -
SubcomposeSlotReusePolicy.getSlotsToRetain()
now accepts a custom MutableSet-like class which doesn't allow adding new items in it. ( Icd314 ) - Partial consumption (down OR position) has been deprecated in
PointerInputChange
. You can useconsume()
to consume the change completely. You can useisConsumed
to determine whether or not someone else has previously consumed the change. -
PointerInputChange::copy()
now always makes a shallow copy. It means that copies ofPointerInputChange
will be consumed once one of the copies is consumed. If you want to create an unboundPointerInputChange
, use constructor instead. ( Ie6be4 , b/225669674 ) - New experimental
LazyLayout
API is introduced. This allows you to build your own components likeLazyColumn
ofLazyVerticalGrid
. Note that the API is in its early stages and can be changed in the future releases. ( Iba2bc , b/166591700 ) -
AndroidFont
now takestypefaceLoader
as a constructor parameter. ( I2c971 ) -
WindowInsets
companion now exposes the visibility (whether they are on the screen, regardless of whether they intersect with the window) and the size they could be if they are available on the device, but not currently active. ( I65182 , b/217770337 )
Версия 1.2.0-альфа07
6 апреля 2022 г.
androidx.compose.foundation:foundation:1.2.0-alpha07
and androidx.compose.foundation:foundation-layout:1.2.0-alpha07
are released. Версия 1.2.0-alpha07 содержит эти коммиты.
Изменения API
- Added a
PinnableParent
API that allows children of lazy layouts to prevent the currently composed items from being disposed ( Ibbdd0 , b/184670295 ) -
LazyListLayoutInfo
andLazyGridLayoutInfo
now havebeforeContentPadding
andafterContentPadding
fields ( I3b628 , b/200920410 ) - Added
KeyboardType.Decimal
as an alternative toKeyboard.Number
for specifically including decimal separator in IME. ( Iec4c8 , b/209835363 ) - Add new font descriptor Font(DeviceFontFamilyName) to optionally lookup system-installed fonts during font fallback chains. ( I30468 , b/219754572 )
-
PointerEventType.Scroll
andPointerEvent.scrollDelta
are stable APIs now ( I574c5 , b/225669674 ) - Added temporary compatibility configuration for
includeFontPadding
inTextStyle/ParagraphStyle. includeFontPadding
can be changed viaTextStyle(platformStyle = PlatformTextStyle(includeFontPadding = true/false))
. This is a temporary configuration option to enable migration and will be removed. ( If47be , b/171394808 ) - Updated
FontFamily.Resolver
to integrate System-wide bold text accessibility setting ( I6c1e7 ) - The
consumeWindowInsets
extension property ofComposeView
allows developers to disable consumption of Android WindowInsets. This allows separateComposeViews
in the hierarchy to each applyWindowInsets
without interfering with each other. ( I0ef08 , b/220943142 )
Версия 1.2.0-альфа06
23 марта 2022 г.
androidx.compose.foundation:foundation:1.2.0-alpha06
and androidx.compose.foundation:foundation-layout:1.2.0-alpha06
are released. Версия 1.2.0-alpha06 содержит эти коммиты.
Изменения API
- Added
RequestFocus
semantics action to request focus on the focusable target. ( I17b71 ) -
FocusOrder
has now been merged intoFocusProperties
andfocusProperties()
now has all the capabilities offocusOrder()
.FocusOrder
andfocusOrder()
have been deprecated.focusOrder()
that accepts afocusRequester
should be replaced with afocusRequester()
modifier in combination withfocusProperties()
. This allows the modifiers to have a stronger separation of concerns. ( I601b7 ) -
WindowInsets.asPaddingValues(Density)
was added to allow developers to do the conversion without needing to be in composition. ( I94c35 ) - Обновлен анализ векторных изображений для поддержки автоматического зеркалирования для переворачивания содержимого
VectorPainter
, если текущее направление макета — RTL. ( I79cd9 , б/185760237 )
Исправления ошибок
- Scroll modifiers (
Modifier.verticalScroll()
,Modifier.horizontalScroll()
, andModifier.scrollable()
) will now scroll to keep the focused composable visible if the scroll area is resized and the focused composable was previously visible. - TextFields will now be kept above the keyboard when they are focused and the keyboard is shown, when inside a non-lazy scrollable and the soft input mode is
ADJUST_RESIZE
. ( I4a485 , b/190539358 , b/192043120 , b/216842427 )
Версия 1.2.0-альфа05
9 марта 2022 г.
androidx.compose.foundation:foundation:1.2.0-alpha05
and androidx.compose.foundation:foundation-layout:1.2.0-alpha05
are released. Версия 1.2.0-alpha05 содержит эти коммиты.
Изменения API
-
LazyVerticalGrid
andLazyHorizontalGrid
are now stable. ( I307c0 ) -
LazyGridItemInfo.Unknown
was replaced with separateLazyGridItemInfo.UnknownRow
andLazyGridItemInfo.UnknownColumn
( I56d51 ) -
LazyVerticalGrid
/LazyHorizontalGrid
and all related apis were moved into.grid
subpackage. Please update your imports fromandroidx.compose.foundation.lazy
toandroidx.compose.foundation.lazy.grid
. ( I2d446 , b/219942574 ) - Text:
includeFontPadding
is now turned off by default. The clipping issues as a result ofincludeFontPadding=false
is handled and no clipping should occur for tall scripts. ( I31c84 , b/171394808 ) - Measured interface now exposes parentData property ( I3313f )
- Introduced experimental
Modifier.onFocusedBoundsChanged
to allow observing the bounds of child focusables. ( I14283 , b/220030968 , b/190539358 , b/192043120 , b/216842427 ) - LazyHorizontalGrid was added. ( I61ae7 , b/191238807 )
- Added a new
LazyVerticalGrid
API to define cross axis sizes ( I17723 ) - Added FocusGroup modifier ( I64bc0 , b/213508274 , b/184670295 )
Исправления ошибок
-
WindowInsets.toString()
will now show the correct values. ( I1585d )
Внешний вклад
- Обновлено для использования сопрограмм Kotlinx 1.6.0 ( I3366d ).
Версия 1.2.0-альфа04
23 февраля 2022 г.
androidx.compose.foundation:foundation:1.2.0-alpha04
and androidx.compose.foundation:foundation-layout:1.2.0-alpha04
are released. Версия 1.2.0-alpha04 содержит эти коммиты.
Изменения API
-
BringIntoViewResponders
are no longer required to manually pass requests up to parent responders, and are instead required to immediately return the rectangle they want their parent to bring into view. ( I8e66a ) - Support async font loading in Text ( I77057 , b/214587005 )
-
LazyVerticalGrid
now supportsline breaking
before items with span not fitting inside the current line. ( I05c40 , b/207462103 ) - Renamed
excludeFromSystemGestures
tosystemGesturesExclusion
( I19526 ) -
LazyVerticalGrid
now supports reverseLayout. ( I6d7d7 , b/215572963 , b/211753558 ) - Add
WindowInsets.only()
method to allow developers to include only dimensions from the WindowInsets. ( I14c94 , b/217768486 ) Добавлены
ComposableTarget
,ComposableTargetMarker
иComposableOpenTarget
, которые позволяют во время компиляции сообщать о том, когда компонуемая функция вызывается с таргетингом на приложение, для которого она не предназначена.В большинстве случаев аннотации могут быть выведены плагином компилятора Compose, поэтому непосредственное использование этих аннотаций должно быть редким. Случаи, которые не могут быть выведены, включают создание и использование пользовательского приложения, абстрактных составных функций (например, методов интерфейса), полей или глобальных переменных, которые являются составными лямбда-выражениями (выводятся локальные переменные и параметры), а также при использовании
ComposeNode
или связанных составных функций.Для пользовательских приложений составные функции, которые вызывают
ComposeNode
илиReusableComposeNode
должны добавить аннотациюCompoableTarget
для функции и любых составных типов лямбда-параметров. Однако рекомендуется создать аннотацию, помеченную с помощьюComposableTargetMarker
, а затем помеченную аннотацию использовать непосредственно вместоComposableTarget
. Составная аннотация, помеченнаяComposableTargetMarker
, эквивалентнаComposbleTarget
с полным именем класса атрибута в качестве параметра применения. Пример использованияComposableTargetMarker
см. вanroidx.compose.ui.UiComposable
. ( I38f11 )
Исправления ошибок
- Now it is allowed to pass negative scroll offsets into
LazyGridState.scrollToItem()
andLazyGridState.animateScrollToItem()
. ( I025c6 , b/211753558 ) - Support async font loading for TextField. ( Icc4bf , b/214587005 )
Версия 1.2.0-альфа03
9 февраля 2022 г.
androidx.compose.foundation:foundation:1.2.0-alpha03
and androidx.compose.foundation:foundation-layout:1.2.0-alpha03
are released. Версия 1.2.0-alpha03 содержит эти коммиты.
Изменения API
-
notifyFocusedRect
methods inTextInputSession
andTextInputService
are now deprecated and won't be called. UseBringIntoViewRequester
instead. ( Ia4302 , b/192043120 , b/216842427 , b/178211874 ) - Animations were enabled for items of lazy grids with Modifier.animateItemPlacement(). ( Ib6621 , b/211753218 )
-
BringIntoViewRequester
now propagates requests to the hosting Android View. ( Ia7a51 ) -
FontFamilyResolver
is now available viaLocalFontFamilyResolver.current
- Added
createFontFamilyResolver(context)
andcreateFontFamilyResolver(context, coroutineScope)
to create new FontFamily resolvers outside of compose usage. - Paragraph and MultiParagraph now take
FontFamily.Resolver
-
TextLayoutResult.layoutInput.fontFamilyResolver
now contains the resolver used for this layout, deprecatedTextLayoutResult.layoutInput.resourceLoader
as it is no longer used. ( Id5a45 , b/174162090 )
- Added
- Added
AndroidFont
, a new low-level API for providing new types of font resource descriptors on Android. For example, loading fonts from an app-specific backend, optionally locating pre-installed fonts on-device, or loading a font from a resource not provided by the current Font factories.- Expanded
Font.ResourceLoaded
API to support optional and async font loading. It is not recommended that application developers use this API directly. To add new types of fonts see AndroidFont. -
Font.AndroidResourceLoader
extension function allows construction of aFont.ResourceLoader
when outside of composition. - Added
loadingStrategy
parameter to resource-based fonts, to allow async loading when resource font references downloadable fonts XML. ( Ie5aea , b/174162090 )
- Expanded
-
Typeface(FontFamily)
constructor is deprecated. This was previously used to preload fonts, which may take up to 10 seconds for downloadable fonts. With downloadable fonts, this call may block for 10 seconds. Instead useFontFamilyResolver.preload
-
fontResource(FontFamily): Typeface
is deprecated. This was previously used to preload fonts, which may take up to 10 seconds for downloadable fonts. Instead useFontFamilyResolver.preload
( If8e7c , b/174162090 )
-
- You can now specify the content type for the items of
LazyVerticalGrid
- item/items functions onLazyGridScope
now accept such parameter. Providing such information helps item composition reusing logic to make it more efficiently and only reuse the content between the items of similar type. ( I7b355 , b/215372836 ) -
LazyListLayoutInfo
andLazyGridLayoutInfo
now have new properties:viewportSize
,orientation
,reverseLayout
( Ifc8ed , b/200920410 ) - You can now specify the content type for the items of LazyColumn/LazyRow - item/items functions on LazyListScope now accept such parameter. Providing such information helps item composition reusing logic to make it more efficiently and only reuse the content between the items of similar type. ( I26506 )
-
SubcomposeLayoutState
constructor acceptingmaxSlotsToRetainForReuse
is now deprecated. Instead there is a new constructor acceptingSubcomposeSlotReusePolicy
- a new interface allowing more granular control on what slots should be retained for the future reuse. ( I52c4d ) - Adds Modifiers for WindowInsets, both for padding and sizing. This allows some content to extend into the inset area, and still have primary content stay out of the inset area. For example, windowInsetsPadding can be used to pad the content area to avoid areas that may be fully or partially covered. ( Id0395 , b/213942085 )
Исправления ошибок
- TextFields will now be kept above the keyboard when they are focused and the keyboard is shown, when the soft input mode is
ADJUST_PAN
. ( I8eaeb , b/190539358 , b/192043120 ) - Desktop uses composition local for
FontFamily.Resolver
- Desktop
FontLoader
is deprecated - New
createFontFamilyResolver
factory on Desktop ( I6bbbb , b/174162090 )
- Desktop
- The soft keyboard input type no longer flickers when changing focus between text fields. ( I1bf50 , b/187746439 )
- Text fields no longer require an extra back press when the cursor handle is showing. ( Ideb4b , b/205726883 )
- Text selection magnifier behavior has been polished to match the platform magnifier. ( Idd918 , b/206833278 )
Версия 1.2.0-альфа02
26 января 2022 г.
androidx.compose.foundation:foundation:1.2.0-alpha02
and androidx.compose.foundation:foundation-layout:1.2.0-alpha02
are released. Версия 1.2.0-alpha02 содержит эти коммиты.
Изменения API
- Added
NonRestartableComposable
to methods that are overloads of existing methods without complex logic. This reduces compiler generated memoization checks (equals) for all parameters which are repeated in the inner function that is called. ( I90490 ) - Added
excludeFromSystemGesture
Modifiers for easy access to Android'ssetSystemGestureExclusionRects
( I46f07 )
Исправления ошибок
- Text selection magnifier behavior has been polished to match the platform magnifier. ( Idd918 , b/206833278 )
-
LazyColumn
,LazyRow
,Modifier.verticalScroll
and other containers that useModifier.scrollable
now support mouse wheel scrolling. ( I2b5e1 , b/198214718 )
Версия 1.2.0-альфа01
12 января 2022 г.
androidx.compose.foundation:foundation:1.2.0-alpha01
and androidx.compose.foundation:foundation-layout:1.2.0-alpha01
are released. Версия 1.2.0-alpha01 содержит эти коммиты.
Изменения API
- New parameter
userScrollEnabled
was added toLazyColumn
,LazyRow
, andLazyVerticalGrid
in order to allow users to temporarily or permanently disable the user initiated scroll via touch gestures or accessibility actions. Scrolling programmatically via the methods on the state will still be allowed. ( I7eae9 , b/201150093 ) - Add
onSizeChanged
callback to magnifier modifier. ( I6879f ) - The magnifier widget now shows when dragging selection handles in a
SelectionContainer
. ( I30b38 , b/139320979 )
Исправления ошибок
- Fixes
TextField
cursor handle not hiding when scrolled out of view. ( I14552 , b/208883748 )
Обновления зависимостей
- Теперь зависит от Kotlin
1.6.10
.
Версия 1.1
Версия 1.1.1
23 февраля 2022 г.
androidx.compose.foundation:foundation:1.1.1
and androidx.compose.foundation:foundation-layout:1.1.1
are released. Версия 1.1.1 содержит эти коммиты.
Исправления ошибок
- Исправьте исключение
NullPointerException
вandroidx.compose.ui.platform.RenderNodeLayer.updateDisplayList
( aosp/1947059 , b/206677462 ). - Исправлен сбой, вызванный содержимым буфера обмена при чтении из буфера обмена на Android. ( I06020 , б/197769306 )
- Исправлено RTL в
LazyVerticalGrid
( aosp/1931080 , b/207510535 )
Версия 1.1.0
9 февраля 2022 г.
androidx.compose.foundation:foundation:1.1.0
and androidx.compose.foundation:foundation-layout:1.1.0
are released. Версия 1.1.0 содержит эти коммиты.
Важные изменения с версии 1.0.0
- Стабильная поддержка эффекта прокрутки Android 12.
- Улучшения в сенсорном изменении целевого размера.
- Обратите внимание, что в Compose 1.0 компоненты Material будут расширять свое пространство макета, чтобы соответствовать рекомендациям по доступности Material для сенсорного размера цели . Например, цель касания кнопки расширится до минимального размера 48x48dp, даже если вы установите меньший размер кнопки. Это приводит Compose Material в соответствие с тем же поведением компонентов Material Design, обеспечивая единообразное поведение при смешивании представлений и Compose. Это изменение также гарантирует, что при создании пользовательского интерфейса с использованием компонентов Compose Material будут соблюдены минимальные требования к доступности сенсорной цели.
- Стабильная поддержка Navigation Rail
- Стабильный уровень ряда ранее экспериментальных API.
- Поддержка новых версий Kotlin
Версия 1.1.0-rc03
26 января 2022 г.
androidx.compose.foundation:foundation:1.1.0-rc03
and androidx.compose.foundation:foundation-layout:1.1.0-rc03
are released. Версия 1.1.0-rc03 содержит эти коммиты.
Исправления ошибок
- Обновлено для поддержки Compose Material 1.1.0-rc03.
Версия 1.1.0-rc01
15 декабря 2021 г.
androidx.compose.foundation:foundation:1.1.0-rc01
and androidx.compose.foundation:foundation-layout:1.1.0-rc01
are released. Версия 1.1.0-rc01 содержит эти коммиты.
Исправления ошибок
- Now it is allowed to pass negative scroll offsets into
LazyListState.scrollToItem()
andLazyListState.animateScrollToItem()
. ( Iceb90 , b/184252837 ) - Fixed a bug that caused missing accessibility scroll actions ( I7cbfb )
Версия 1.1.0-beta04
1 декабря 2021 г.
androidx.compose.foundation:foundation:1.1.0-beta04
and androidx.compose.foundation:foundation-layout:1.1.0-beta04
are released. Версия 1.1.0-beta04 содержит эти коммиты.
Новые возможности
- Обновлен для совместимости с Kotlin
1.6.0
Изменения API
- Cleaned up nullability in
androidx.core.view
( I7078a , b/204917439 ) - Experimental APIs were added that allow to consume PointerInputchange as a whole or check whether it was consumed or not. ( I2e59d )
- Show a magnifier widget when dragging the cursor or selection handles inside text fields. ( I5391e , b/203781358 )
Исправления ошибок
- Fix text handles not moving when IME visibility changes. ( I25f2e )
Версия 1.1.0-beta03
17 ноября 2021 г.
androidx.compose.foundation:foundation:1.1.0-beta03
and androidx.compose.foundation:foundation-layout:1.1.0-beta03
are released. Версия 1.1.0-beta03 содержит эти коммиты.
Изменения API
- Support for horizontal spans was added to LazyVerticalGrid. ( I7e2fa , b/176758183 )
Experimental ability to animate Lazy lists item positions was added. There is a new modifier available within LazyItemScope called
Modifier.animateItemPlacement()
. Usage example:var list by remember { mutableStateOf(listOf("A", "B", "C")) } LazyColumn { item { Button(onClick = { list = list.shuffled() }) { Text("Shuffle") } } items(list, key = { it }) { Text("Item $it", Modifier.animateItemPlacement()) } }
- When you provide a key via
LazyListScope.item
orLazyListScope.items
this modifier will enable item reordering animations. Aside from item reordering all other position changes caused by events like arrangement or alignment changes will also be animated. ( I59e7b , b/150812265 )
- When you provide a key via
Версия 1.1.0-beta02
3 ноября 2021 г.
androidx.compose.foundation:foundation:1.1.0-beta02
and androidx.compose.foundation:foundation-layout:1.1.0-beta02
are released. Версия 1.1.0-beta02 содержит эти коммиты.
Исправления ошибок
- Ripples and other indications will now only be delayed if they are inside a
Modifier.scrollable()
container, instead of always being delayed for a down event. ( Ibefe0 , b/203141462 ) - Added experimental BringIntoView API that lets you send a request to parents so that they scroll to bring an item into view ( Ib918d , b/195353459 )
Внешний вклад
- Added
Modifier.pointerHoverIcon
( I95f01 )
Версия 1.1.0-бета01
27 октября 2021 г.
androidx.compose.foundation:foundation:1.1.0-beta01
and androidx.compose.foundation:foundation-layout:1.1.0-beta01
are released. Версия 1.1.0-beta01 содержит эти коммиты.
Исправления ошибок
- Added experimental BringIntoView API that lets you send a request to parents so that they scroll to bring an item into view ( Ib918d , b/195353459 )
Версия 1.1.0-альфа06
13 октября 2021 г.
androidx.compose.foundation:foundation:1.1.0-alpha06
and androidx.compose.foundation:foundation-layout:1.1.0-alpha06
are released. Версия 1.1.0-alpha06 содержит эти коммиты.
Изменения API
- A child-less overload for Layout was added, with improved efficiency ( Ib0d9a )
-
SemanticsNodeInteraction.performSemanticsAction
now returns theSemanticsNodeInteraction
on which the function was called. ( I9e5db ) - Added
performScrollToNode(matcher: SemanticsMatcher)
that scrolls a scrollable container to the content that is matched by the given matcher. ( Ic1cb8 )
Версия 1.1.0-альфа05
29 сентября 2021 г.
androidx.compose.foundation:foundation:1.1.0-alpha05
and androidx.compose.foundation:foundation-layout:1.1.0-alpha05
are released. Версия 1.1.0-alpha05 содержит эти коммиты.
Изменения API
- Added experimental historical pointers to PointerEventChange. ( Ic1fd8 , b/197553056 , b/199921305 )
Исправления ошибок
- Fixed accessibility support for scrollables (both lazy and non-lazy) with respect to scrolling ( I6cdb0 )
Версия 1.1.0-альфа04
15 сентября 2021 г.
androidx.compose.foundation:foundation:1.1.0-alpha04
and androidx.compose.foundation:foundation-layout:1.1.0-alpha04
are released. Версия 1.1.0-alpha04 содержит эти коммиты.
Изменения API
- Deprecated
performGesture
andGestureScope
, which have been replaced byperformTouchInput
andTouchInjectionScope
. ( Ia5f3f , b/190493367 ) - Added
touchBoundsInRoot
toSemanticsNode
that includes the minimum touch target size so that developers can ensure that touch targets meet accessibility minimums. ( I2e14b , b/197751214 )
Исправления ошибок
- Support for stretch overscroll has been added on Android 12 devices. ( Iccf3c , b/171682480 )
Версия 1.1.0-альфа03
1 сентября 2021 г.
androidx.compose.foundation:foundation:1.1.0-alpha03
and androidx.compose.foundation:foundation-layout:1.1.0-alpha03
are released. Версия 1.1.0-alpha03 содержит эти коммиты.
Новые возможности
- Обновлен Compose
1.1.0-alpha03
для зависимости от Kotlin1.5.30
. ( I74545 )
Изменения API
- Glow effect for scroll has been added. New experimental OverScrollConfiguration API has been added to allow for configuration of the overscroll visual effect. Provide null to turn off the overscroll effect. ( I0c304 , b/171682480 )
- AwaitPointerEventScope now has withTimeout() and withTimeoutOrNull() ( I507f0 , b/179239764 , b/182397793 )
- Added test method to get the clipped bounds. ( I6b28e )
- Added minimum touch target size to ViewConfiguration for use in semantics and pointer input to ensure accessibility. ( Ie861c )
Версия 1.1.0-альфа02
18 августа 2021 г.
androidx.compose.foundation:foundation:1.1.0-alpha02
and androidx.compose.foundation:foundation-layout:1.1.0-alpha02
are released. Версия 1.1.0-alpha02 содержит эти коммиты.
Изменения API
- Added DpSize versions for
Modifier.size
andrequiredSize
( I3fc7e , b/194219828 )
Версия 1.1.0-альфа01
4 августа 2021 г.
androidx.compose.foundation:foundation:1.1.0-alpha01
and androidx.compose.foundation:foundation-layout:1.1.0-alpha01
are released. Версия 1.1.0-alpha01 содержит эти коммиты.
Изменения API
- Updated
DrawScope#drawImage
method that consumes source and destination rects to consume an optional FilterQuality parameter. This is useful for pixel art that is intended to be pixelated when scaled up for pixel based art. Updated BitmapPainter + Image composable to also consume an optional FilterQuality parameter ( Ie4fb0 , b/180311607 ) - TextField now clears selection when back button is pressed, which matches Android EditText behavior. ( I3ca16 , b/174173645 )
- Add Cursor Handle. ( I07a82 , b/173016579 )
Исправления ошибок
- Scrolling via semantics actions for lazy lists and regular scrolling components is now animated ( Id9066 , b/190742024 )
Внешний вклад
-
LazyVerticalGrid
now accepts both horizontal and vertical arrangement parameters. ( If9c92 )
Версия 1.0
Версия 1.0.5
3 ноября 2021 г.
androidx.compose.foundation:foundation:1.0.5
and androidx.compose.foundation:foundation-layout:1.0.5
are released. Версия 1.0.5 содержит эти коммиты.
Исправления ошибок
- Исправлен сбой при отслеживании экземпляров производныхStateOf. ( аосп/1792247 )
Версия 1.0.4
13 октября 2021 г.
androidx.compose.foundation:foundation:1.0.4
and androidx.compose.foundation:foundation-layout:1.0.4
are released. Версия 1.0.4 содержит эти коммиты.
Обновления зависимостей
- Обновлено в зависимости от Kotlin
1.5.31
Версия 1.0.3
29 сентября 2021 г.
androidx.compose.foundation:foundation:1.0.3
and androidx.compose.foundation:foundation-layout:1.0.3
are released. Версия 1.0.3 содержит эти коммиты.
Обновления зависимостей
- Обновлено в зависимости от Kotlin
1.5.30
Версия 1.0.2
1 сентября 2021 г.
androidx.compose.foundation:foundation:1.0.2
and androidx.compose.foundation:foundation-layout:1.0.2
are released. Версия 1.0.2 содержит эти коммиты.
Обновлено для поддержки версии Compose 1.0.2
. Compose 1.0.2
по-прежнему совместим с Kotlin 1.5.21
.
Версия 1.0.1
4 августа 2021 г.
androidx.compose.foundation:foundation:1.0.1
and androidx.compose.foundation:foundation-layout:1.0.1
are released. Версия 1.0.1 содержит эти коммиты.
Обновления зависимостей
- Обновлено в зависимости от Kotlin
1.5.21
.
Версия 1.0.0
28 июля 2021 г.
androidx.compose.foundation:foundation:1.0.0
and androidx.compose.foundation:foundation-layout:1.0.0
are released. Версия 1.0.0 содержит эти коммиты.
Основные особенности версии 1.0.0
Это первая стабильная версия Compose. Более подробную информацию можно найти в официальном блоге Compose Release !
Известные проблемы
Если вы используете Android Studio Bumblebee Canary 4 или AGP
7.1.0-alpha04
/7.1.0-alpha05
, вы можете столкнуться со следующим сбоем:java.lang.AbstractMethodError: abstract method "void androidx.lifecycle.DefaultLifecycleObserver.onCreate(androidx.lifecycle.LifecycleOwner)"
Чтобы исправить это, временно увеличьте minSdkVersion до 24+ в файле
build.gradle
. Эта проблема будет исправлена в следующей версии Android Studio Bumblebee и AGP7.1
. ( р/194289155 )
Версия 1.0.0-rc02
14 июля 2021 г.
androidx.compose.foundation:foundation:1.0.0-rc02
and androidx.compose.foundation:foundation-layout:1.0.0-rc02
are released. Версия 1.0.0-rc02 содержит эти коммиты.
- Updated border rendering for generic shapes to address issues with paths defined with fixed dimensions. ( aosp/1748871 , b/191817116 )
Версия 1.0.0-rc01
1 июля 2021 г.
androidx.compose.foundation:foundation:1.0.0-rc01
and androidx.compose.foundation:foundation-layout:1.0.0-rc01
are released. Версия 1.0.0-rc01 содержит эти коммиты.
Изменения API
- Canvas now supports a contentDescription parameter for accessibility. ( Ib547c )
Исправления ошибок
- Disabled Button, Card, Checkboxes and overall
Modifier.clickable(enabled=false)
will block clicks from going up to the parent. ( Ic2c3b , b/183908811 )
Версия 1.0.0-beta09
16 июня 2021 г.
androidx.compose.foundation:foundation:1.0.0-beta09
and androidx.compose.foundation:foundation-layout:1.0.0-beta09
are released. Версия 1.0.0-beta09 содержит эти коммиты.
Изменения API
- Удален
ManualFrameClock
. Если вам нужно управлять анимацией, используйте вместо этогоcomposeTestRule.mainClock
. ( I3c3e8 , б/189951065 ) - change enum Role and LiveRegionMode to inline classes with private constructor ( Id1890 )
- KeyboardCapitalization is converted into inline class. ( Id5a1c )
- TextOverflow is changed to an inline class. ( I433af )
Исправления ошибок
- Now when you specify the unique keys for LazyColumn/Row items the scroll position will be maintained based on the key, which means if you add/remove items before the current visible item the item with the given key will be kept as the first visible one. ( Id263f , b/184257857 )
- Key constants are @ExperimentalComposeUiApi for now. Consuming code can declare private constants prior to stabilization. ( Ia5d48 )
- Added IdlingStrategy to AndroidComposeTestRule that can be used by testing frameworks to install an alternative mechanism to await or achieve quiescence. Use
AndroidComposeTestRule.setIdlingStrategyFactory()
before your test starts to install your own strategy. ( I608fa )
Добавлены правила профиля
В этом выпуске правила профиля добавлены в следующие модули составления ( I14ed6 ):
- androidx.compose.animation
- androidx.compose.animation-core
- androidx.compose.foundation
- androidx.compose.foundation-layout
- androidx.compose.material
- androidx.compose.material-ripple
- androidx.compose.runtime
- androidx.compose.ui
- androidx.compose.ui.geometry
- androidx.compose.ui.graphics
- androidx.compose.ui.text
- androidx.compose.ui.text
- androidx.compose.ui.unit
- androidx.compose.ui.util
Что такое правила профиля?
Правила профиля для библиотеки указаны в текстовом файле
baseline-prof.txt
расположенном в каталогеsrc/main
или его эквиваленте. В файле указывается правило для каждой строки, где правило в данном случае представляет собой шаблон для сопоставления с методами или классами в библиотеке. Синтаксис этих правил представляет собой расширенный набор удобочитаемого формата профиля ART, который используется при использованииadb shell profman --dump-classes-and-methods ...
. Эти правила принимают одну из двух форм и ориентированы либо на методы, либо на классы.Правило метода будет иметь следующий шаблон:
<FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
И правило класса будет иметь следующий шаблон:
<CLASS_DESCRIPTOR>
Здесь
<FLAGS>
— это один или несколько символовH
,S
иP
указывающие, следует ли пометить этот метод как «Горячий», «Запуск» или «После запуска».<CLASS_DESCRIPTOR>
— это дескриптор класса, которому принадлежит целевой метод. Например, классandroidx.compose.runtime.SlotTable
будет иметь дескрипторLandroidx/compose/runtime/SlotTable;
.<METHOD_SIGNATURE>
является сигнатурой метода и включает имя, типы параметров и типы возвращаемых значений метода. Например, методfun isPlaced(): Boolean
вLayoutNode
имеет подписьisPlaced()Z
.Эти шаблоны могут содержать подстановочные знаки (
**
,*
и?
), чтобы одно правило охватывало несколько методов или классов.
Что делают правила?
Метод с флагом
H
указывает, что этот метод является «горячим» и его следует скомпилировать заранее.Метод с флагом
S
указывает, что этот метод вызывается при запуске и его следует скомпилировать заранее, чтобы избежать затрат на компиляцию и интерпретацию метода во время запуска.Метод с флагом
P
указывает, что это метод, который вызывается после запуска.Класс, присутствующий в этом файле, указывает на то, что он используется во время запуска и должен быть предварительно выделен в куче, чтобы избежать затрат на загрузку классов.
Как это работает?
- Библиотеки могут определять эти правила, которые будут упакованы в артефакты AAR. Когда затем создается приложение, включающее эти артефакты, эти правила объединяются, и объединенные правила используются для создания компактного двоичного профиля ART, специфичного для приложения. Затем ART может использовать этот профиль, когда приложение устанавливается на устройства, чтобы заранее скомпилировать определенное подмножество приложения для повышения производительности приложения, особенно при первом запуске. Обратите внимание, что это не повлияет на отлаживаемые приложения.
Версия 1.0.0-beta08
2 июня 2021 г.
androidx.compose.foundation:foundation:1.0.0-beta08
and androidx.compose.foundation:foundation-layout:1.0.0-beta08
are released. Версия 1.0.0-beta08 содержит эти коммиты.
Изменения API
- NestedScrollSource enum is replaced by an inline class. ( Ie321b , b/187055290 )
- Refactored enum usages to inline classes to avoid issues with exhaustive when statements when new enum values are added. ( I2b5eb )
- Adds a tap timeout to clickable / toggleable to prevent showing a ripple during a scroll / drag ( Ia2704 , b/168524931 )
- ContentDescription and Text semantics properties are no longer single values but lists. This enables to merge them as they are instead of concatenations. Also provided better testing APIs to utilize these changes ( Ica6bf , b/184825850 )
-
Modifier.focusModifier()
is deprecated and replaced byModifier.focusTarget()
( I6c860 ) - KeyboardType enum is replaced by an inline class. ( I73045 , b/187055290 )
- Replaced
FocusState
enum with aFocusState
interface ( Iccc1a , b/187055290 ) - ImeAction enum is replaced by an inline class. ( I18be5 , b/187055290 )
-
AnnotatedString.withAnnotation
functions are now ExperimentalTextApi instead of ExperimentalComposeApi. ( I0cd0a )- TextUnit constructor with TextUnitType is now ExperimentalTextApi instead of ExperimentalComposeApi.
- PaddingValues is now
@Stable
rather than@Immutable
( I88c50 )
Исправления ошибок
- Fix crashes of long press the blank area in non-empty text. ( I33ab5 , b/187437299 )
- Show Toolbar after SelectAll ( I495d9 , b/185919613 )
- Fix for scrollable containers clipping its children on the cross axis. It was easily reproducible if you have a LazyRow with Card items. now the shadow will not be clipped. ( Icb635 , b/186318448 )
- Fixed an issue where ripples / other indication would sometimes get stuck on a long click when using Modifier.combinedClickable ( I2298c , b/186223077 )
- ТеперьDetectDragGesures,
detectVerticalGestures
detectHorizontalGestures
будут автоматически учитывать изменение позиции, нет необходимости вызывать Change.consumePositionChange в обратных вызовах onDrag (detectDragGesures
, b/185096350 , b/187320697 ) . -
Modifier.onGloballyPositioned()
был изменен, чтобы сообщать координаты этого модификатора в цепочке модификаторов, а не координаты макета после применения всех модификаторов. Это означает, что теперь порядок модификаторов влияет на то, какие координаты будут сообщаться. ( Ieb67d , р/177926591 )
Версия 1.0.0-beta07
18 мая 2021 г.
androidx.compose.foundation:foundation:1.0.0-beta07
and androidx.compose.foundation:foundation-layout:1.0.0-beta07
are released. Версия 1.0.0-beta07 содержит эти коммиты.
Изменения API
- The next visible item prefetching logic is introduced for LazyColumn/Row ( I8a4bc , b/184940225 )
- Added Clip Selection Handle ( Iff80d , b/183408447 )
Исправления ошибок
- LazyColumn/Row теперь будет сохранять до двух ранее видимых элементов активными (не удаленными), даже если они уже прокручены. Это позволяет компоненту повторно использовать активные подкомпозиции, когда нам нужно будет создать новый элемент, что повышает производительность прокрутки. ( Ie5555 )
- Remove paintBackground. ( I38660 )
- Draw Selection Background using DrawScope. ( I73c61 , b/186674472 )
- A beta06 regression affecting Row/Column using spacedBy arrangements to layout weighted children was fixed. ( Ifaf8c , b/187326588 )
Версия 1.0.0-beta06
5 мая 2021 г.
androidx.compose.foundation:foundation:1.0.0-beta06
and androidx.compose.foundation:foundation-layout:1.0.0-beta06
are released. Версия 1.0.0-beta06 содержит эти коммиты.
Изменения API
- Solve Conflict with Navigation Gesture ( I1145e )
- Added CollectionInfo and CollectionItemInfo accessibility APIs that allows to mark collection and its items for accessibility services ( Id54ef , b/180479017 )
- Added
SemanticsActions.ScrollToIndex
to scroll a list with indexed items to the item with a certain index, andSemanticsProperties.IndexForKey
to get the index of an item in a list with keyed items. Both actions are implemented by LazyList.- Added
SemanticsNodeInteraction.performScrollToIndex
that scrolls a list to the given index, andSemanticsNodeInteraction.performScrollToKey
that scrolls a list to the item with the given key. ( I4fe63 , b/178483889 , b/161584524 )
- Added
- AnnotatedString save support to TextFieldValue.Saver. Added addTtsAnnotation and withAnnotation utility functions to AnnotatedString.Builder ( I8cbdc , b/178446304 )
- Default
0.dp
parameter values were added toPaddingValues(horizontal, vertical)
( I05571 , b/181336792 )
Исправления ошибок
- Row & Column children with
weight(fill = false)
are no longer making the parent fill the entire available main axis space. ( Ied94d , b/186012444 , b/184355105 )
Версия 1.0.0-бета05
21 апреля 2021 г.
androidx.compose.foundation:foundation:1.0.0-beta05
and androidx.compose.foundation:foundation-layout:1.0.0-beta05
are released. Версия 1.0.0-beta05 содержит эти коммиты.
Изменения API
- FlingBehavior interface is now marked as @Stable. All implementations should comply with the
@Stable
contract. ( I93354 , b/184830577 )
Исправления ошибок
- Fixed
ACTION_SCROLL_FORWARD
,ACTION_SCROLL_BACKWARD
,accessibilityActionScrollLeft
,accessibilityActionScrollUp
,accessibilityActionScrollRight
andaccessibilityActionScrollDown
accessibility scroll actions. Instead of scrolling to the end of the scrollable, it will now scroll by one screen in the given direction. ( Ieccb0 ) - Файлы AndroidManifest из ui-test-manifest и ui-tooling-data теперь совместимы с Android 12 ( I6f9de , b/184718994 ).
Версия 1.0.0-beta04
7 апреля 2021 г.
androidx.compose.foundation:foundation:1.0.0-beta04
and androidx.compose.foundation:foundation-layout:1.0.0-beta04
are released. Версия 1.0.0-beta04 содержит эти коммиты.
Изменения API
- Rename hideSoftwareKeyboard and showSoftwareKeyboard on SoftwareKeyboardController to
hide()
andshow()
respectively.- Provide the full CompositionLocal interface for LocalSoftwareKeyboardController, allowing it to be set (especially useful in tests) ( I579a6 )
-
TextOverflow.Visible
is introduced. ( Ic8f89 ) - Публичные экземпляры
RowScope
,ColumnScope
,BoxScope
,BoxWithConstraintsScope
были удалены. ( I4e83e , б/181869067 )
Исправления ошибок
- Fixed the issue when items of
LazyColumn
/LazyRow
located on the edges were incorrectly positioned after fast fling ( Ie4d13 , b/183877420 ) До этого изменения локальные составные функции можно было пропустить в зависимости от их параметров. После этого изменения никакие локальные составные функции не будут пропущены. Это изменение сделано потому, что локальные функции обычно захватывают параметры родительского элемента и их пропуск является распространенным источником ошибок.
Подводя итог, рассмотрим пример:
@Composable fun Counter(count: Int, onCountChange: (Int) -> Unit) { @Composable fun ShowCount() { Text("Count: $count") } ShowCount() Button(onClick={ onCountChange(count + 1) }) { Text("Increment") } }
До этого изменения составная функция
ShowCount
всегда пропускала работу, даже после обновления параметраcount
. Это уже не так. ( I5648a )
Версия 1.0.0-бета03
24 марта 2021 г.
androidx.compose.foundation:foundation:1.0.0-beta03
and androidx.compose.foundation:foundation-layout:1.0.0-beta03
are released. Версия 1.0.0-beta03 содержит эти коммиты.
Изменения API
-
DefaultMonotonicFrameClock
устарел. ВызовwithFrameNanos
илиRecomposer.runRecomposeAndApplyChanges
безMonotonicFrameClock
теперь будет вызывать исключениеIllegalStateException
. ( I4eb0d )
Исправления ошибок
-
FlingBehavior.performFling()
is now called even when velocity is 0 ( I0b6e5 , b/181237123 )
Версия 1.0.0-beta02
10 марта 2021 г.
androidx.compose.foundation:foundation:1.0.0-beta02
and androidx.compose.foundation:foundation-layout:1.0.0-beta02
are released. Версия 1.0.0-beta02 содержит эти коммиты.
Изменения API
- Multiple small optimizations in LazyColumn measuring logic were added ( Ic6889 )
- Added new
LocalSoftwareKeyboardController
composition local API to replace previous SoftwareKeyboardController interface on TextField. ( I5951e , b/168778053 ) - Added new
LocalSoftwareKeyboardController
composition local API to replace previous SoftwareKeyboardController interface on TextField. ( I84472 , b/168778053 )
Исправления ошибок
- Ввести ограничения на публичное использование экспериментальных API ( I6aa29 , b/174531520 ).
Версия 1.0.0-бета01
24 февраля 2021 г.
androidx.compose.foundation:foundation:1.0.0-beta01
and androidx.compose.foundation:foundation-layout:1.0.0-beta01
are released. Версия 1.0.0-beta01 содержит эти коммиты.
Это первый выпуск бета-версии Compose 1.0.0.
Изменения API
- onStart callback has been added to
detectDragGestures
( I67269 , b/179995594 ) - Modifiers for sizing to intrinsics are no longer experimental. ( I15744 )
- Removed dp assertions ( I798d2 )
- Removed SoftwareKeyboardController callback from all text fields to be replaced by a new API shortly. ( Iae869 , b/168778053 )
- MeasureBlocks was renamed to MeasurePolicy which became a fun interface. Layout APIs were updated / simplified to use MeasurePolicy. ( Icab48 , b/167662468 , b/156751158 )
-
InteractionState
заменено на[Mutable]InteractionSource
- Интерфейсы отвечают за отправку/сбор событий взаимодействия.
- Вместо передачи
interactionState = remember { InteractionState() }
таким компонентам, какButton
иModifier.clickable()
, используйтеinteractionSource = remember { MutableInteractionSource() }
. - Вместо:
Interaction.Pressed in interactionState
вам следует использовать функции расширения InteractionSource, такие как InteractionSource.collectIsPressedAsState(). - В сложных случаях использования вы можете использовать InteractionSource.interactions для наблюдения за потоком взаимодействий. Дополнительные сведения см. в документации и примерах InteractionSource.
- ( I85965 , б/152525426 , б/171913923 , б/171710801 , б/174852378 )
- Removed deprecated LayoutCoordinates methods, use function instead of the property for positionInParent and boundsInParent ( I580ed , b/169874631 , b/175142755 )
- Created new TextInputSession for input sessions from low level text components such as CoreTextField. ( I8817f , b/177662148 )
- Placeable now exposes measuredSize, representing the size which the child layout actually measured to. This size might not respect the measurement constraints. ( Ib2729 , b/172560206 , b/172338608 )
- Add selectionGroup modifier that allows to mark collection of Tabs or RadioButtons for accessibility purposes ( Ie5c29 )
Add LazyListState.animateScrollToItem
This method smooth scrolls to a specific item in the list. ( I4bfd7 )
ScrollableState.smoothScrollBy() was renamed to animateScrollBy() LazyListState.snapToItemIndex() was renamed to scrollToItem() ScrollState.smoothScrollTo() was renamed to animateScrollTo() ( I35ded )
Modifier.zoomable has been replaced my Modifier.transformable. smoothPanBy, smoothRotationBy have been added as a functionality. ( Ifc32b , b/175294473 )
defaultFactory
дляcompositionLocalOf
иstaticCompositionLocalOf
теперь является обязательным, а не необязательным.Это изменение устраняет потенциальную ошибку типа для типов, не допускающих значения NULL, если не указана фабрика по умолчанию. Раньше это давало нулевую ссылку для типа, не допускающего значения NULL.
Для типов, допускающих значение NULL, рассмотрите возможность использования
{ null }
в качестве фабрики по умолчанию.Мы не рекомендуем использовать локальные переменные с типами, не допускающими значения NULL, если только не может быть предоставлено разумное значение по умолчанию. Если разумного значения по умолчанию не существует, лямбда
defaultFactory
должна выдать исключение. Однако создание исключения означает, что потребители локального объекта будут иметь неявную зависимость от его предоставления, которая не обеспечивается системой типов. ( Еслиbd2a )Changed
Indication#createIndication()
toIndication#rememberUpdatedIndication(InteractionState)
and removesInteractionState
parameter from IndicationInstance#drawIndication()
. IndicationInstance should only be responsible for drawing visual effects, and not launching animations / writing state in response to InteractionState changes. These animations and state writes should happen withinrememberUpdatedIndication()
instead. Theindication
parameter inModifier.indication
was also changed to be a required parameter. ( Ic1764 , b/152525426 )Text actions now check focus automatically ( I13777 , b/179648629 )
Removed
runBlockingWithManualClock
( I15cdc , b/179664814 )Scroll position in Modifier.verticalScroll()/horizontalScroll() is represented with Ints now ( I81298 )
Пакеты методов SmoothScrollBy и ScrollBy изменены на
androidx.compose.foundation.gestures.*
( I3f7c1 , b/175294473 )FlingConfig has been renamed to FlingBehavior now allows for customization of suspend animation rather than predefined Decays. ( I02b86 , b/175294473 )
Модификаторы размера были переименованы. Modifier.width/height/size были переименованы в requireWidth/requiredHeight/requiredSize. Modifier.preferredWidth/preferredHeight/preferredSize были переименованы в ширину/высоту/размер. ( I5b414 )
defaultMinSizeConstraints was renamed to defaultMinSize. ( I4eaae )
Modifier.tapGestureFilter has been removed. Use
Modifier.pointerInput { detectTapGestures(...) }
instead. ( I266ed , b/175294473 )partial consumption was removed from pointer input system. The recommended way of coordinating partial consumtion is Modifier.nestedScroll. ( Ie9c9b )
Ориентация перенесена в пакет фундамента. VelocirtTracker перешёл с ui.gesture на ui.input.pointer. ( Iff4a8 , б/175294473 )
AnimationClockObservable и подклассы были удалены. AnimatedFloat был удален. ( Icde52 , б/177457083 )
drawerState.open() and drawerState.close() are now suspending functions. Use rememberCoroutineScope() to get the scope of the composition to call them ( I16f60 , b/175294473 )
Поставщики переименованы в CompositionLocalProvider.
- Конструктор композиции больше не принимает ключевой параметр и считается устаревшим.
- currentCompositeKeyHash превращен в составное свойство верхнего уровня вместо составной функции верхнего уровня.
- CompositionData и CompositionGroup были перемещены в пространство имен androidx.compose.runtime.tooling.
- ComposableLambda стал интерфейсом, а не конкретным классом, и больше не имеет параметров типа.
- ComposableLambdaN стал интерфейсом, а не конкретным классом, и больше не имеет параметров типа.
- Функция snapshotFlow была перенесена в пространство имен androidx.compose.runtime.
- метод слияния SnapshotMutationPolicy больше не является экспериментальным
- Функция ClearRoots верхнего уровня
@TestOnly
была удалена. В этом больше нет необходимости. - Функции keySourceInfoOf и resetSourceInfo были удалены. Они больше не нужны.
- Composer.collectKeySourceInformation удален. В этом больше нет необходимости.
- Методы isJoinedKey, joinKeyLeft и joinKeyRight были удалены. Они больше не нужны.
- Различные API верхнего уровня были перемещены и реорганизованы в разные файлы. Из-за семантики классов файлов Kotlin это нарушит двоичную совместимость, но не совместимость исходного кода, поэтому не должно быть проблемой для большинства пользователей.
- ( I99b7d , б/177245490 )
Modifier.scrollable has been reworked. Now it uses Scrollable interface instead of ScrollableController class ( I4f5a5 , b/174485541 , b/175294473 )
Modifier.draggable теперь принимает DraggableState вместо простой лямбды. вы можете создать состояние с помощью
rememberDraggableState { delta -> }
чтобы получить то же поведение, что и раньше ( Ica70f , b/175294473 )requiredWidth(IntrinsicSize) and requiredHeight(IntrinsicSize) modifiers were added for required sizing to intrinsic sizes. ( I0a6b4 )
Устаревший
emptyContent()
удален. Вместо этого используйте{}
. ( Idb33f , б / 179432510 )Удалены некоторые ранее устаревшие API ( Ice5da , b/178633932 ).
Исправления ошибок
- Added new LocalSoftwareKeyboardController composition local API to replace previous SoftwareKeyboardController interface on TextField. ( I658b6 , b/168778053 )
Версия 1.0.0-альфа12
10 февраля 2021 г.
androidx.compose.foundation:foundation:1.0.0-alpha12
and androidx.compose.foundation:foundation-layout:1.0.0-alpha12
are released. Версия 1.0.0-alpha12 содержит эти коммиты.
Изменения API
- Modifier.pointerInput теперь требует ключей запоминания, чтобы указать, когда сопрограмма обнаружения ввода указателя должна перезапуститься для новых зависимостей. ( I849cd )
- Testing update: hasText() will check for both input and label/hint/placeholder texts in the text field ( Iab803 )
- PaddingValues.Absolute was added and can be used in APIs accepting PaddingValues. ( Ia5f30 )
- onImeActionPerformed is deprecated. use KeyboardActions instead ( If0bbd , b/179071523 )
- In order to better match naming conventions with ImageBitmap and ImageVector, ImagePainter has been renamed to BitmapPainter to parallel VectorPainter. ( Iba381 , b/174565889 )
- Better substring test APIs with substring now as an argument ( Icbe78 )
- Представлен элемент контекста сопрограммы
InfiniteAnimationPolicy
, который будет применяться в бесконечной анимации. По умолчанию политика не установлена, за исключением случаев запуска тестов с помощьюComposeTestRule
. ( I50ec4 , б / 151940543 ) - Animatable.snapTo и Animatable.stop теперь являются функциями приостановки ( If4288 ).
- ComponentActivity.setContent перемещен в androidx.activity.compose.setContent в модуле androidx.activity:activity-compose. ( Icf416 )
- Методы деструктуризации и копирования() были удалены из нескольких классов, где они использовались редко. ( I26702 , б/178659281 )
Custom keys support for LazyColumn/LazyRow was added. This allows us to smarter handle items reordering. So the state you stored in remember {} blocks will move together with the item when you reorder elements or removed the item from the middle.
LazyColumn { items(users, key = { user -> user.id }) { ... } }
- ( Ia50ef , b/164901852 )
Changed Indication#createInstance to be @Composable, and changed LocalIndication to contain an Indication, not () -> Indication. ( I5eeea , b/157150564 )
Constraints.enforce
was replaced withConstraints.constrain
. ( I8b8ea )loadFontResource is deprecated. Use fontResource instead. imageResource, loadImageResource, vectorResource, and loadVectorResource are deprecated. Use painterResource instead. ( I6b809 )
For performance reasons, ScrollAxisRange semantics now takes lambdas returning Floats instead of direct Float values. ( If4a35 , b/178657186 )
Added EditableText semantics to mark editable input text of the text field for accessibility and corresponding test methods to check the semantics ( I8e07a )
Modifier.clickable now doesn't have double and long click support. Use Modifier.combinedClickable to achieve this functionality. ( Iafad1 )
toIntPx() was renamed to roundToPx(). ( I9b7e4 , b/173502290 )
IntBounds was renamed to IntRect and the API was improved. ( I1f6ff )
Modifier.dragGestureFilter has been deprecated. Use
Modifier.pointerInput { detectDragGestures (...)}
instead. Alternatively, use Modifier.draggable for one axis drags ( I0ba93 , b/175294473 )Переименованы Ambients в соответствии с переименованием Ambient -> CompositionLocal. Раньше окружения назывались AmbientFoo, теперь CompositionLocals называются LocalFoo. ( I2d55d )
Selection was moved to foundation. ( I7892b )
Аналогично тому, как мы ранее удаляли компонуемое
state { 0 }
и теперь продвигаем его использование, например,remember { mutableStateOf(0) }
мы собираемся удалить компонуемоеsavedInstanceState { 0 }
. Вместо этого вам следует использоватьrememberSaveable { mutableStateOf(0) }
, и он будет автоматически сохраняться и восстанавливаться, если тип, используемый внутри MutableState, может быть сохранен в Bundle. If previously you were passing a custom saver object now you need to use a new overload of rememberSaveable which has thestateSaver
parameter. Использование будет выглядеть следующим образом:val holder = rememberSaveable(stateSaver = HolderSaver) { mutableStateOf(Holder(0)) }
( Ib4c26 , b/177338004 )Added password semantics for accessibility ( I231ce )
Added ProgressBarRangeInfo.Indeterminate to mark indeterminate progress bars for accessibility ( I6fe05 )
Время воспроизведения анимации теперь ограничено наносекундами ( If776a ).
@ComposableContract устарел в пользу трех более конкретных аннотаций.
@ComposableContract(restartable = false)
стал@NonRestartableComposable
@ComposableContract(readonly = true)
стал@ReadOnlyComposable
@ComposableContract(preventCapture = true)
стал@DisallowComposableCalls
@ComposableContract(tracked = true)
был удален. ( I60a9d )Утилиты
emptyContent()
и(@Composable () -> Unit).orEmpty()
устарели, поскольку они больше не оказывают положительного влияния на производительность или не имеют ценности ( I0484d ).Теперь рекомпозиторы можно закрыть. Закрытые рекомпозеры будут продолжать рекомпозицию до тех пор, пока не завершится дочерняя сопрограмма композиции. Recomposer.shutDown переименован в cancel в отличие от close. ( Ib6d76 )
APIs related to LazyVerticalGrid are marked as experimental ( Ia53e3 , b/178519862 )
RememberSavedInstanceState() был переименован в RememberSaveable() и перемещен в пакет androidx.compose.runtime.saveable. ( I1366e , б / 177338004 )
RestorableStateHolder был переименован в SaveableStateHolder и перемещен в пакет androidx.compose.runtime.saveable. Внутренний метод RestorableStateProvider был переименован в SaveableStateProvider. Общий тип был удален, поэтому вы можете просто передать Any в качестве ключа. Экспериментальная аннотация больше не нужна. ( I0902e , б/174598702 )
Saver, listSaver(), mapSaver(), autoSaver was moved from androidx.compose.runtime.savedinstancestate to androidx.compose.runtime.saveable ( I77fe6 )
Artefact androidx:compose:runtime:runtime-saved-instance-state was renamed to androidx:compose:runtime:runtime-saveable ( I6dcac )
Many longstanding deprecated APIs in the ui package are deleted. ( I2f2dc )
Артефакт compose:runtime-dispatch устарел. MonotonicFrameClock теперь можно найти в compose:runtime, а AndroidUiDispatcher можно найти в compose:ui. ( Ib5c36 )
Parameters on RounderCornerShape, CutCornerShape and CornerBasedShape were renamed from left/right to start/end in order to support the shape's auto mirroring in the rtl direction. AbsoluteRounderCornerShape and AbsoluteCutCornerShape were introduced for the cases when auto-mirroring is not desired. ( I61040 , b/152756983 )
canDrag has been removed from the Modifier.scrollable. ( Id66e7 , b/175294473 )
API, на который нацелен плагин компилятора Compose, был реорганизован для использования интерфейса вместо конкретного класса. Интерфейс также больше не использует параметр типа.
Это внутреннее изменение, которое не должно влиять на совместимость исходного кода, но является двоичным критическим изменением. ( I3b922 , б/169406779 )
Modifier.scaleGestureFilter has been removed. Use Modifier.zoomable instead. Alternatively, use
Modifier.pointerInput { detectMultitouchGestures { ... }}
( Id5da1 , b/175294473 )AnimatedValue/Float больше не поддерживается. Вместо этого используйте Animatable. ( I71345 , б / 177457083 )
- Removed CoreText and CoreTextField from public API
- Removed deprecated SelectionContainer overload ( I99c19 )
Remove deprecated non-suspend scrolling functions Continuing with the changes from last release, the non-suspend scrolling functions are now removed entirely. Please convert to the suspend functions with the same names. A coroutine scope can be obtained via rememberCoroutineScope(). ( I3d39c , b/178169563 )
androidx.compose.foundation.layout.ConstraintLayout was deprecated in favor of androidx.constraintlayout.compose.ConstraintLayout. You will need to add a dependency on
androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha01
. ( I87adc )TapGestureFilter, doubleTapGestureFilter, longPressGestureFilter и pressIndicaitonGestureFilter устарели. Вместо этого используйте Modifier.clickable или Modifier.pointerInput с функцией обнаруженияTapGestures. ( I6baf9 , б/175294473 )
Removed
Recomposer.current()
. [Аннотация] ComposeView теперь по умолчанию использует лениво создаваемые рекомпозеры с областью действия окна, управляемые ViewTreeLifecycleOwner для окна. Рекомпозиция и анимация на основе withFrameNanos приостанавливаются, пока жизненный цикл узла остановлен. ( I38e11 )Recomposer.runningRecomposers теперь предлагает глобальный StateFlow RecomposerInfo, доступный только для чтения, для наблюдения за текущим состоянием композиции в процессе. Предпочитайте этот API Recomposer.current(), который сейчас устарел. ( If8ebe )
Версия 1.0.0-альфа11
28 января 2021 г.
androidx.compose.foundation:foundation:1.0.0-alpha11
and androidx.compose.foundation:foundation-layout:1.0.0-alpha11
are released. Версия 1.0.0-alpha11 содержит эти коммиты.
Изменения API
Deprecate non-suspend scrollBy, remove non-suspend scrollTo
We now recommend using suspend functions to control scrolling and wait for the scroll to finish. We are deprecating and/or removing the non-suspend versions of these functions as part of this transition. ( Ie9ced )
Deprecate non-suspend smoothScrollBy We now recommend using suspend functions to control scrolling and wait for the scroll to finish. We are deprecating the non-suspend versions of these functions as part of this transition. ( I12880 )
К изображению и значку добавлен параметр описания контента. Он используется для предоставления описания служб доступности ( I2ac4c ).
BasicTextField received a new parameter called 'decorationBox'. It allows to add the decorations like icons, placeholder, label and similar to the text field and increase the hit target area of it. ( I16996 )
canDrag parameter has been removed from the Modifier.draggable ( Ic4bec , b/175294473 )
AnimatedFloat.fling that accepts FlingConfig has been removed. Please use suspend Animatable.animateDecay instead. ( I4659b , b/177457083 )
Removed
data class
from the following classes:- InlineTextContent
- LocaleList
- ( I605c7 )
Кликабельные, переключаемые и выбираемые теперь можно создавать вне композиции ( I0a130 , b/172938345 , b/175294473 )
ScrollableColumn/Row were deprecated. Using ScrollableColumn is less efficient comparing to LazyColumn when you have a large scrolling content because with LazyColumn we can only compose/measure/draw visible elements. To prevent users from going inefficient way we decided to deprecate ScrollableColumn and ScrollableRow and promote usages of LazyColumn and LazyRow instead. Users can still decide they don't need the lazy behaviour and use the modifiers directly like this: Column(Modifier.verticalScroll(rememberScrollState())) ( Ib976b , b/170468083 )
Новый фабричный метод
items(count: Int)
для области LazyColumn/LazyRow/LazyVerticalGrid.items(items: List)
иitemsIndexed(items: List)
теперь являются функциями расширения, поэтому вам придется вручную импортировать их при использовании. Новые перегрузки расширений для массивов: items(items: Array) и itemsIndexed(Array) ( I803fc , b/175562574 )The deprecated AbsoluteArrangement was removed. ( Iffa96 , b/177641870 )
The propagateMinConstraints parameter was added to Box, for specifying whether the incoming min constraints should be passed to the content of the Box or not. Default is false. ( I0125b , b/152613457 )
Исправления ошибок
- onCommit, onDispose и onActive устарели в пользу API SideEffect и DisposableEffect ( If760e ).
- WithConstraints был переработан как BoxWithConstraints и перемещен в Foundation.layout. ( I9420b , б/173387208 )
Changes to factory functions for Font/FontFamily/Typeface
- Added factory functions that start with capital letter
- Deprecated previous factory functions with lowercase first letters
- New factory functions return the FontFamily instead of subclasses
- Hid constructors of the subclasses, so that they can only be constructed via factory functions.
- Renamed Font.asFontFamily to Font.toFontFamily
- ( I42aa7 )
Introduced
ComposeContentTestRule
, which extendsComposeTestRule
and definessetContent
, which has been removed fromComposeTestRule
. Added a factory methodcreateEmptyComposeRule()
that returns aComposeTestRule
and does not launch an Activity for you. Use this when you want to launch your Activity during your test, eg usingActivityScenario.launch
( I9d782 , b/174472899 )animateAsState теперь называется animateFooAsState, где Foo — тип анимируемой переменной. например Float, Dp, Offset и т. д. ( Ie7e25 )
Density is now receiver scope for Arrangement interfaces. ( I18aad )
TextFieldValue accepts AnnotatedString. However this is an API only change and multi-style text editing is not implemented yet.
- Removed
initial
from EditingBuffer constructor parameters. ( I326d5 )
- Removed
validate и CompositionReference() теперь устарели в пользу currentRecomposeScope и RememberCompositionReference соответственно. ( I583a8 )
AnnotatedString is changed to extend from kotlin.CharSequence. Therefore length and subSequence are now instance functions, and extension functions are removed. ( Iaf429 )
Длительность и Время работы будут заменены на Длинные миллисекунды, и этот шаг устранит зависимость ввода указателя от этих классов. ( Ia33b2 , б/175142755 , б/177420019 )
RememberObserver заменяет CompositionLifecycleObserver, а CompositionLifecycleObserver теперь устарел.
RememberObserver
— это заменаCompositionLifecycleObserver
с измененной семантикой и переименованными методами. Переход на новый API можно выполнить механически для объектов, которые запоминаются только один раз, что является и остается рекомендуемой практикой. Однако если ссылка была запомнена в композиции более одного раза,onRemembered
вызывается для каждой ссылки, тогда какonEnter
вызывается только один раз.onEnter
вызывался несколько раз, если объект использовался в подкомпозициях, таких какWithConstraints
иScaffold
что делало гарантию единственного вызоваonEnter
ненадежной, и он был удален дляRememberObserver
.RememberObserver
добавляетonAbandoned
, который вызывается, если экземплярRememberObserver
возвращается из обратного вызова, переданного дляremember
но не был запомнен в состоянии композиции и, следовательно, никогда не будет вызыватьonRemembered
. Это может произойти, если исключение завершает композицию до ее завершения или композиция отбрасывается, поскольку состояние, создававшее композицию, больше не является текущим или по какой-либо причине больше не требуется. Если экземплярRememberObserver
, следующий приведенной выше рекомендации по одной ссылке, отслеживает внешний ресурс, тоonForgotten
иonAbandoned
указывают на то, что ресурс больше не нужен. Если объект отслеживает начало работы или ресурсы, выделенные вonRemembered
,onAbandoned
можно игнорировать, поскольку он не будет вызываться, если вызываетсяonRemembered
. ( I02c36 )Renamed TransformedText.transformedText to TransformedText.text
- TransformedText is no longer a data class ( Ie672a )
The following classes are not data classes anymore:
- AnnotatedString
- ParagraphStyle
- SpanStyle
- TextStyle
- FontWeight
- TextDecoration
- TextGeometricTransform
- TextIndex
- TextLayoutResult
- TextLayoutInput ( Iaff99 )
Removed experimental monotonicFrameAnimationClockOf methods ( Ib753f , b/170708374 )
Deprecated global coordinates methods and made new window-based coordinates methods. ( Iee284 )
Please use ImeAction.None instead of ImeAction.NoAction
- Please use ImeAction.Default instead of ImeAction.Unspecified ( Ie1bcc )
FocusRequester.createRefs is now marked as experimental as it might change. ( I2d898 , b/177000821 )
SemanticsPropertyReceiver.hidden was renamed to invisibleToUser and marked @ExperimentalComposeUiApi. AccessibilityRangeInfo was renamed to ProgressBarRangeInfo. stateDescriptionRange was renamed to progressBarRangeInfo. AccessibilityScrollState was renamed to ScrollAxisRange. horizontalAccessibilityScrollState was renamed to horizontalScrollAxisRange. verticalAccessibilityScrollState was renamed to verticalScrollAxisRange. ( Id3148 )
Changed VisualTransformation to be a functional interface ( I3bba4 )
Использование TestCoroutineDispatcher при тестировании ( I532b6 )
Удален PointerInputData и изменен PointerInputChange, чтобы передать ему все поля PointerInputData. PointerInputEvent и PointerInputEventData сделаны внутренними, поскольку они не используются ни в одном общедоступном API. ( Ifff97 , б/175142755 )
Renamed TextInputService.onStateUpdated as updateState ( Id4853 )
Remove displaySize as it should be avoided. Typically it is better to use size of onRoot() or window size at least. ( I62db4 )
Версия 1.0.0-альфа10
13 января 2021 г.
androidx.compose.foundation:foundation:1.0.0-alpha10
and androidx.compose.foundation:foundation-layout:1.0.0-alpha10
are released. Версия 1.0.0-alpha10 содержит эти коммиты.
Изменения API
- ImeOptions and KeyboardOptions are no more a data class ( I3c898 , b/168684531 )
- VisualTransformation API Changes
- Renamed OffsetMap to OffsetMapping
- Renamed OffsetMapping.identityOffsetMap to OffsetMapping.Identity
- PasswordTransformation is no longer data-class
- Moved OffsetMapping to its own file
- ( I0bdf3 )
- EditOperations API Changes
- Renamed EditOperation as EditCommand
- Added Command suffix for EditOperation concrete implementations
- EditCommand's are no longer data classes
- Renamed EditOperation.process function to applyTo
- Renamed InputEventListener to InputEventCallback
- ( I0a366 )
- Изменена скорость, чтобы в ней были составные части и математические операции. ( Ib0447 )
- @ExperimentalTesting переименован в @ExperimentalTestApi, чтобы соответствовать аналогичным экспериментальным аннотациям API ( Ia4502 , b/171464963 ).
- Added experimental stickyHeader method for LazyColumn/LazyRow ( I0a81d )
- Ranamed Color.useOrElse() to Color.takeOrElse() ( Ifdcf5 )
- Deprecated TestUiDispatcher. Use Dispatchers.Main instead ( Ic171f , b/175385255 )
- Add Toggle to foundation Strings.kt ( I4a5b7 , b/172366489 )
- Moved nativeClass to ui module and made it internal. Updated usages of nativeClass in equals implementations to use 'is MyClass' instead. ( I4f734 )
- FlowRow and FlowColumn were deprecated. Please use a custom layout instead. ( I09027 )
- Modifier.focus() and Modifier.focusRequester() are deprecated. Use Modifier.focusModifier() and Modifier.focusReference() instead. ( I75a48 , b/175160751 , b/175160532 , b/175077829 )
- Introduced SelectionRegistrar.notifySelectableChange to notify Selectable updates to SelectionManager. ( I6ff30 , b/173215242 )
- Changed
fun Dp.isFinite()
to aval Dp.isFinite
( I50e00 ) - Constraints#satisfiedBy was renamed to isSatisfiedBy. ( I9cf5c )
- Added isSpecified, isUnspecified, and useOrElse for inline classes with an Unspecified constant. ( I93f7b , b/174310811 )
Исправления ошибок
- Новый API
Animatable
на основе сопрограмм, обеспечивающий взаимоисключаемость анимаций. Новая DecayAnimationSpec для поддержки многомерной анимации затухания ( I820f2 , b/168014930 ). - Added support for disabled and read-only text fields ( I35279 , b/171040474 , b/166478534 )
-
animate()
теперь заменен наanimateAsState()
, который возвращаетState<T>
вместоT
Это позволяет повысить производительность, поскольку область аннулирования можно сузить до места, где считывается значение состояния. ( Ib179e ) - Add Semantics role API and add Role as a parameter to clickable, selectable and toggleable SemanticsModifier. Changed Modifier.progressSemantics so that Slider can also use it. ( I216cd )
- Доступ к собственному keyEvent теперь можно получить через keyEvent.nativeKeyEvent ( I87c57 , b/173086397 ).
Версия 1.0.0-альфа09
16 декабря 2020 г.
androidx.compose.foundation:foundation:1.0.0-alpha09
and androidx.compose.foundation:foundation-layout:1.0.0-alpha09
are released. Версия 1.0.0-alpha09 содержит эти коммиты.
Изменения API
Add Scrollable interface
This allows ScrollState and LazyListState to be treated as a common type, allowing custom scrolling to be implemented across both types.
This also moves smoothScrollBy to an extension function on Scrollable, taking advantage of this functionality. ( I2153b )
LazyVerticalGrid is added. ( I17267 , b/162213211 )
Отрешить Lazycolumnfor, Lazyrowfor, Lazycolumnforindexed и Lazyrowforindexed. Вместо этого используйте Lazycolumn и Lazyrow ( i5b48c )
Для приостановки API ввода указателя переименован в GrandpointerInputScope AwaitPointerEventScope и handlePointerInput () в AwaitPointerEventScope (). ( IDF0A1 , B/175142755 )
LazyListState.layoutInfo was added which exposes the list of sizes and offsets of the currently visible items ( If8678 , b/170472532 )
Удаленная аннотация ExperimentalPointerInput ( IA7A24 )
InteractionState support for TextFields has been added. ( I61d91 )
Add reverseLayout param for LazyColumn/Row. when
true
items will be composed from the bottom to the top andLazyListState.firstVisibleItemIndex == 0
will mean the first item is located at the bottom. ( I552ae , b/166589935 )verticalArrangement param was added for LazyColumn. horizontalArrangement param was added for LazyRow. Arrangement allows us to add a spacing between items and specify the arrangement of the items when we do not have enough of them to fill the whole minimum size. ( Icf79a , b/170394300 )
detectMultitouchGestures now uses one callback with combined centroid, pan, zoom and rotate parameters. ( Ie6e1c )
Moved ContentDrawScope to ui-graphics module to be with DrawScope. ( Iee043 , b/173832789 )
Исправления ошибок
- Lambdas в смещенных модификаторах теперь возвращают Intoffset, а не плавают. ( IC9EE5 , B/174137212 , B/174146755 )
Удалены SlotTable, SlotReader и SlotWriter из общедоступного API. Ранее они были отмечены как InternalComposeAPI. Теперь они являются внутренними для модуля составления.
CompositionData и CompositionGroup были добавлены в качестве замены API ui-tooling, используемого для извлечения информации о композиции. Они являются общедоступными, но не предназначены для использования за пределами API ui-tooling, поскольку они предоставляют необработанную информацию, которую интерпретирует API ui-tooling ( I31a9c ).
Refactored ShaderBrush to lazily create a shader instance when sizing information of the drawing environment is available. This is useful to define gradients that occupy the full drawing bounds of a composable at composition time, without having to implement custom DrawModifier implementations.
Deprecated gradient function constructor APIs in favor of factory methods on a Gradient object. ( I511fc , b/173066799 )
Modifier.focusObserver is deprecated. Use Modifier.onFocusChanged or Modifier.onFocusEvent instead ( I30f17 , b/168511863 , b/168511484 )
Autofill API is now experimental API and requires opt-in ( I0a1ec )
Adding destructuring declarations to create FocusRequester instances ( I35d84 , b/174817008 )
accessibilityLabel has been renamed to contentDescription. accessibilityValue has been renamed to stateDescription. ( I250f2 )
Introduced several new functions in SelectionRegistrar and also renamed onPositionChange to notifyPositionChange. ( Ifbaf7 )
AndroidOwner сделал внутренний ( Ibcad0 , b/170296980 )
Новая бесконечная функция для создания InfiniteRepeatablepec ( i668e5 )
Интерфейс
Applier
был изменен, чтобы упростить построение деревьев снизу вверх, а не сверху вниз.Метод
insert()
был переименован вinsertTopDown()
.Был добавлен новый метод
insertBottomUp()
.Прикладчик либо вставляет узлы в дерево, которое он редактирует, с помощью
insertTopDown()
илиinsertBottomUp()
в зависимости от того, что работает лучше.Некоторые деревья, такие как
LayoutNode
иView
, гораздо эффективнее строить снизу вверх, чем сверху вниз. До этого изменения для реализации восходящего движения требовался стек вставок, который нужно было копировать в каждое приложение, которому для повышения производительности требовалась восходящая конструкция. Благодаря этому изменениюApplier
переопределяетinsertBottomUp()
для построения дерева снизу вверх иinsertTopDown()
для построения дерева сверху вниз. ( Icbdc2 )Added painterResource API to handle opaquely loading Painter objects from either rasterized asset formats (like PNGs) or VectorDrawables. Consumers no longer have to determine the type of asset in advance and can call this method to get a Painter object to use in Image composables or painter modifiers. ( I2c703 , b/173818471 )
Added buildAnnotatedString factory function in order to build an AnnotatedString. Deprecated annotatedString builder function. ( Idfe0b )
Версия 1.0.0-альфа08
2 декабря 2020 г.
androidx.compose.foundation:foundation:1.0.0-alpha08
and androidx.compose.foundation:foundation-layout:1.0.0-alpha08
are released. Версия 1.0.0-alpha08 содержит эти коммиты.
Изменения API
- Removed
maxLines
parameter from theCoreTextField
. If you'd like to constraint the height of the text field by the number of lines, useBasicTextField
instead. ( Iec002 ) - Changed the
await*TouchSlop()
methods to not detect the pointer down and renamed them to*OrCancellation
. Also removed the need fororientationLock
parameter. ( Ie96e1 ) - Добавлена проверка на предмет именования и положения составных лямбда-параметров, чтобы проверить соответствие рекомендациям по составлению. Также в соответствии с проверкой ворса и рекомендациями некоторые API-интерфейсы, использующие
children
в качестве имени своей конечной лямбды, были перенесены вcontent
. ( Мек48е ) -
foundation:foundation-text
apis moved tofoundation:foundation
. The package structure remained the same ( Id3eb2 ) - New multitouch gesture detector, including helpers for detecting rotation, zoom, and panning. ( Ic459d )
- New drag gesture detector suspending pointer input API, including orientation locking. ( Icef25 )
- Renamed VectorAsset to ImageVector Moved and renamed VectorAsset to Builder to be an inner class of ImageVector as per API council guidelines. Added typealias of VectorAssetBuilder to link to ImageVector.Builder for compat. ( Icfdc8 )
- Renamed ImageAsset and related methods to ImageBitmap. ( Ia2d99 )
- Moved foundation semantics properties to ui ( I6f05c )
Add coroutine-based scrolling APIs:
Adds LazyListState.snapToItem and LazyListState.smoothScrollBy, as well as lower-level APIs for scroll control. These APIs provide a suspend interface to control scrolling that waits until the scroll is finished before returning. ( Ie5642 )
Added a singeLine parameter into BasicTextField, TextField and OutlinedTextField. Set this parameter to true to make the text field a single horizontally scrollable line. ( I57004 , b/168187755 )
Gesture detector for tap, double-tap, long press, and press indication were added using the new suspending pointer input. A few utilities were added as well, making it easier for developers to write their own gesture detectors. ( I00807 )
Modifier.focusable has need added in foundation. Use this to add focusable behavior to a component, with correct semantics and accessibility. ( I41eb9 , b/152525426 , b/162865824 )
Previously deprecated APIs have been removed: Border was removed, use BorderStroke instead. Modifier.drawBorder was removed, use Modifier.border instead. Modifier.gravity was removed, use Modifier.align instead. Stack was removed, use Box instead ( I32c2b , b/172470874 )
AbsoluteArrangement was renamed to Arrangement.Absolute. ( If26f2 )
Исправления ошибок
- Moved DrawModifier APIs from the androidx.compose.ui package to the androidx.compose.ui.draw package. Created DrawModifierDeprecated.kt file to include typealiases/helper methods to assist with the migration from the deprecated to the current APIs. ( Id6044 , b/173834241 )
- Переименованный модификатор.drawlayer to modifier.graphicslayer также обновил связанные классы для GraphicsLayer в соответствии с отзывом Совета API. ( I0BD29 , B/173834241 )
-
<T>
was removed from SubcomposeLayout declaration. You can use it without specifying a type now. ( Ib60c8 ) - Сделано поля и положения PointerinPutData. ( Id468a )
- MaterialTheme now sets the correct colors for selection handles and selection background. Non-Material apps can manually use AmbientTextSelectionColors to customize the colors used for selection. ( I1e6f4 , b/139320372 , b/139320907 )
- The alignment parameter of Box was renamed to contentAlignment. ( I2c957 )
- Модификаторы OffsetPX были переименованы в смещение. Сейчас они принимают параметры Lambda вместо состояния. ( IC3021 , B/173594846 )
- Added WindowManager.isWindowFocused to check if the host window is in focus, and a WindowFocusObserver that provides an onWindowFocusChanged callback. ( I53b2a , b/170932874 )
- Added resetInput parameter to TextInputService#onStateUpdated ( I3e8f5 , b/172239032 , b/171860947 )
- Updated TextFieldValue API
- made TextFieldValue.composition readonly
- removed exception thrown for invalid selection range ( I4a675 , b/172239032 )
- Устаревшие свойства Ambient с суффиксом
Ambient
заменены новыми свойствами с префиксом Ambient в соответствии с другими рекомендациями API Ambient и Compose. ( я33440 ) - Added Android Typeface wrapper. You can load an Android Typeface via
typeface
function ietypeface(Typeface.DEFAULT)
. Also renamedtypefaceFromFontFamily()
totypeface()
( I52ab7 ) - Added lint check to check that Modifier factories use
androidx.compose.ui.composed {}
internally, instead of being marked as@Composable
. ( I3c4bc ) - Added lint check to check that Modifier factory functions are defined as extensions on Modifier, so they can be fluently chained together. ( I07981 )
- Semantics argument mergeAllDescendants was renamed to mergeDescendants. ( Ib6250 )
- Контроль времени в тестах (TestanimationClock и его использование) в настоящее время экспериментально ( i6ef86 , b/171378521 )
- Удалите старый модуль ui-test и его заглушки ( I3a7cb ).
- TextUnit.Inherit is renamed to TextUnit.Unspecified in consistent with other units. ( Ifce19 )
- Интерфейс выравнивания был обновлен и сделан функциональным. ( I46a07 , b/172311734 )
-
foundation:foundation-text
module has been merged intofoundation:foundation
( Idac0f ) - Deprecate place(Offset) and placeRelative(Offset). Use overloads with int offsets instead ( I4c5e7 )
-
id
was renamed tolayoutId
forLayoutIdParentData
.Measurable.id
was renamed toMeasurable.layoutId
. ( Iadbcb , b/172449643 )
Версия 1.0.0-альфа07
11 ноября 2020 г.
androidx.compose.foundation:foundation:1.0.0-alpha07
, androidx.compose.foundation:foundation-layout:1.0.0-alpha07
, and androidx.compose.foundation:foundation-text:1.0.0-alpha07
are released. Версия 1.0.0-alpha07 содержит эти коммиты.
Изменения API
- Similarly to
Modifier.fillMaxSize[Width|Height]
we now support fractions inModifier.fillParentMaxSize[Width|Height]
inside the scope ofLazyColumn/Row
( I797e2 , b/166586426 ) - Removed
KeyboardOptions.toImeOptions
from public API. ( Ic2e45 ) - Фонд AmbientTextStyle, ProvidetextStyle и AmbientContentColor были устарели. Вместо этого используйте новые версии, доступные в библиотеке материалов. Для нематериальных приложений вы должны вместо этого создать собственную систему дизайна, которые можно использовать в ваших собственных компонентах. ( I74ACC , B/172067770 )
- Foundation.Text устарел и заменен на Material.Text. Базовый, независимый текстовый API, который не использует значения из темы, см. в androidx.compose.foundation.BasicText. ( Если64cb )
- Added maxLines to TextFields ( Ib2a5b )
- Update TextFields to accept KeyboardOptions ( Ida7f3 )
- Added KeyboardOptions for use in TextFields ( I9ca32 )
- Adds BasicText as a design-unopinionated API for text, parallel to BasicTextField. ( I28268 )
- ExperimentalLazyDsl annotation was removed. LazyColumn/LazyRow can now be used without adding @OptIn ( Idab7a , b/166584730 )
- BaseTextField устарел. Вместо этого используйте BasicTextField. ( I896eb )
- BasicTextField has been added as a replacement for both CoreTextField and BaseTextField ( Id4cea )
- Remove deprecated LazyColumnItems/LazyRowItems ( I1d8a8 )
- The deprecated composables for sizing to intrinsic measurements were removed. ( I18537 , b/171811496 )
- relativePaddingFrom was renamed to paddingFrom. The paddingFromBaseline modifier was added, as convenience for specifying distances from layout bounds to text baselines. ( I0440a , b/170633813 )
- The matchHeightConstraintsFirst parameter was added to the aspectRatio modifier, which can be used to specify the modifier to size to height constraints before trying the width correspondents. ( Ie7c43 , b/155290593 )
- The deprecated DpConstraints was removed. ( I87884 , b/171702471 )
Исправления ошибок
- Introduced ScaleFactor inline class to represent scale factors for the horizontal and vertical axes independent of one another in order to support non-uniform scaling use cases.
- Added computeScaleFactor method to ContentScale
- Added ContentScale.FillBounds to perform non-uniform scaling to stretch the src bounds to fully occupy the destination.
- Added operator methods to compute ScaleFactor parameters with Size parameters.
- ( Ic96a6 , b/172291582 )
- captureToBitmap moved to captureToImage. ( I86385 )
- Marks CoreText as @InternalTextApi. Use BasicText instead. ( I6aaeb )
- Rename KeyboardOptions as ImeOptions ( I82f36 )
- Moved KeyboardType and ImeAction into KeyboardOptions ( I910ce )
- CoreTextField has been marked as @InternalTextApi. Use BasicTextField instead ( Ie2469 )
- ExperimentalSubcomposeLayoutApi annotation was removed. SubcomposeLayout can now be used without adding @OptIn ( I708ad )
- Introduce ui-test-junit4 module ( Ib91f8 )
- Updated Icon API to take in Color.Unspecified as a possible tint color which will draw the provided asset or painter without a ColorFilter. Previously attempts to ignore tinting with Color.Unspecified would tint with a transparent color ending up with nothing rendered at all. ( I049e2 , b/171624632 )
- Measersult был выброшен из -за мер. ( IBF96D , B/1711844002 )
- Несколько символов, связанных с макетом, были перенесены из androidx.compose.ui в androidx.compose.layout.ui. ( I0fa98 , б/170475424 )
- androidx.ui.test moved to androidx.compose.ui.test ( I9ffdb )
- FirstBaseline and LastBaseline were moved to androidx.compose.ui.layout package ( Ied2e7 )
- Added SelectionContainer without the callback ( Ibfadb )
- Add Tests for SelectionHandles' Positions in SelectionContainer. ( Ie93db )
- Added Keyboard auto correct IME Option ( I57b8d )
Версия 1.0.0-альфа06
28 октября 2020 г.
androidx.compose.foundation:foundation:1.0.0-alpha06
, androidx.compose.foundation:foundation-layout:1.0.0-alpha06
, and androidx.compose.foundation:foundation-text:1.0.0-alpha06
are released. Версия 1.0.0-alpha06 содержит эти коммиты.
Изменения API
- androidx.compose.foundation.Icon has been moved to androidx.compose.material.Icon. You can also use the Image component / Modifier.paint() with a Painter if you do not want to use the Material library. ( I9f622 )
- Added interactionState to Modifier.scrollable, ScrollableColumn and LazyColumnFor ( I81566 , b/169509805 )
- alignByBaseline was added to RowScope and alignWithSiblings was renamed to alignBy ( I06503 , b/170628732 )
- Box was made an inline function. ( Ibce0c , b/155056091 )
- Added maxLines to CoreTextField ( Ibee58 , b/143687793 )
- Added softwrap to CoreTextField. ( I21a4b )
Исправления ошибок
- Deprecate VectorPainter in favor of rememberVectorPainter to better indicate that the composable API internally leverages 'remember' to persist data across compositions. ( Ifda43 )
- Включить переходы в ComposeTestRule; удалите опцию, чтобы включить мигающий курсор из ComposeTestRule. ( Если0de3 )
- Added single line keyboard option to CoreTextField ( I72e6d )
- Renamed Radius API to CornerRadius to better express how it is used throughout Compose. Updated documentation to indicate that negative corner radii are clamped to zero. ( I130c7 , b/168762961 )
- Add ability to specify inspector info in composed modifier ( Idee08 , b/163494569 )
- Added KeyboardCapitalization IME Option ( I8ac38 )
- Fix Rtl Handle Position. ( I6e1e0 )
- Breaking change: removed the return value from PointerInputFilter.onPointerEvent(...) given that the only value that should be able to be changed in pointer events is consumption data. Instead of returning data from PointerInputFilter.onPointerEvent(...), now you can just mutate the consumption data of the PointerEvents passed in. ( I6acd0 )
- Added SelectAll option into selection menu ( Ief02b )
Версия 1.0.0-альфа05
14 октября 2020 г.
androidx.compose.foundation:foundation:1.0.0-alpha05
, androidx.compose.foundation:foundation-layout:1.0.0-alpha05
, and androidx.compose.foundation:foundation-text:1.0.0-alpha05
are released. Версия 1.0.0-alpha05 содержит эти коммиты.
Изменения API
- CoreTextField now supports cursor functionality ( Id23aa )
Университет ContentColor () и CurrentTextStyle () API () и заменяет их на AmbientContentcolor и AmbientTextStyle Ambients соответственно. Вы можете получить доступ к текущему значению с помощью
.current
Это было изменено для последовательности, и чтобы избежать нескольких способов выполнить одно и то же. Кроме того, переименование некоторых окружающих свойств, чтобы лучше описать их цель следующим образом:- ContentColorambient -> AmbientContentcolor
- TextStileAmbient -> AmbientTextStyle
- IndicationAmbient -> ambientindication
- Акцентирование -> Ambientemphasislevels
- Ripplethemeambient -> ambientRippleTheme ( i37b6d )
Исправления ошибок
- As part of the standardization of sentinel values for inline classes, rename Color.Unset to Color.Unspecified for consistency with other inline classes ( I97611 , b/169797763 )
- Added Copy/Paste/Cut accessibility actions ( I6db4f )
- TextOverflow.None is introduced. When overflow is None, Text won't handle overflow anymore, and it will report its actual size to LayoutNode. ( I175c9 , b/158830170 )
- Updated Size.Unspecified parameters to be Float.NaN instead of Float.POSITIVE_INFINITY. Updated Painter implementations to check against Size.Unspecified as well as non-finite Sizes. ( I95a7e )
- Added Paging Compose module and paging integration ( Ib85da )
- Modify LazyListScope to receive nullable values ( I1765b )
- OnPositionEdModifier переименован в OnGloballyPositionEdModifier, а OnPosited () переименован в OnGloballyPosited (). ( I587e8 , b/169083903 )
- Added samples for LazyColumn/Row ( Idc16d )
- Fix for the items and itemsIndexed methods to allow emptyList ( I06647 )
- Add a DSL for specifying inspector information ( Ic9a22 )
- Move LongPress into Text. ( Iff2bc )
- Disable Selection in Text, and a Demo. ( Ie7e97 )
- Support AnnotatedString to SpannableString conversion for accessibility. ( Ief907 )
- Removed
PointerInputFilter.onPointerInput(...)
.PointerInputFilter.onPointerEvent(...)
should be used in its place. ( I6f04a )
Версия 1.0.0-альфа04
1 октября 2020 г.
androidx.compose.foundation:foundation:1.0.0-alpha04
, androidx.compose.foundation:foundation-layout:1.0.0-alpha04
, and androidx.compose.foundation:foundation-text:1.0.0-alpha04
are released. Версия 1.0.0-alpha04 содержит эти коммиты.
Изменения API
- Стек был переименован в коробку. The previously existing foundation.Box will be deprecated in favor of the new Box in compose.foundation.layout. Поведение новой коробки состоит в том, чтобы складывать детей один на другой, когда у него есть несколько детей - это отличается от предыдущей коробки, которая вела себя похожа на столбце. ( I94893 , B/167680279 )
- Параметры украшения коробки устарели. Если вы хотите иметь украшения/заполнение на своей коробке, вместо этого используйте модификаторы (modifier.background, modifier.border, modifier.padding) ( ibae92 , b/167680279 )
- Add a new LazyListState class. This allows for observation and control of the scroll position of LazyRow and LazyColumn components. Instances can be created using rememberLazyListState() and passed into the state parameter of the component. Currently, the first visible item and offsets can be observed in this initial version. ( Ic7cb7 , b/159307669 )
- Lazy list position and scroll offset are now saved and restored across Activity recreation ( Ie045f , b/166589058 )
- Add long click semantics action ( I6281b , b/156468846 )
- MutatorMutex utility added for keeping a single mutator of shared state over time and cancelling conflicting mutators by priority ( I3f975 )
- Аннотированная rootanimationClockFactory, TransitionSenabled, MallingCursorEnabled и TextInputServiceFactory с @VisibleFortesting, сделайте их внутренним API и скрыть свой KDOC ( I554EB , B/168308412 )
- Removed inlineContent parameter from Text with String input. It won't be used because inlineContent must work with AnnotatedString. ( Ief403 )
- The deprecated custom Arrangement APIs were removed. ( Ic576d , b/168297922 , b/168297923 )
- The
unbounded
parameter was added to wrapContentSize modifiers, which enables measuring the layout element with infinite max constraints. ( I77951 , b/158559319 ) - Мы предотвратили статический импорт содержимого прицела макета (например, совместные сборы в Rowscope). Вместо этого следует использовать альтернативу явного прицела:
with(RowScope) { Modifier.alignWithSiblings(FirstBaseline) }
. ( I216be , b/166760797 )
Исправления ошибок
- Обновлено множество графических API
- Обновленные API -интерфейсы преобразования масштаба и поворота для использования одного параметра смещения, чтобы представлять координату pivot вместо отдельных параметров плавания для координат x/y в DrawScope и Tranttransform
- Удаленный rect.expandtoinclude и rect.join Методы
- Обновленная документация RADIUS, чтобы сказать Oval в дополнение к эллиптической
- Добавлена документация, чтобы указать общественный конструктор для класса встроенного радиуса не должна быть вызвана непосредственно, а вместо этого объекты RADIUS должны быть созданы через конструкторы своих функций
- Удаленные API круглое, чтобы запросить Top Right, Bottomright, Bottomcenter и т. Д.
- Устаревший rect.shift в пользу rect.translate
- Удаленный круглый
- Переименован в круглый
- Удаленный круглый
- Переименованное в раунде.
- Переименован в круглый
- Изменен Roundrect.center, чтобы быть свойством, а не функцией
- Обновленный конструктор круглогов для потребления Radius Properties вместо отдельных параметров для значений RADIUS x/y
- Удаленные API размера, которые предполагали, что это был прямоугольник с происхождением на 0,0
- Добавил разрушение API в радиус
- Вместо этого мигрировали различные функции разгибания круглогов, чтобы быть свойствами
- ( I8f5c7 , b/168762961 )
- Performance optimizations for LazyColumnFor/LazyRowFor scrolling by not doing unnecessary recompositions during every scroll ( I64f65 , b/168293643 , b/167972292 , b/165028371 )
- Fixed crash in LazyColumnFor/LazyRowFor after scrolling and then changing items and implemented auto scrolling up when the previously visible item was removed so we don't display empty gaps in the end anymore ( I220ab , b/161480164 , b/167855468 )
- Nesting scrollable in the same direction containers like ScrollableContainer and LazyColumnFor is not allowed anymore. It was never supported and was breaking the fling and all the laziness of composing the items of LazyColumnFor ( I6e101 )
- Обновлено множество графических API
- Updated DrawScope APIs with scoped transformation methods to indicate that the transformation is only applied within the callback and removed after the callback is invoked
- Updated clipPath documentation to refer to Path instead of rounded rectangle
- Fixed spacing in documentation for right parameter in clipPath
- Renamed DrawScope.drawCanvas to drawIntoCanvas and removed size parameter
- Renamed dx/dy parameters in inset method to horizontal and vertical
- Added inset overload that provides the same inset value to all 4 bounds
- Removed documentation on inset method indicating that inset would be applied to all 4 sides
- Updated documentation for Rect class
- Updated comments on Rect parameters to match kdoc style
- Removed Rect.join and Rect.expandToInclude
- Created overload for Rect.translate(offset) and deprecated Rect.shift
- ( If086a , b/167737376 )
- add AccessibilityScrollState to semantics properties. ( Ifeda9 )
- Make TextRange inline to avoid object creation. ( Id034b )
- ParagraphConstraints is removed. Width is directly passed to Paragraph now. ( Ica712 )
Версия 1.0.0-альфа03
16 сентября 2020 г.
androidx.compose.foundation:foundation:1.0.0-alpha03
, androidx.compose.foundation:foundation-layout:1.0.0-alpha03
, and androidx.compose.foundation:foundation-text:1.0.0-alpha03
are released. Версия 1.0.0-alpha03 содержит эти коммиты.
Изменения API
- InnerPadding was renamed to PaddingValues. ( I195f1 , b/167389171 )
- Использование гравитации было последовательно переименовано в выравнивание или выравнивание в API -интерфейсе. ( I2421A , B/164077038 )
- An alignment parameter was added to Stack, which allows specifying the default alignment for all the Stack children. ( Ie80ca , b/164085265 )
Исправления ошибок
- DpConstraints and APIs using it were deprecated. ( I90cdb , b/167389835 )
- The parameters
minWidth
andmaxWidth
ofwidthIn
were renamed tomin
andmax
. Similarly forpreferredWidthIn
,heightIn
,preferredHeightIn
. ( I0e5e1 , b/167389544 ) - Added onNode and other global methods on ComposeTestRule as the current global ones are going to be deprecated. ( Ieae36 )
- Fixed size and position calculations in GestureScope, which caused amongst others generation of invalid swipe gestures ( Iaf358 , b/166589947 )
- Moved
createAndroidComposeRule
andAndroidInputDispatcher
fromandroidx.ui.test.android
toandroidx.ui.test
( Idef08 , b/164060572 )
Версия 1.0.0-альфа02
2 сентября 2020 года
androidx.compose.foundation:foundation:1.0.0-alpha02
, androidx.compose.foundation:foundation-layout:1.0.0-alpha02
, and androidx.compose.foundation:foundation-text:1.0.0-alpha02
are released. Версия 1.0.0-alpha02 содержит эти коммиты.
Исправления ошибок
- TestUiDispatcher is marked experimental ( Iae99d , b/161247083 )
Добавлено
ManualFrameClock.hasAwaiters
, чтобы увидеть, ожидает ли что -нибудь кадр из этих часов;runWithManualClock
в качестве замены дляrunBlocking
при запуске тестов, которые нуждаются в руководствеTestUiDispatcher.Main
, который дает легкий доступ к основному диспетчеру пользовательского интерфейса в ваших тестах.Например:
@Test fun myTest() = runWithManualClock { clock -> // set some compose content withContext(TestUiDispatcher.Main) { clock.advanceClock(1000L) } if (clock.hasAwaiters) { println("The clock has awaiters") } else { println("The clock has no more awaiters") } }
( I0A85B , B/161247083 )
Версия 1.0.0-альфа01
26 августа 2020 года
androidx.compose.foundation:foundation:1.0.0-alpha01
, androidx.compose.foundation:foundation-layout:1.0.0-alpha01
, and androidx.compose.foundation:foundation-text:1.0.0-alpha01
are released. Версия 1.0.0-alpha01 содержит эти коммиты.
Версия 0.1.0-Dev
Версия 0.1.0-Dev17
19 августа 2020 г.
androidx.compose.foundation:foundation:0.1.0-dev17
, androidx.compose.foundation:foundation-layout:0.1.0-dev17
, and androidx.compose.foundation:foundation-text:0.1.0-dev17
are released. Версия 0.1.0-Dev17 содержит эти коммиты.
Изменения API
- The spacedBy Arrangement was added for Row and Column, to enable positioning layout children with a fixed spacing. The aligned Arrangment was also added, to enable positioning layout children one next to the other and aligned in the Row/Column according to an Alignment. The previous Arrangement.Vertical#arrange and Arrangement.Horizontal#arrange methods were deprecated, and writing custom Arrangements will not be supported in the future. ( I6733d , b/161985975 )
- Offset стало встроенным классом ( IAEC70 )
- Removed onFocusChanged callbacks from TextField. Use Modifier.focusObserver instead. ( I51089 , b/161297615 )
- Modifier.drawBorder has been deprecated. Use Modifier.border instead. Border data class has been replaced by BorderStroke ( I4257d , b/158160576 )
- VerticalScroller and HorizontalScroller have been removed. Use ScrollableColumn/Row instead. Modifier.drawBackground has been removed. Use Modifier.background ( I73b0d , b/163019183 )
- Remove marked as deprecated fillMax* modifiers from LazyItemScope as they are making it harder to add such modifiers correctly for items which are not direct children of LazyColumnFor ( Ifa78d )
- added LazyColumn/LazyRow implementation as DSL ( I93cc6 )
- Constraints is now an inline class ( I88736 )
- Added the ability to size a layout to a fraction of the available space, using the fillMaxWidth, fillMaxHeight and fillMaxSize modifiers. ( I945bb , b/161562591 )
Исправления ошибок
- Added a modifier param to SelectionContainer ( I4aada , b/161487952 )
- Added mergePolicy lambda to SemanticsPropertyKey. This can be used to define a custom policy for mergeAllDescendants semantics merging. The default policy is to use the parent value if already present, otherwise the child value. ( Iaf6c4 , b/161979921 )
-
PlacementScope.placeAbsolute()
был переименован вPlacementScope.place()
, а предыдущийPlacementScope.place()
был переименован вPlacementScope.placeRelative()
. В результате методPlacementScope.place()
больше не будет автоматически отражать положение в контексте правого налегих. Если это требуется, используйте вместо этогоPlacementScope.placeRelative()
. ( I873AC , B/162916675 ) - Removed deprecated FilledTextField component. Please use TextField instead to get the Material Design implementation of the Filled text field. ( I5e889 )
- Added backgroundColor parameter to LinearProgressIndicator and removed internal padding from CircularProgressIndicator. Added new ProgressIndicatorConstants.DefaultProgressAnimationSpec which can be used as the default AnimationSpec when animating progress between values ( If38b5 , b/161809914 , b/161804677 )
-
state { ... }
композитное теперь устарело в пользу явных вызововremember { mutableStateOf(...) }
для ясности. Это уменьшает общую поверхность API и количество понятий для управления состоянием и соответствует шаблонуby mutableStateOf()
для делегирования свойства класса. ( IA5727 ) - Renamed RRect to RoundRect to better fit compose naming patterns Created similar function constructors to RRect and deprecated RRect function constructors ( I5d325 )
- Removed onChildPositioned and OnChildPositionedModifier. Developers should use onPositioned and OnPositionedModifier on the child layout instead. ( I4522e , b/162109766 )
- Intsize теперь встроенный класс ( i2bf42 )
- LongPress the Blank Area to Edit. ( Ib1e5b )
- Hide FloatingToolbar After Tapping on the Text. ( If4525 )
- Hide FloatingToolbar When Updating the Selection. ( I8444c )
- Deselect When Blur. ( I781a2 )
Версия 0.1.0-Dev16
5 августа 2020 года
androidx.compose.foundation:foundation:0.1.0-dev16
, androidx.compose.foundation:foundation-layout:0.1.0-dev16
, and androidx.compose.foundation:foundation-text:0.1.0-dev16
are released. Версия 0.1.0-Dev16 содержит эти коммиты.
Изменения API
- LazyItemScope was added for itemContent param of Lazy lists. It provides modifiers to fill the parent max size which solves the use case when the item should fill the viewport and the regular Modifier.fillMaxSize() doesn't work as the item is measured with infinity constraints. ( Ibd3b2 , b/162248854 )
- Move dialog to ui ( I47fa6 )
- Added LazyColumnForIndexed/LazyRowForIndexed - versions of LazyColumnFor/LazyRowFor which provides both index and item in the itemCallback. It is useful when in addition to a current item you need to know a current index. ( I65ff3 )
- Modifier.deternimateProgress has been renamed to Modifier.progressSemantics ( I9c0b4 )
- LazyColumnItems was renamed to LazyColumnFor. LazyRowItems was renamed to LazyRowFor ( I84f84 )
- Add some Marks/Annotations for best practice reason. ( I66b20 )
- Foundation.shape.corner Package был сглажен до Foundation.share ( I46491 , B/161887429 )
- Added сrossaxis gravity param for LazyRowItems/LazyColumnItems. LazyRowItems/LazyColumnItems now support wrap content behaviour. ( Ib39fc )
- ZoomableState has been renamed to ZoomableController. Custom curve support has been added for smoothScale.
enabled
andonZoomStarted
functionality has been added ( If8b8f ) - Материал заполненного текстового зале был переименован в Textfield, а основополагающее текстовое поле было переименовано в Basetextfield, чтобы сделать самый простой желаемый API легко обнаружить и использовать ( IA6242 , B/155482676 )
- Previously deprecated AdapterList has been removed. Use LazyColumnItems instead ( I12b9b )
- MODIFIER.Drawbackground был переименован в Modifier.Background ( I13677 )
- The old ConstraintLayout DSL was removed. ConstraintSet2 has been renamed to ConstraintSet. ( If58d1 , b/162450908 )
- Added Modifier.absoluteOffset() and Modifier.absoluteOffsetPx(). Unlike offset modifiers, absolute offset modifiers will not auto-mirror in right-to-left context ( I3aa21 )
-
Row
иColumn
теперь являются встроенной функцией, значительно сокращают накладные расходы их использования. ( I75c10 )
Исправления ошибок
- Address broad API fixes ( I077bc )
- Remove unused OffsetBase interface
- Align Offset and IntOffset classes to have a consistent API surface
- Rename IntOffset.Origin to IntOffset.Zero to be consistent with Offset API
- Moved nativeCanvas method off of Canvas interface to support consumers to create their own Canvas instances
- Created stub EmptyCanvas class to refactor DrawScope to be a non-null parameter instead of lateinit and ensure non-nullability of the field
- Renamed ClipOp enums to be Pascal Case
- Renamed FilterQuality enums to be Pascal Case
- Renamed StrokeJoin enums to be Pascal Case
- Renamed PointMode enums to be Pascal Case
- Renamed PaintingStyle enums to be Pascal Case
- Renamed PathFillType enums to be Pascal Case
- Renamed StrokeCap enums to be Pascal Case
- Updated DrawCache implementation to no longer use lateinit params
- Updated DrawScope to no longer use lazy delegation for fillPaint and strokePaint internal parameters
- Updated Image composable to avoid Box usage for less overhead
- Updated Outline class to have @Immutable annotations
- Updated PathNode to have @Immutable annotations for each path instruction
- Updated Vector subcomposition to remove redundant conditional checks for equality as compose already handles them
- Deprecated Rect companion constructor methods in favor of function constructors
- Updated Brush classes and function constructors with @Immutable and @Stable APIs
- Updated VertexMode enum to be PascalCase
- Updated DrawScope selectPaint method to conditionally overwrite stroke parameters on the paint if they have changed
- Updated Size to add destructuring API, rename UnspecifiedSize to Unspecified and removed unused methods
Добавлен MonotonicframeanimationClock, который позволяет использовать монотонный фрамиклок в качестве анимации, чтобы преодолеть разрыв между новыми часами на основе Coroutines и API, которые все еще используют старые часы на основе обратного вызова.
Монотонным фрагментом, эквивалентным HanualanimationClock, теперь является ManualFrameClock. ( I111c7 , b/161247083 )
Removed
SemanticsNodeInteraction.performPartialGesture
. UseSemanticsNodeInteraction.performGesture
instead. ( Id9b62 )Renamed
SemanticsNodeInteraction.getBoundsInRoot()
toSemanticsNodeInteraction.getUnclippedBoundsInRoot()
( Icafdf , b/161336532 )API-интерфейсы для поддержки справа налево были обновлены. Был добавлен MayoutDirectionAmbient, который можно использовать для чтения и изменения направления макета. Modifier.rtl и modifier.ltr были удалены. ( I080B3 )
MODIFIER.PLUS был устарел, используйте модификатор. Тогда вместо этого. «Тогда» имеет более сильный сигнал упорядочения, в то время как также запрещает тип
Modifier.padding().background() + anotherModifier
, который разбивает цепь и труднее читать ( IEDD58 , B/161529964 )Added
isFocused()
andisNotFocused()
SemanticsMatcher. ( I0b760 )RemeasurementModifier was added. It allows users to synchronously remeasure the layout. In general, you never need it as remeasure/relayout is happening automatically, but we use it inside LazyColumnItems during the scroll. ( I5f331 , b/160791058 )
isSystemInDarkTheme now always considers the system-wide dark theme setting, and ignores power saving status before Q, following latest guidance. ( I0c10c )
OnChildPositioned has been deprecated. Use OnPositioned on the child instead. ( I87f95 , b/162109766 )
Renamed AndroidComposeTestRule to createAndroidComposeRule. ( I70aaf )
Add accessibility action to get TextLayoutResult ( I9d6e6 )
Версия 0.1.0-Dev15
22 июля 2020 г.
androidx.compose.foundation:foundation:0.1.0-dev15
, androidx.compose.foundation:foundation-layout:0.1.0-dev15
, and androidx.compose.foundation:foundation-text:0.1.0-dev15
are released. Версия 0.1.0-Dev15 содержит эти коммиты.
To use the 0.1.0-dev15
version of Compose, you will need to:
Обновление зависимостей
- Чтобы использовать версию Compose
0.1.0-dev15
, вам необходимо будет обновить свои зависимости в соответствии с новыми фрагментами кода, показанными выше при объявлении зависимостей .
Изменения API
- Similarly to the new param in ScrollableColumn/ScrollableRow LazyColumnItems/LazyRowItems now also have contentPadding param which allows to add a padding for the content after it has been clipped, which is not possible via just a modifier param. It also allows to add a spacing only before first item/after last item. ( Ibc24e )
- onFocusChange callback in text fields renamed to onFocusChanged ( Ida4a1 )
- VerticalScroller and HoriziontalScroller have been deprecated. Use ScrollableColumn and ScrollableRow for build-in experience with Column/Row behaviour and parameters, or Modifier.verticalScroll and Modifier.horizontalScroll on your own element. Similarly, ScrollerPosition has been deprecated in favor of ScrollState' ( I400ce , b/157225838 , b/149460415 , b/154105299 )
- Modifier.draggable and Modifier.scrollable APIs were reworked. DragDirection was removed in favor of Orientation. State required for scrollable has beed simplified. ScrollableState has been renamed to ScrollableController ( Iab63c , b/149460415 )
- Single-value semantics properties now use a calling style. For example, 'semantics { hidden = true }' is now written as:
semantics { hidden() }
. ( Ic1afd , b/145951226 , b/145955412 ) - Corner sizes used by RoundedCornerShape and CutCornerShape can now be larger than 50% ( Id2340 , b/160400213 )
- Changed the default ContentScale parameter for the Image composable from Inside to Fit. This was done in order to get behavior to scale up the underlying Painter if the layout size is larger than the intrinsic size of the painter while maintaining the aspect ratio. This behavior better matches expectations for providing fixed sizes to the Image while not affecting the default behavior if only the intrinsic size is used to compute the size of the composable. ( I40ae3 , b/159838006 )
- Use AnimationSpec instead of AnimationBuilder in the top level APIs to clarify the concept of static animation specification -Improve the transition DSL by removing the lambda requirement for creating AnimationSpecs such as tween, spring. Вместо этого они принимают конструкторы напрямую. -Improve the overall ease of use of AnimationSpec opening up constructors instead of relying on builders -Change the duration and delay for KeyFrames and Tween to Int. Это устраняет ненужные черты типа и перегрузку методов (для поддержки как Long, так и int). ( ICA0B4 )
- Clickable was removed. Use Modifier.clickable ( I84bdf )
- Added LazyRowItems - Horizontally scrolling analogue of LazyColumnItems ( Ibbcf7 )
- Введены API анимации без хранения. Эти API ( i63bf7 )
- Androidx.ui.foundation.TextFieldValue и Androidx.ui.input.editorValue устарел. Composables Textfield, Fulltextfield и Coretextfield, которые используют этот тип, также устареют. Пожалуйста, используйте androidx.ui.input.textfieldvalue вместо этого ( i4066d , b/155211005 )
- Заменило использование INTPX с Int. Заменил INTPXPOSION с IntoffSet. Заменил intpxsize на Intsize. ( IB7B44 )
- androidx.ui.foundation.shape.RectangleShape removed; use androidx.ui.graphics.RectangleShape ( I94939 , b/154507984 )
- Чтобы консолидировать количество классов, используемых для представления информации о размерах, стандартизируйте использование класса размера вместо PxSize. Это обеспечивает преимущества встроенного класса для использования длинных значений плавания 2, чтобы представлять ширину и высоту, представленные как поплавки. ( IC0191 )
- Чтобы консолидировать количество классов, используемых для представления информации о позиционировании, стандартизировать использование класса смещения вместо pxposition. Это обеспечивает преимущества встроенного класса для использования длинных значений плавания 2, чтобы представлять смещения x и y, представленные как поплавки. ( I3ad98 )
- Added Modifier.zoomable for pinch-to-zoom functionality ( Id5d63 )
- Toggleable component has been deprecated. Use Modifier.toggleable instead ( I35220 , b/157642842 )
- MutuallyExclusiveSetItem has been deprecated. Use Modifier.selectable instead. ( I02b47 , b/157642842 )
- TestTag is now deprecated. Use Modifier.testTag instead. ( If5110 , b/157173105 )
- Adds fontWeight parameter to Text, which was accidentally not added previously ( I56937 )
- Заменил использование класса PX в различных классах композиции как часть больших усилий по рефакторингу, чтобы полагаться только на DP и примитивные типы для параметров пикселей ( I19D02 )
- VerticalScroller now provides Column out of the box. HorizontalScroller now provides Row out of the box. ( Ieca5d , b/157020670 )
- Replaced usage of Px class in various compose classes as part of the large refactoring effort to only rely on Dp and primitive types for pixel parameters ( Iede0b )
- Modifier.indication has been added to foundation package. Use it to show press/drag/other indication on your custom interactable elements ( I8425f , b/155287131 )
- VerticalScroller and HorizontalScroller now support reversed scrolling is isReversed is set on ScrollerPosition ( I953bd )
- Support adding composables into text layout. ( I1373c )
- Консолидированные реализации Canvasscope, поэтому теперь есть просто DraitScope и ContentDrawScope переименован в CanvassCope для DraitScope. Обновленные DrawScope для реализации интерфейса плотности и обеспечения удаленного подкласса DraitScope в художнике ContentDrawScope и PAINTERTERFIER были обновлены, чтобы больше не поддерживать свойство RTL, поскольку DrawScope уже предоставляет это без вручную ( I1798E )
- Удаленный устаревший API Dallackground API в пользу API удлинения Delepbackground Extension на модификаторе. Рефакторированный цвет, кисти и недостатки краски, чтобы уменьшить пути кода, а также для удаления требований для создания модификатора как часть композиции. ( I0343A )
- Обновленные API -интерфейсы более высокого уровня, которые выставляют холст, чтобы разоблачить Canvasscope. Это устраняет необходимость того, чтобы потребители поддерживали свои собственные объекты краски. Для потребителей, которые по -прежнему требуют доступа к холстам, они могут использовать метод расширения DrawCanvas, который обеспечивает обратный вызов для выпуска команд рисования с базовым холстом. ( I80afd )
- HorizontalScroller and VerticalScroller not restores their scroll position using saved instance state. ( Ia0fae , b/155075048 )
- FocusManagerAmbient is removed. Use FocusModifier.requestFocus to obtain focus. ( Ic4826 )
- Table layout was removed temporarily until we will make it available again with a refreshed API. ( Id88a7 )
Created CanvasScope API that wraps a Canvas object to expose a stateless, declarative drawing API surface. Transformations are contained within their own receiver scope and sizing information is also scoped to corresponding inset bounds. It does not require a consumer to maintain its own Paint state object for configuring drawing operations.
Added CanvasScopeSample as well as updated the demo app to include a declarative graphics demo ( Ifd86d )
ColoredRect has been removed. User Box with drawBackground modifier instead ( I983c7 , b/152753731 )
Add cursor color customisation to the TextField ( I6e33f )
Now it is possible to hide/show software keyboard by using SoftwareKeyboardController which is delivered by onTextInputStarted callback ( I8dc44 , b/151860051 )
TextFieldValue used with TextField can now be survive activity recreation when used like this:
var text by savedInstanceState(saver = TextFieldValue.Saver) { TextFieldValue() }
( I5c3ce , b/155075724 )Adds commonly used parameters to Text(). If you are currently creating a local text style to pass a small number of these parameters, such as
Text(style = TextStyle(textAlign = TextAlign.Center))
, you can now just provide the parameters directly:Text(textAlign = TextAlign.Center)
( I82768 )Replaced CoreTextField/TextField focusIdentifier parameter with FocusNode in order to integrate with focus subsystem. ( I7ea48 )
TextField update - in horizontal dimension it will occupy all available space granted to it ( Ib08df , b/154638552 )
Added InteractionState and Interaction, making it easier to build components that react to UI state changes such as press, and drag ( Icfe25 , b/152525426 )
RectangleShape moved from androidx.ui.foundation.shape.* to androidx.ui.graphics.* ( Ia74d5 , b/154507984 )
Заменил все нулевые использование цвета в API с не нулевым и используйте Color.unset вместо нулевого ( iabaa7 )
TextField API update - merged onFocus and onBlur callbacks into a single onFocusChange(Boolean) callback with parameter ( I66cd3 )
Renamed ScaleFit to ContentScale Moved ContentScale from ui-graphics to ui-core module to live in the same module as the Alignment API. Renamed FillMaxDimension to Crop Renamed FillMinDimension to Fit Renamed Fit to Inside to better match ImageView.ScaleType equivalents Added documentation indicating that the combination of Crop and Alignment.Center achieves the same result as ImageView.ScaleType.CENTER_CROP and Fit used with Alignment.Center achieves the same result as ImageView.ScaleType.FIT_CENTER Inside used with Alignment.Center achieves the same result as ImageView.ScaleType.CENTER_INSIDE ( I45f09 , b/152842521 )
Removes ProvideContentColor, instead just use ContentColorAmbient directly with
Providers
( Iee942 )Adds color parameter to text, allowing overriding the color of the text style without needing to manually merge with the style provided in a theme. ( I41a66 )
Улучшить API DrawModifier:
- Сделал применение приемника для Drait () ContentDrawScope
- Удалили все параметры на Draw ()
- DraitScope имеет тот же интерфейс, что и бывший Canvasscope
- ContentDrawscope имеет метод DraitContent () ( ibaced , b/152919067 )
ColoredRect был устарел. Используйте
Box(Modifier.preferredSize(width, height).drawBackground(color))
вместо этого. ( I499fa , b/152753731 )Shape theming system is updated according to the Material design specification. Now you can provide small, medium and large shapes to be used by most of the components ( Ifb4d1 )
Заменил модификатор плюс оператор с функциями расширения завода ( I225E4 )
Draggable has been moved to modifier ( Id9b16 , b/151959544 )
Moved
Text
to androidx.ui.foundation package, from androidx.ui.core. ( I87ce5 )add
enabled
param to Checkbox, Switch and Toggleable ( I41c16 )Ripple is now a Modifier. While Clickable is not yet converted the recommended usage is
Clickable(onClick = { ... }, modifier = ripple())
( Ie5200 , b/151331852 , b/150060763 )Added VectorPainter API to replace existing subcomposition API for vector graphics. Result of subcomposition is a VectorPainter object instead of a DrawModifier. Deprecated previous DrawVector composables in favor of VectorPainter.
Renamed
Image(Painter)
API toPaintBox(Painter)
Created Vector composable that behaves like the Image composable except with a VectorAsset instead of an ImageAsset ( I9af9a , b/149030271 )Created Image composable to handle sizing/layout in addition to drawing a given ImageAsset to the screen. This composable also supports drawing any arbitrary Painter instance respecting its intrinsic size as well as supporting a given fixed size or minimum size ( Ibcc8f )
Button, FloatingActionButton and Clickable now have a separate
enabled
param. Some of the params on Button were renamed or reordered. ( I54b5a )Renamed Image to ImageAsset to better differentiate the difference between the Image data and the upcoming Image composable used to participate in layout and draw content.
Created extension method on android.graphics.Bitmap,
Bitmap.asImageAsset()
, to create an instance of an ImageAsset useful for combining traditional Android application development with the compose framework. ( Id5bbd )DrawImage composable was removed. Use ImagePainter to draw image on existing layout, or SimpleImage to introduce Image that takes space ( I595e1 , b/149827027 )
Stack component supports right-to-left directionality ( Ic9e00 )
Added Icon, IconButton and IconToggleButton, removing AppBarIcon. You can directly replace existing usages of AppBarIcon with IconButton, and they will now have the correct touch target. See the samples for usage information, and see Icons for the provided Material Icons you can use directly with these components. ( I96849 )
DrawShape composable was removed. Use DrawBackground modifier instead. ( I7ceb2 )
Added AdapterList, a scrolling list component that only composes and lays out the visible items. Currently known issues include that it is vertical-only and does not fully handle all cases of changes to its children. ( Ib351b )
Scrollable component has been added, which allows creation of custom Scrollers/Lists ( I5fd37 )
Переименованный фон для Dellackground и запомнить его по умолчанию ( IA0BD3 )
Add paddings, border, shape and background param to Box ( I05027 , b/148147281 )
Added Canvas component. This composable takes up some size (provided by user) and allows you to draw using CanvasScope ( I0d622 )
rename
Border
modifier toDrawBorder
( I8ffcc )Added Box component for combining layout and drawing common functionality. ( I6e2a7 )
Scrollers now exhibit native Android fling motion behavior. ( I922af , b/147493715 )
Replaced DrawBorder in favor of Border Modifier ( Id335a )
Modifier.tag was renamed to Modifier.layoutId, to avoid confusion with Modifier.testTag. ( I995f0 )
The percent parameter when creating ConstraintLayout guidelines has been renamed to fraction. ( Ida2db )
Added support for margins of ConstraintLayout barriers. ( I47ffe )
Fixed RTL support in ConstraintLayout. Added RTL unaware APIs. ( I3b1c7 )
A new DSL for ConstraintLayout has been added. Please see the samples for more details. ( Icaa9a )
Added the @ExperimentalLayout annotation. ConstraintLayout, FlowRow and FlowColumn are now tagged with it to mark that their APIs are going to change. ( I412a8 )
Modifier.padding(InnerPadding)
has been added ( I94985 , b/157133803 )Removed deprecated RowAlign, ColumnAlign in Row and Column. ( If60d4 , b/155858731 )
Removed deprecated LayoutTag(), please use Modifier.tag() instead. Removed deprecated Modifier.matchParent(), please use Modifier.matchParentSize() instead. ( If8044 )
Added the offsetPx layout modifier, which can be used to define (dynamic) offsets in px. ( I5af57 )
AlignmentLineOffset composable is deprecated, please use relativePaddingFrom() modifier instead. CenterAlignmentLine composable is removed. ( I60107 )
Added defaultMinSizeConstraints layout modifier, which sets size constraints to the wrapped layout only when the incoming corresponding constraints are unspecified (0 for min constraints and infinity for max constraints). ( I311ea , b/150460257 )
Container has been removed. Use Box instead ( Ibbc2b , b/151407926 )
Removed deprecated LayoutWidth/Height/Size modifiers. ( Ib0bc1 )
Added default parameter values for the offset modifier. ( I37f06 )
Добавлен симметричный модификатор заполнения. ( I39840 )
Removed deprecated LayoutAspectRatio modifier. ( I65a74 )
Removed deprecated LayoutAlign modifiers. ( I10877 )
Fixed a bug in the width and height modifiers that was causing the wrapped layout to be measured with no opposite axis constraints. ( I210b8 , b/154797971 )
Добавлены параметры вертикальной гравитации и горизонталигвитации к строке и столбцу соответственно. ( I7dc5a )
Обновленная rawContentWidth и wroudContentHEight, чтобы ожидать вертикального или горизонтального выравнивания, а не какого -либо выравнивания. Модификатор гравитации был обновлен, чтобы принять вертикальное или горизонтальное выравнивание. ROW, столбец и стек были обновлены, чтобы поддержать пользовательские непрерывные выравнивания. ( IB0728 )
Made Alignment instantiable with arbitrary values. Added 1D Alignments. ( Ia0c05 )
Renamed EdgeInsets to InnerPadding. Renamed innerPadding parameter of Material Buttons to paddding. ( I66165 )
alignToSiblings now accepts a Measured instead of Placeable. ( I5788d )
Added modifiers for sizing to intrinsic measurements and deprecated the components serving this purpose. ( I8295d )
Added support for customizing dimensions of children of ConstraintLayout ( Idb1a5 )
Removed deprecated Wrap and Center composables. ( I29e23 )
Added LayoutModifier2, a new API for defining layout modifiers; deprecated LayoutModifier ( If32ac )
Члены Rowscope и ColumnScope теперь доступны вне строки и столбца. ( I3a641 )
Container has been deprecated. Use Box instead. ( I675ce , b/151407926 )
Added the LayoutOffset modifier for offsetting layout position ( I0b8a3 )
Initial support for Rtl in Compose layout ( Ia5519 )
Updated LayoutAlign to not fill the available space anymore ( I2b14f )
Removed AspectRatio composable in favor of modifier. Deleted obsolete FlexColumn, FlexRow composables and Spacing modifier ( Iec8a7 )
Removed the LayoutInflexible modifier for Row and Column ( I0d820 )
Implement Drag Selection Handles to change selection for TextField. ( I27032 )
Implements LongPressAndDrag for TextField Selection. ( I17919 )
Исправления ошибок
- FocusModifier is deprecated in favor of Modifier.focus, Modifier.focusRequester, Modifier.focusObserver. FocusState and FocusDetailedState are deprecated in favor of FocusState2 ( I46919 , b/160822875 , b/160922136 )
-
runOnIdleCompose
переименован вrunOnIdle
( I83607 ) - Несколько тестирующих API были переименованы в более интуитивно понятные. Все API Findxyz были переименованы в Onnodexyz. Все API -интерфейсы Doxyz были переименованы в выполнение Xyz. ( I7f164 )
- Removes previously deprecated Modifier.ripple. Clickable now uses ripple as the default indication (if you have a MaterialTheme {} set in your application) so in most cases you can just use clickable and get ripple indication for free. If you need to customize the color / size / bounded parameter for the ripple, you can manually create a RippleIndication and pass it to clickable as the indication parameter. ( I663b2 , b/155375067 )
- Removed obsolete size testing APIs. ( Iba0a0 )
- Сделано экспериментальный API ( i4f2e9 )
- Version 1 of scroll orientation locking is implemented across Compose. ( I1ce7a , b/150289741 )
- Popups, Dialogs and Menus are now inheriting the contextual MaterialTheme ( Ia3665 , b/156527485 )
- Removed layout direction parameter from the measure block of the Layout() function. Layout direction is however available inside the callback through the measure scope object ( Ic7d9d )
- Add AbsoluteArrangement - allows for arrangement of the children inside the Row without automatic mirroring in RTL ( I3a1df )
- @Untracked аннотация устарела. Заменить @composablecontract (tracked = false) ( id211e )
- До этого изменения плагин компилятора Compose не тривиально перехватывал бы вызовы конструкторов внутри функции @composable, если бы было ( i5205a , b/158123804 )
- Add
viewModel()
composable which allows to create or get already created ViewModel similarly to how it works in Activity or Fragment ( I5fdd1 ) Refactored Radius class to be an inline class. Removed companion creation methods in favor of function constructor with default parameter to have the radius along the y-axis match that of the mandatory x-axis radius parameter.
Updated DrawScope.drawRoundRect to consume a single Radius parameter instead of 2 separate float values for the radius along the x and y axis ( I46d1b )
Заменило использование класса PX в различных классах Compose в рамках больших усилий по рефакторингу, чтобы полагаться только на DP и примитивные типы для параметров пикселей. Удал класс PX полностью ( i3ff33 )
Заменил использование класса PX в различных классах компоновки в рамках больших усилий по рефакторингу, чтобы полагаться только на DP и примитивные типы для параметров пикселей ( I086F4 )
Заменил использование класса PX в различных классах компоновки в рамках больших усилий по рефакторингу, чтобы полагаться только на DP и примитивные типы для параметров пикселей ( ID3434 )
Replaced usage of Px class in various compose classes as part of the large refactoring effort to only rely on Dp and primitive types for pixel parameters ( I97a5a )
TextField's cursor has a blinking animation ( Id10a7 )
Partial gestures no longer require passing around of a GestureToken ( Id7ae5 )
Replaced usage of Px class in various compose classes as part of the large refactoring effort to only rely on Dp and primitive types for pixel parameters ( I57bff )
Modifier.semantics has been undeprecated to allow usages for high level components. ( I4cfdc )
Rename AnnotatedString.Builder.addAnnotationString to addStringAnnotation. ( I5059e )
Updated Alignment API and added support for absolute alignment (which does not auto-mirror in Rtl context) ( I38cd3 )
Layout and LayoutModifier children can be measured with a different layout direction. ( Ibd731 )
Introduce additional optional rect parameter to ImagePainter to support drawing a subsection of underlying ImageAsset ( I0ea9e )
Fixed a crash in AdapterList when removing items ( Ic64b0 , b/153195921 )
We changed how we measure the first layout you put inside activity.setContent { } block. Previously it was forced to fill the whole activity screen, and now it behaves as if you put your layout inside a Stack: it can be smaller than a screen and will be positioned in the top left screen. If you want the old behaviour you can apply Modifier.fillMaxSize() for your layout. ( Ie88a7 , b/153453714 )
ui-text-compose module is renamed as ui-text. ui-text now contains CoreText and CoreTextField composables ( Ib7d47 )
модуль UI-Text переименован в UI-Text-Core ( i57dec )
Moved ui-framework/CoreText, CoreTextField composables under ui-text-compose. You might want to include ui-text-compose in your project. ( I32042 )
runOnIdleCompose
иrunOnUiThread
теперь являются глобальными функциями вместо методов Composetestrule. ( ICBE8F )[Mintable] Операторы делегатов государственной собственности перешли на расширения для поддержки оптимизации Delegate Kotlin 1.4. Абоненты должны добавить импорт, чтобы продолжить использование
by state { ... }
илиby mutableStateOf(...)
. ( I5312c )DrawLayerModifier and drawLayer() now default clipToBounds and clipToOutline to false. ( I0eb8b , b/152810850 )
Renamed LayoutResult to MeasureResult. ( Id8c68 )
Устаревший центр композиции. Его следует заменить либо на MayoToutSize.fill + MayoutAlign.center Modifier, либо одним из композиционных продуктов коробки или стека с подходящими модификаторами ( IDF5E0 )
Переименовано в LayoutFlegeble до макетного веса. Переименованного плотного параметра для заполнения. ( IF4738 )
DrawVector has been changed from a regular composable function to returning a Modifier drawVector() that will draw the vector as a background to a layout. ( I7b8e0 )
Replace composable function Clip with modifier drawClip(). DrawClipToBounds is a convenient modifier to use when you only need to clip to the layer bounds with a rectangle shape. ( If28eb )
Replaced DrawShadow composable function with drawShadow() modifier. Shadows are now drawn as part of LayerModifier. ( I0317a )
Androidx.compose.viewComposer был перенесен на androidx.ui.node.uicomposer androidx.compose.emittable. Это было избыточно с компонентом. Androidx.compose.viewAdapters был удален. Они больше не являются поддерживаемым вариантом использования. Compose.composeinto устарел. Вместо этого используйте
setContent
илиsetViewContent
. Compose.disposecomposition устарели. Вместо этого используйте методdispose
наComposition
, возвращаемойsetContent
. Androidx.compose.compose.subcompoceinto переехал на androidx.ui.core.subcompoceinto componentnode#emitinsertat был переименован в компонент#insertat componentnode#emitremoveat был переименован в компонент#removeatnode#emitmode был переименован в компонент#################################( isdef00 )Deprecated Wrap composable. It can be replaced either with the LayoutAlign modifier or with the Stack composable ( Ib237f )
Made the layout direction be propagated from parent layout node to children. Added layout direction modifier. ( I3d955 )
Rename Painter.toModifier to Painter.asModifier as the newly created Modifier has a reference to the original Painter that can be shared across multiple Modifier instances ( I7195b )
Поддержать направление правого налега
Плотность и плотностьскопа были объединены в один график. Вместо AmbientDensity () вы теперь можете использовать DensityMabient.current. Вместо сдержания (плотность) только с (плотностью) ( i11cb1 )
Удаленный класс владельцев стоимости. Реструктурированные анимационные классы, анимированные классы, чтобы сделать полевой поля анимации абстрактным, чтобы подклассы могли смотреть обновление значения.
- Добавлены классы моделей для анимации, анимированного флоата и т. Д.
- Добавлен новый набор легких API @composable @composable для анимации между значениями.
- ( I79530 )
Разрушение изменений в API Ampi Ampients. См. Журнал и
Ambient<T>
Документация для деталей ( i4c7ee , b/143769776 )Alignment line Int positions returned from Placeable#get(AlignmentLine) are now non-null. If the queried alignment line is missing, AlignmentLine.Unspecified will be returned. ( I896c5 , b/158134875 )
Fixed a ConstraintLayout bug causing a crash on recompositions. ( Ibee5a , b/158164341 )
С конструкциями, сдерживающими API Lambda, был изменен. Теперь вместо двух параметров у него есть прицел приемника, который в дополнение к ограничениям и LayoutDirection обеспечивает свойства Minwidth, Maxwidth, Minheight и Maxheight в DP ( i91b9a , b/149979702 )
Renamed LayoutModifier2 to LayoutModifier. ( Id29f3 )
Intrinsic measurements functions in Layout and LayoutModifier2 have an IntrinsicMeasureScope receiver now which provides intrinsics query API with implicitly propagated layout direction. ( Id9945 )
LayoutDirectionAmbient is deprecated. To read the layout direction defined by the locale, use localeLayoutDirection on ConfigurationAmbient ( I851b1 )
Added positionInParent and boundsInParent for LayoutCoordinates. ( Icacdd , b/152735784 )
ParentData composable is deprecated. You should either create a modifier which implements ParentDataModifier interface, or use LayoutTag modifier if you simply need to tag layout children to recognize them inside the measure block. ( I51368 , b/150953183 )
Add OnPositionedModifier and OnChildPositionedModifier to replace OnPositioned and OnChildPositioned composable functions. ( I2ec8f )
Disallow negative padding in LayoutPadding. LayoutOffset should be used instead for negative position offsets. ( Ifb5b1 )
С Constraints Получил параметр LayoutDirection ( i6d6f7 )
Обновил флаг
ComposeFlags.COMPOSER_PARAM
, чтобы бытьtrue
, что изменит стратегию генерации кода для плагина Compose. На высоком уровне это приводит к созданию функций @composable с помощью дополнительного синтетического параметра, который передается через последующие вызовы @composable для правильного управления выполнением. Это значительное бинарное нарушение, однако, должно сохранить совместимость на уровне источника во всех санкционированных использовании Compose. ( I7971c )Changed LayoutCoordinates to make providedAlignmentLines a Set instead of a Map and have LayoutCoordinates implement the get() operator instead for retrieving a value. This makes it easier for modifiers to modify one or more value of the set without creating a new collection for each modifier. ( I0245a )
LayoutCoordinates no longer has a position property. The position property does not make sense when considering LayoutModifiers, rotation, or scaling. Instead, developers should use parentCoordinates and childToLocal() to calculate the transform from one LayoutCoordinate to another.
LayoutCoordinates uses IntPxSize for the size property instead of PxSize. Layouts use integer pixel sizes for layouts, so all layout sizes should use integers and not floating point values. ( I9367b )
Improvements to the API surface of Constraints ( I0fd15 )
Added TextDirection.Content ( I48f36 )
Ajdust the Toolbar Menu to show copy, cut, paste properly. ( Id3955 )
Add FloatingToolbar for TextField Selection. ( Ie8b07 )
TextDirectionAlgorithm is renamed as TextDirection ( I75ce8 )
TextDirection is renamed as ResolvedTextDirection ( I3ff38 )
Add HapticFeedback to TextField Selection. ( I58050 )
Add Copy, Cut, and Paste methods to TextField Selection. ( Idb70b )
TestTag and Semantics have been deleted. Use Modifier.testTag and Modifier.semantics instead ( I15ff0 , b/158841414 )
Changed the package name for Locale and LocaleList from androidx.ui.text to androidx.ui.intl ( I8132c )
API change:
AnnotatedString(builder: Builder)
is renamed toannotatedString(builder: Builder)
. ( Ia6377 )API change:
AnnotatedString.Item
is renamed toAnnotatedString.Range
. ( I2d44d )Add Toolbar for text related operations. ( I49d53 )
New LifecycleOwnerAmbient is now available. Now an Activity you are using with Compose UI should extend androidx.activity.ComponentActivity (or AppCompatActivity). setContent on android.app.Activity is now deprecated ( Idb25a , b/153141084 )
ui-android-text package name (androidx.text) replaced with androidx.ui.text.platform in order to align with androidx policy. ( I42711 )