wear protolayout
Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |
---|---|---|---|---|
October 2, 2024 | 1.2.0 | - | - | 1.3.0-alpha01 |
Declaring dependencies
To add a dependency on wear-protolayout, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.
Add the dependencies for the artifacts you need in the build.gradle
file for
your app or module:
Groovy
dependencies { // Use to implement support for Wear ProtoLayout Expressions implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha01" // Use to implement support for Wear ProtoLayout implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha01" // Use to utilize components and layouts with Material design in your ProtoLayout implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha01" }
Kotlin
dependencies { // Use to implement support for Wear ProtoLayout Expressions implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha01") // Use to implement support for Wear ProtoLayout implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha01") // Use to utilize components and layouts with Material design in your ProtoLayout implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha01") }
For more information about dependencies, see Add build dependencies.
Feedback
Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.
See the Issue Tracker documentation for more information.
Version 1.3
Version 1.3.0-alpha01
October 2, 2024
androidx.wear.protolayout:protolayout-*:1.3.0-alpha01
is released. Version 1.3.0-alpha01 contains these commits.
Bug Fixes
- Clarified that Roboto and Roboto Flex font family names availability is device dependent. (I193be)
- Enabled Roboto Flex font family in AndroidX Tile renderer. (I08e94)
Version 1.2
Version 1.2.0
August 7, 2024
androidx.wear.protolayout:protolayout-*:1.2.0
is released. Version 1.2.0 contains. these commits.
Important changes since 1.1.0
FontStyle
has been updated to have additional font support for the variable axes and better font selection API to support upcoming Flex fonts.- Additional Modifiers support:
- Transformation modifier offering translation, rotation and scaling with or without animations.
- Specifying different values (horizontal and vertical) for each corner radius.
- Improved accessibility of all touch targets by extending the tappable area of any element that uses Clickable modifier to be at least
48dp
by48dp
. - Improved
PrimaryLayout
andEdgeContentLayout
by addingsetResponsiveContentInsetEnabled
to better support responsive behavior of these layouts across different screen sizes and improve Tiles consistency. - Improved scaling/non-scaling of the Material Text for Android 14's non-linear font scaling.
- Improved support for RTL layout direction on all arc elements.
Additional changes
- For a more complete set of the changes introduced in version 1.1.0, see the beta01 release notes.
Version 1.2.0-rc01
July 24, 2024
androidx.wear.protolayout:protolayout-*:1.2.0-rc01
is released. Version 1.2.0-rc01 contains these commits.
Bug Fixes
- We have fixed the standard Material Chip so it can be used as an icon only if none of the primary or secondary label is passed in. (Iceef9)
- Documentation for Material layouts has been updated to include visuals from the relevant page for easier understanding of layouts. (I0256a)
Version 1.2.0-beta01
July 10, 2024
androidx.wear.protolayout:protolayout-*:1.2.0-beta01
is released. Version 1.2.0-beta01 contains these commits.
New Features
The 1.2.0-beta01 release of Wear ProtoLayout indicates that this release of the library is feature complete and the API is locked (except where marked as experimental). Wear ProtoLayout 1.2 includes the following new functionalities and APIs:
FontStyle
has been updated to have additional font support as following:- Setting different font variation setting such as
FontSetting.weight
andFontSetting.width
- Setting the same width for all numeric characters - tabular numerals (
FontSetting.tnum
font feature setting) - Improved font selection APIs to support the upcoming flex fonts by specifying preferred font family names to be used.
- Setting different font variation setting such as
- Extended
Corner
modifier to support specifying eachCornerRadius
with a separate horizontal and vertical values to allow building elements with asymmetric corners. - Added a new
Transformation
modifier offering translation, rotation and scaling ofLayoutElement
. These transformations can be animated by using dynamic values. - Added
setArcDirection
withClockwise
,CounterClockwise
andNormal
options to all arc elements (Arc
,ArcLine
andArcText
) for better support in different layout directions (such as LTR and RTL). - Improved accessibility of all touch targets by extending the tappable area of any element that uses
Clickable
modifier to be at least48dp
by48dp
. - Improved
PrimaryLayout
andEdgeContentLayout
by addingsetResponsiveContentInsetEnabled
to better support responsive behavior of these layouts across different screen sizes and improve Tiles consistency. Added linter warning to suggest usage of these APIs with a quick fix. - Improved scaling/non-scaling of the Material
Text
for Android 14's non-linear font scaling.
API Changes
- Default font family name (
DEFAULT_SYSTEM_FONT
) is removed as it is implied by not using thepreferredFontFamilies
API. (I39dab) - Parameter passed in to the
FontSetting.width
should be positive. (I1266f)
Version 1.2.0-alpha05
June 26, 2024
androidx.wear.protolayout:protolayout-*:1.2.0-alpha05
is released. Version 1.2.0-alpha05 contains these commits.
New Features
- Add
hasText
method toMaterial.CompactChip
to check whether the text content has been set. (I6e8fc)
API Changes
FontFamily
const are moved to be inFontStyle
instead of its Builder class. (I06ced)- Update
FontSetting.weight
andFontSetting.width
API to include Range annotations and change weight's parameter to be int. (Ia726c)
Bug Fixes
- Non-scalable texts in Material library now work correctly with Android 14's non-linear font scaling. (I6601e)
Version 1.2.0-alpha04
May 29, 2024
androidx.wear.protolayout:protolayout-*:1.2.0-alpha04
is released. Version 1.2.0-alpha04 contains these commits.
API Changes
- Added asymmetrical corners API to be able to specify separately each corner’s radius with 2 values. (Icbd69)
- Extended the
FontSetting
API to include: - Added font family API to
FontStyle
to allow specifying an order list of which font families should be used. (Iba9f5) - Renamed constants for space height between content and secondary label in Material’s
LayoutDefaults
that were initially prefixed with “Edge content” to be more generic as they can be applied to bothPrimaryLayout
andEdgeContentLayout
. (I4dc32)
Bug Fixes
- Renamed naming for variable font axes from
axisName
toaxisTag
. (I02ba3)
Version 1.2.0-alpha03
May 14, 2024
androidx.wear.protolayout:protolayout-*:1.2.0-alpha03
is released. Version 1.2.0-alpha03 contains these commits.
New Features
- Added API for setting custom weight values for
FontStyle
. (I7390a)
Bug Fixes
- Fix the failure in
getTouchDelegateInfo
due to empty target map. (I2accf)
Version 1.2.0-alpha02
May 1, 2024
androidx.wear.protolayout:protolayout-*:1.2.0-alpha02
is released. Version 1.2.0-alpha02 contains these commits.
API Changes
- We've added support for disabling ripple feedback on individual clickable elements. (If1ede)
- The API for transformation has been removed from
ArcModifiers
as they don't support that feature (Ic0827) ArcDirectionProp
Builder now expects a value in the constructor. (I76ada)- The
PlatformDataValues.Builder.putAll
method will allow merging onePlatformDataValue
into another one. (I50ba3) Text#setIsScalable
is renamed toText#setScalable
. (If920e)- Material Text can set whether to use scalable size (grows when user font size is changed) or not. (Ibc849)
- We've added the option to set content description to
TitleChip
. (I5d21f) - Fixed
CompactChip
to work correctly with icon only and update the API to allow this option. (I6589e)
Bug Fixes
- Fixed an issue of potential duplicate platform data during initialization. (Iba0fd)
- Introduce a new getter to
DynamicDataNode
to retrieve node cost. The cost is used when acquiring dynamic node quota. Currently, Nodes with fixed values will have a cost of 0, all the other nodes will have a cost of 1. (Ia33e1) - Remove counting logic from the
NO_OP_QUOTA_MANAGER
. (Ib50b8) - We have added a lint rule to report a warning when
PrimaryLayout
is used withoutsetResponsiveContentInsetEnabled
and provide a quick fix. (I12025) - There is a limit to a number of dynamic expression nodes. (Iffae8)
Version 1.2.0-alpha01
March 6, 2024
androidx.wear.protolayout:protolayout-*:1.2.0-alpha01
is released. Version 1.2.0-alpha01 contains these commits.
New Features
ProtoLayout Arc
elements now have the option to addArcDirection
(Clockwise
,Counterclockwise
orNormal
) to it. Adding this behavior toArc
,ArcLine
orArcText
will fix their behavior on RTL layouts. (I90699)EdgeContentLayout
has been updated with a newsetResponsiveContentInsetEnabled
setter to achieve better alignment with the UX guidelines, consistency in Tiles by having primary label at the fixed place on top and responsive inset for labels. (I60175)- We have added
PrimaryLayout.setResponsiveContentInsetEnabled
that adds responsive inset to the primary label, secondary label and bottom chip in this layout, to avoid that content going off the screen edge. (I0c457) - Adds method to remove outer margins from
CircularProgressIndicator
so it can be used as a smaller component. (I55c06)
API Changes
- Tiles renderer now excludes font padding on all text elements by default, without an option to include it. (I3e300)
Bug Fixes
- Fixed Text alignment issue when ellipsize, letter spacing and center align are all used on Text. (I716c7)
- Add a workaround for a skia arc drawing issue. (I08f09)
- Fix
ArcLine
drawing direction for RTL layouts. (I6c141)
Version 1.1
Version 1.1.0
February 7, 2024
androidx.wear.protolayout:protolayout-*:1.1.0
is released. Version 1.1.0 contains these commits.
Important changes since 1.0.0
- Gradient support and better representation of lengths larger than 360 degrees in
ArcLine
. - Date-time formatting supports different time zones for dynamic data types.
- Better text autosizing and ellipsizing options, to handle truncated text.
- Spacer supports expanded dimensions with optional weight.
- Schema version requirement annotation to all
ProtoLayout
APIs. - Extended target area to any
Clickable
element to 48 dp x 48 dp, to satisfy accessibility requirements. - Font padding is turned off by default and is the only behavior across all Text elements and Material components that contain text.
Additional changes
- For a more complete set of the changes introduced in version 1.1.0, see the beta01 release notes.
Version 1.1.0-rc01
January 24, 2024
androidx.wear.protolayout:protolayout-*:1.1.0-rc01
is released. Version 1.1.0-rc01 contains these commits.
Bug Fixes
PlatformTimeUpdateNotifierImpl
ticks immediately after enabling update. (I77145)CircularProgressIndicator
has been fixed for RTL layouts. From now on, it will go clockwise in all cases. (I95ee3)- Add a workaround for a skia arc drawing issue. (I08f09)
Version 1.1.0-beta01
January 10, 2024
androidx.wear.protolayout:protolayout-*:1.1.0-beta01
is released. Version 1.1.0-beta01 contains these commits.
New Features
The 1.1.0-beta01 release of Wear ProtoLayout indicates that this release of the library is feature complete and the API is locked (except where marked as experimental). Wear ProtoLayout 1.1 includes the following new functionalities and APIs:
ArcLine
now supports gradient by addingBrush
withSweepGradient
and having a shadow on the cap to better represent length larger than 360 degrees by addingShadow
on the existingStrokeCap
.DynamicInstant
has support for zoned date-time formatting.DynamicInstant
andDynamicDuration
can be used as state or platform data types.- Autosizing feature for text size that allows setting multiple sizes to
FontStyle.setSizes
where the Text size will automatically scale based on the space it has inside of the parent. Additionally, we improved ellipsizing options for text that overflows by addingTEXT_OVERFLOW_ELLIPSIZE
and deprecatingTEXT_OVERFLOW_ELLIPSIZE_END
. Spacer
now supports having expanded dimensions with optional weight. For buildingExpandedDimensionProp
we have added a helper methodDimensionBuilders.weight
.- Support for dynamically hiding and unhiding layout elements with
Modifier.visible
. This includes having dynamic values inBoolProp
. - All
ProtoLayout
APIs now have schema version requirement annotation and version can be checked before calling a newer API. - Every element that has
Clickable
now has its target area extended to at least 48x48 in the renderer to better support accessibility requirements. - Following other Material components and Compose initiatives, we have now turned off font padding by default on all
Text
elements. Additionally,AndroidTextStyle
and related setters have been removed from the public API. with following bug fixes: - Added a setter for positioning the edge content in
EdgeContentLayout
so it can be positioned before other content. - Consistently throwing an exception when encountering an unrecognized enum value.
- Invalidate the result of an expression when it yields an invalid numeric value (NaN or infinite) or throws an
ArithmeticException
.
API Changes
- Updates to
SweepGradient
API to allow accepting either colors orColorStops
in the constructor. (I6676f)
Bug Fixes
- Adding a restricted API and renderer support for setting a direction in which arc elements are drawn. (Idef5a)
RoundMode
defaults toFloor
inFloatToInt32Node
when unspecified. The node will still throw an exception if the providedRoundMode
is unrecognized. (I1b2d8)
Version 1.1.0-alpha04
December 13, 2023
androidx.wear.protolayout:protolayout-*:1.1.0-alpha04
is released. Version 1.1.0-alpha04 contains these commits.
New Features
VersionInfo
class not implements theComparable
interface. (I8d13c)- Renderer now supports
TEXT_OVERFLOW_ELLIPSIZE
option. (I7f085)
API Changes
- Text overflow option
TEXT_OVERFLOW_ELLIPSIZE_END
is now deprecated. Please use the new APITEXT_OVERFLOW_ELLIPSIZE
with very similar behavior. (I822d8) - Following other Material components and Compose initiatives, we have now turned off font padding by default on all Text elements. Additionally,
AndroidTextStyle
and related setters have been removed from the public API. (I79094, Ib0b03, I32959, Iaf7d5, Ifa298, I0a4ae, Ida9d3) Modifier.hidden
is replaced withModifier.visible
(I56902)FontStyle#setSizes
now accepts int instead ofSpProp
arguments. (I02b37)
Bug Fixes
- Throw an exception when encountering an Undefined or Unrecognized enum value. (I9d2cf)
- Refactor
DynamicTypeBindingRequest
. (I27b57) - Invalidate the result of an expression when it yields an invalid numeric value (NaN or infinite) or throws an
ArithmeticException
. (I681ae)
Version 1.1.0-alpha03
November 29, 2023
androidx.wear.protolayout:protolayout-*:1.1.0-alpha03
is released. Version 1.1.0-alpha03 contains these commits.
New Features
- Add experimental support for dynamically hiding/unhiding layout elements (I64a78)
- Add dynamic value support to
BoolProp
(I2fe96) - Add schema version requirement annotation to
ProtoLayout
APIs (I0f03c) - Extending the API with the new option in
TextOverflow
for ellipsizing the Text in a fixed parent container even when max lines is not reached (but there's not enough space for Text). (I110a9) - Added helper method
DimensionBuilders.weight
for buildingExpandedDimensionProp
with weight. (I4f72b) DynamicInstant
andDynamicDuration
can be used as state or platform data types. (I6819f)
API Changes
- Update The API to hide
DynamicZonedDateTime
and move all its operations toDyanamicInstant
(I34b94) - Spacer now supports Expanded dimension for width/height. (Ie7c94)
- Support click target area extension in Renderer (I39c79)
Version 1.1.0-alpha02
November 15, 2023
androidx.wear.protolayout:protolayout-*:1.1.0-alpha02
is released. Version 1.1.0-alpha02 contains these commits.
New Features
- Added an
ArcLine
StrokeCap
Shadow
field to the API. (I830ec) - Extending the API to be able to specify Spacer's width or height to expand. (I757ca)
- We have added an experimental API to automatically scale the text size based on the space it has inside of the parent. (Ibbe63)
- Support minimum clickable size (I178e3)
- Added renderer support for
StrokeCap
Shadow
. (I48b17) - Add renderer support for Sweep Gradient in
ArcLine
. (I4d5bb)
Version 1.1.0-alpha01
October 18, 2023
androidx.wear.protolayout:protolayout-*:1.1.0-alpha01
is released. Version 1.1.0-alpha01 contains these commits.
New Features
- Added a brush option to
Arcline
, with support forSweepGradient
. (Ie7ce3) - Added support for zoned date-time formatting. (Ibfae0)
- Added protos and java Wrappers required for zoned date-time formatting. (I97126)
- Added getters for reading back the value stored in a
DynamicDataValue
. (Ie6cea) - Added a setter for positioning the edge content in
EdgeContentLayout
so it can be positioned before other content. (Ie8e8a)
Bug Fixes
- Fixed an issue when an expression with multiple time data source registrations was not being updated immediately. (I8e1a8)
- Fixed a bug to center root element during diff updates. (Ie48f7)
- Unset (or empty) layout constraint values will not be ignored anymore. (Ibc785)
- Reduced delay between a layout becoming visible and its pipeline nodes being initialized. (I38d4e)
Version 1.0
Version 1.0.0
August 9, 2023
androidx.wear.protolayout:protolayout-*:1.0.0
is released. Version 1.0.0 contains these commits.
Major features of 1.0.0
ProtoLayout library introduces APIs for creating layouts and expressions that can be used across different Wear OS surfaces. For example Tiles library uses these APIs to support platform data binding (for faster tile data updates) and animations.
Version 1.0.0-rc01
July 26, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-rc01
is released. Version 1.0.0-rc01 contains these commits.
- To migrate from Tiles to
ProtoLayout
, please follow the instructions here.
API Changes
- We have removed
setLayoutConstraintForDynamicAnchorAngle
andgetLayoutConstraintForDynamicAnchorAngle
methods from Arc element. These methods have been added by mistake and they didn't have any effect on the provided layout. (If7d01) - We have limited the maximum depth that a
ProtoLayout
’s layout can have to 30 nestedLayoutElements
. (I8a74b)
Bug Fixes
- We have added a check to throw if
DynamicColor
has been set for aSpanText
. (I0e5bc) - It is clarified that
DAILY_CALORIES
data source unit is kcal. (Iaa785)
Version 1.0.0-beta01
June 21, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-beta01
is released. Version 1.0.0-beta01 contains these commits.
New Features
- Allow setting clock for time binding tests. (I05622)
API Changes
PlatformDataReceiver.onData()
andStateBuilders.Builder.addKeyToValueMapping
now accept type-safe mapping ofDynamicDataKey
toDynamicDataValue
rather than unsafe generics. That means thatDynamicDataValue
is now typed with itsDynamicType
.HEART_RATE_ACCURACY_X
constants moved to the root ofPlatformHealthSources
, to match other Android constants positioning.HEART_RATE_ACCURACY_X
int constants are now used directly inDynamicHeartRateAccuracy.constant()
andDynamicHeartRateAccuracy.dynamicDataValueOf()
instead of value constant. (I82ff5)- The
PlatformHealthSources.Constants
class was instantiable by mistake. This has been fixed now. (Icb849) PlatformTimeUpdateNotifier#setReceiver
now receivesRunnable
instead ofSupplier
function andExecutor
to notify on. (I9d938)- We have changed the parameter type in the
PlatformTimeUpdateNotifier#setReceiver
fromCallable
toSupplier
. (I664bf) CompactChip
andTitleChip
now support adding an icon to it. (I5a01e)
Bug Fixes
- Update Prop messages with dynamic fields to use oneof instead (I81739)
- Reuse setters implementation for overloads that have setters (Ied70c)
- Properly record fingerprints in setters that have overloads (I86ed2)
Version 1.0.0-alpha11
June 7, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-alpha11
is released. Version 1.0.0-alpha11 contains these commits.
New Features
- We've added a
PlatformDataKey
for heart rate accuracy. (I7f9b8)
API Changes
- Rename
StateBuilders#getIdToValueMapping
togetKeyToValueMapping
and change the return type toMap<<AppDataKey<?>,DynamicDataValue>
. (Iaa7ae) - Make
StateStore
a final class (I408ca) TimeGateway
interface has been replaced byPlatformTimeUpdateNotifier
inprotolayout-expression-pipeline
library which provides desired frequency for updating time data. (I60869)- Rename
register
/unregisterForData
inPlatformDataProvider
toset
/clearReceiver
(I14b02) - In Material Text,
getExcludeFontPadding
has been renamed tohasExcludeFontPadding
. (Iea01d) - Setter for perfectly aligning label was added to all chip components. All chips now have min tappable target applied. (I8ae92)
LayoutDefaults#BUTTON_MAX_NUMBER
has been renamed toMAX_BUTTONS
. (I84788)DAILY_DISTANCE
is renamed toDAILY_DISTANCE_M
. (I4f758)
Bug Fixes
- Update Prop types docs to clarify why static value is enforced. Specify the default value used if static value wasn't provided. (I155aa)
PlatformDataKey
namespaces should follow Java style naming. (I47bda)
Version 1.0.0-alpha10
May 24, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-alpha10
is released. Version 1.0.0-alpha10 contains these commits.
New Features
- Add
AppDataKey
for accessing app pushed state; AddPlatformDataKey
for accessing platform data; Add namespace support inStateStore
. (I7985e) - Support
Equal
andNotEqual
operations forDynamicBool
. (I6a0c1)
API Changes
FontStyles
class is now final (Iaa2ea)LayoutElementBuilders#FontStyles
has been deprecated. Please useandroidx.wear.protolayout.Typography
or create your ownFontStyle
. (Ic929b)- Hide
Action#Builder
nested interface fromAction
interface. Implementations of Builder are already provided byLoadAction
andLaunchAction
classes. (I1d70c) - Allow using
DynamicFloat
withFloatProp
. Note thatFloatProp
do no require layout constraints as it's not used as a layout changing prop. (I286ac) - The
LoalAction
andSetStateAction
actions are removed as they were not really supported yet. (I5d6a6) - Added support for ARGB_8888 format for inline image resources. (I8a07c)
- Rename
StateEntryValue
toDynamicDataValue
, and update the state APIS to use theDynamicDataKey
(If1c01) - We are limiting the number of entries that are allowed in the
StateStore
in order to ensure that memory usage and state update time are well contained and controlled for each instance of theStateStore
. As a result, the developer needs to ensure that they do not have more thanMAX_STATE_ENTRY_COUNT
entries in the map otherwise they will get anIllegalStateException
when creating or updating theStateStore
. (Ibadb3) - Hide
OnLoadTrigger
andOnConditionMetTrigger
classes, and renamesetTrigger
tosetCondition
forOnConditionMetTrigger
. (Ibf629) - For performance and compatibility reasons, the
ProtoLayout
renderers won't support the full set of features inAnimatedVectorDrawable
resources. We're marking those APIs as experimental until we can define the supported set. (Ic6daf) - Added dynamic types for daily distance, daily calories and daily floors. Keys for platform health sources are now under
PlatformHealthSources.Keys
(Ib7637) - The
Easing.cubicBezier
method replaces theCubicBezierEasing.Builder
. With that theEasingFunction
class is removed and the easing constants from that class are now directly accessible from theEasing
interface. In additionsetInfiniteRepeatable
is replaced byINFINITE_REPEATABLE_WITH_RESTART
andINFINITE_REPEATABLE_WITH_REVERSE
(Ib41e7) - Implement
PlatformDataProvider
to provide heart rate and daily steps.SensorGateway
interface is removed from public API. (I55b84) - Add
PlatformDataProvider
, and updateStateStore
to register toPlatformDataProvider
when the provider's supported key is required by node from expression pipeline. (Ib616a) SensorGateway
is no longerCloseable
as it no longer maintains any state. (I6b4f7)- Allow using
FloatProp
withDynamicFloat
for progress inCircularProgressIndicator
. This is supported for renderers supporting version 1.2. Old renderers will fallback to thestaticValue
if provided, otherwise to 0 (I0d91b) MultiButtonLayout
constants have been refactored intoLayoutDefaults.MultiButtonLayoutDefaults
class which now contains those for button sizes depending on a number of buttons in the layout. (I13973)- Support using
StringProp
withDynamicString
in Material Text. This is supported for renderers supporting version 1.2. Old renderers will fallback to the provided static value. UpdateText#getText
return type fromString
toStringProp
. (I7275b)
Version 1.0.0-alpha09
May 10, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-alpha09
is released. Version 1.0.0-alpha09 contains these commits.
New Features
- We've added an experimental extension layout element. Note that this can't be used by default and requires a renderer extension capable of understanding the layout element. (I6581d)
- Added
StrokeCap
support forArcLine
. (I94951) - Added support for Conditional Instant operation. (I489a7)
- Added support for Conditional Duration operation. (Iab469)
- Added support for creating duration from seconds. (Ib5fa1)
API Changes
enable/disablePlatformSource
methods have been removed fromDynamicTypeEvaluator
. The caller should be responsible for updates. (I78c6d)- Allow capping the size of bound data types. (Ie2966)
- Add support for dynamic content description in
protolayout-material
. (I62c8e) - Use long and
@IntRange
for duration and delay in AnimationParameters. (I388b6)
Version 1.0.0-alpha08
April 19, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-alpha08
is released. Version 1.0.0-alpha08 contains these commits.
New Features
AndroidTextStyle
has been added toLayoutElementBuilders
. (I8d967)- We have added support for setting excluding font padding in
ProtoLayout
Material Text. (I17f5d) - ARGB_8888 is now supported for inline images. (I18c1e)
DynamicColor
now supportsonCondition
operation. (I10927)
API Changes
- Support custom duration for reverse animation (I3251f)
- We've added the
SemanticDescription
modifier. In addition,ContentDescription
is not bindable. (I3f1d) - The
DynamicBool.isFalse()
method is now replaced withDynamicBool.negate()
and theDynamicBool.isTrue()
is removed. In addition NaNDynamicFloat
values and narrowing aDynamicInt32
to aDynamicFloat
now emit an invalid dynamic result. (I6ac1e) - Int and float formatters now use the Builder pattern. (Ieb213)
Bug Fixes
- Fallback static value has been removed from animatable fields. (Ifcb01)
DynamicTypeValueReceiver#onPreUpdate
has been removed. (I2dc35)- Length of Strings in dynamic expressions are now capped. (I4c93)
- The gradle dependencies are now correctly set to
api
instead ofimplementation
when required. (I40503)
Version 1.0.0-alpha07
April 5, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-alpha07
is released. Version 1.0.0-alpha07 contains these commits.
New Features
API Changes
sensorGateway#registerSensorGatewayConsumer
takes data type as a parameter instead of method in Consumer. (Icf314)ObservableStateStore
has been renamed toStateStore
. (Ieb0e2)- Added
DynamicTypeEvaluator.Builder
instead of constructor arguments to allow more optional arguments, includingObservableStateStore
which now defaults to an empty store. (I6f832) - Refactored order of parameters in
DynamicTypeEvaluator
. (Ic1ba4)
Bug Fixes
- Correctly propagate signals from platform sensor sources to downstream nodes (I5a922)
Version 1.0.0-alpha06
March 22, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-alpha06
is released. Version 1.0.0-alpha06 contains these commits.
New Features
- We've added an experimental API for using heart rate and daily steps in dynamic expressions (Ifd711)
- We have added support for reverse and forward delay for animations. (Ic25f7)
- We've added
DynamicColor
support to Border and Background - We've added dynamic value support to types in
DimensionBuilder
- Layout and components from
tiles-material
are moving toprotolayout-material
API Changes
LoadActionListener
has been added toProtoLayoutViewInstance
. (If7806)
Bug Fixes
- Added
FloatNodesTest
(Id7281) - Fix renderer crash when unable to load structured bitmap.
Version 1.0.0-alpha05
March 8, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-alpha05
is released. Version 1.0.0-alpha05 contains these commits.
New Features
- We've added an experimental "content update" animation to the
Modifiers
object. This animation will trigger whenever the element (with this modifier) or one of its children changes during a layout update. (bd03e5d)
API Changes
- We've added
forwardRepeatDelayMillis
andreverseRepeatDelayMillis
toRepeatable
. We've also renameddelayMillis
inAnimationSpec
tostartDelayMillis
(Ifb266) DynamicTypeEvaluator.bind
methods now accept an Executor. (I346ab)- We've added the
startEvaluation
method to theBoundDynamicType
to trigger the evaluation after the dynamic type is bound. (I19908)
Bug Fixes
- The Animator object will be reused for subsequent animations of a single element. (Ia3be9)
Version 1.0.0-alpha04
February 22, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-alpha04
is released. Version 1.0.0-alpha04 contains these commits.
New Features
ObservableStateStore
now informs the listeners when a key is removed too.- We've added renderer schema version and font scale to
DeviceParameters
(which can be used to conditionally create layouts in response to different versions and font settings). - We've added support for animating
DynamicInt32
values (I05485) - We've added
OnLoad
andOnConditionalMet
triggers. These can be used to start animations that support a trigger. - We've added layout weight for expanded dimensions and min size for wrapped dimensions.
- We've added duration and instant dynamic types. These can be used to represent a time instant or duration in a dynamic expression.
- We've added support for
AnimatedVectorDrawable
andSeekableAnimatedVectorDrawable
as layout resources.
API Changes
- Sensor data requires API 29+. (I8099e)
- We've added two
launchAction
helper methods (for launching Activities).
Bug Fixes
- Rename
set/getSpec
toset/getAnimationSpec
in Tiles animation (I3d74b)
Version 1.0.0-alpha03
February 8, 2023
androidx.wear.protolayout:protolayout-*:1.0.0-alpha03
is released. Version 1.0.0-alpha03 contains these commits.
New Features
- We have added
toByteArray()
andfromByteArray()
to Dynamic types in protolayout-express library. - We have added
toString()
to Dynamic types in protolayout-expression library. - We have added evaluation support for Dynamic types. The
DynamicTypeEvaluator
class from the protolayout-expression-pipeline library can be used to evaluate (and receive updated values) for a previously create Dynamic type (DynamicString
,DynamicFloat
, …) - When animations can't be played (either because they are disabled by the evaluator, or the number of running animations has reached the set limit), the static values set on the animatable node will be used to replace the animation.
Version 1.0.0-alpha02
January 25, 2023
androidx.wear.protolayout:protolayout:1.0.0-alpha02
, androidx.wear.protolayout:protolayout-expression:1.0.0-alpha02
, and androidx.wear.protolayout:protolayout-proto:1.0.0-alpha02
are released. Version 1.0.0-alpha02 contains these commits.
New Features
- Layout builders from
androidx.wear.tiles:tiles
are moving toandroidx.wear.protolayout:protolayout
. The ones inandroidx.wear.tiles:tiles
will be deprecated in one of the next alpha releases.
Version 1.0.0-alpha01
January 11, 2023
androidx.wear.protolayout:protolayout-expression:1.0.0-alpha01
and androidx.wear.protolayout:protolayout-proto:1.0.0-alpha01
are released. Version 1.0.0-alpha01 contains these commits.
New Features
- This release introduces a new library "ProtoLayout Expression" for creating expressions from dynamic variables.