Wear Tiles

Create applications for Wear OS by Google smartwatches.
Latest Update Current Stable Release Next Release Candidate Beta Release Alpha Release
June 2, 2021 - - - 1.0.0-alpha06

Declaring dependencies

To add a dependency on Wear, 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 tiles
    implementation "androidx.wear.tiles:tiles:1.0.0-alpha06"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.0.0-alpha06"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.0.0-alpha06")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.0.0-alpha06")
}

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.

Create a new issue

See the Issue Tracker documentation for more information.

Version 1.0.0

Version 1.0.0-alpha06

June 2, 2021

androidx.wear.tiles:tiles:1.0.0-alpha06, androidx.wear.tiles:tiles-proto:1.0.0-alpha06, and androidx.wear.tiles:tiles-renderer:1.0.0-alpha06 are released. Version 1.0.0-alpha06 contains these commits.

API Changes

  • All Builder classes now contain getters for all properties. Note that these are intended for testing purposes only (I9d155)
  • Package change: Classes in androidx.wear.tiles.builders have been moved to androidx.wear.tiles.
  • Add experimental tint support to Tiles. (I38929)
  • Renamed LayoutElementBuilders.HALIGN_* to LayoutElementBuilders.HORIZONTAL_ALIGN_* (I67e58)
  • Renamed LayoutElementBuilders.VALIGN_* to LayoutElementBuilders.VERTICAL_ALIGN_* (I67e58)
  • Renamed LayoutElementBuilders.SPAN_VALIGN_* to LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* (I67e58)
  • Added builder classes for Requests and Events. (Ib5cf4)
  • Migrated TileProviderService to use request and event classes from RequestBuilders and EventBuilders, rather than RequestReaders/EventReaders (e.g. onTileRequest now provides you with a RequestBuilders.TileRequest, rather than RequestReaders.TileRequest). (I46ea1)

Bug Fixes

  • Fix bug in async image loading for Tiles renderer. (Iad9b0)
  • Fixed layout bug when placing an image with width or height set to expand() in a Box with width or height set to wrap(). (I33770)

Version 1.0.0-alpha05

May 18, 2021

androidx.wear.tiles:tiles:1.0.0-alpha05, androidx.wear.tiles:tiles-proto:1.0.0-alpha05, and androidx.wear.tiles:tiles-renderer:1.0.0-alpha05 are released. Version 1.0.0-alpha05 contains these commits.

API Changes

  • Removed getTileId from incoming tile events (TileAddEvent, TileRemoveEvent, TileEnterEvent, TileLeaveEvent, TileRequest). (Ifbba2)
  • Renamed ImageResource#setAndroidResourceByResid to setAndroidResourceByResId (I4ba6e)
  • Renamed TimelineManager#deInit to close, and implemented AutoCloseable. (I5dff2)

Version 1.0.0-alpha04

May 5, 2021

androidx.wear.tiles:tiles:1.0.0-alpha04, androidx.wear.tiles:tiles-proto:1.0.0-alpha04, and androidx.wear.tiles:tiles-renderer:1.0.0-alpha04 are released. Version 1.0.0-alpha04 contains these commits.

API Changes

  • Hidden concrete TileProviderService classes.
    • Made TileUpdateRequester take a Class<? extends TileProviderService>. (Ib7cca)
  • Added ability to add extras to AndroidActivity. (I748f4)

Tiles Version 1.0.0-alpha03

April 21, 2021

androidx.wear.tiles:tiles:1.0.0-alpha03, androidx.wear.tiles:tiles-proto:1.0.0-alpha03, and androidx.wear.tiles:tiles-renderer:1.0.0-alpha03 are released. Version 1.0.0-alpha03 contains these commits.

API Changes

  • Rename TileManager -> TileClient
    • Rename TileManager#create -> TileClient#connect (I91839)

Bug Fixes

  • Added Proguard rules to ensure tiles and tiles-renderer work properly with Proguard enabled (Ie3d85)

Version 1.0.0-alpha02

April 7, 2021

androidx.wear.tiles:tiles:1.0.0-alpha02, androidx.wear.tiles:tiles-proto:1.0.0-alpha02, and androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits.

API Changes

  • androidx.wear:wear-tiles has moved groups, and should now be referred to as androidx.wear.tiles:tiles
  • androidx.wear:wear-tiles-renderer has moved groups, and should now be referred to as androidx.wear.tiles:tiles-renderer
  • TileRenderer.LoadActionListener now consumes an instance of androidx.wear.tiles.builders.StateBuilders.State rather than androidx.wear.tiles.proto.StateProto.State.
  • TileRenderer now accepts Tile resources from androidx.wear.tiles.builders.ResourceBuilders.Resources, rather than an instance of androidx.wear.tiles.renderer.ResourceAccessors.

Bug Fixes

  • Fixed inability to use LoadActionListener, as it exposed an internal class.

Version 1.0.0-alpha01

March 10, 2021

androidx.wear:wear-tiles:1.0.0-alpha01, androidx.wear:wear-tiles-proto:1.0.0-alpha01, and androidx.wear:wear-tiles-renderer:1.0.0-alpha01 are released. Version 1.0.0-alpha01 contains these commits.

New Features

  • The Wear Tiles Renderer library provides functionality to build custom Tiles for Wear OS devices, along with the classes that allow the system to fetch your Tile and display it right next to your watch face.