Home APIs Android SDK release notes

2026-04-09

  Home APIs Public Beta release 1.8  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 26.12.32
• Google hub firmware, Cast, Nest WiFi Pro: 3.78.518349
• Google hub firmware, Cast, All other Cast-based hubs: 3.78.526062
• Google hub firmware, Fuchsia: 29.20251023.103.2101601
• Google hub firmware, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_8_0
• Google Home App: works with any version
• androidx.core library: works with any version
• Matter version: 1.4.1.0
• Matter version: experimental support for 1.5.0

New features

• Suggested automations in Automations API.
• Support for multipart devices in Device API.
• Camera and Doorbell Activity Zone Setup in Device API.
• Camera and Doorbell Sound Detection Setup in Device API.
• Camera and Doorbell Recording mode (CVR/EVR/No History) in Device API.

Fixed known issues

• Cannot change the Google Nest Learning Thermostat (4th gen) temperature units (C/F).
• In the mobile version of Google Home for web, the top icon and back button are obscured by a header. Users may be unable to go back or see key user interface elements.
• An Android TV hub may incorrectly report Matter devices as "Offline."

Known issues

• Commissioning a Matter device may fail.

2026-03-13

  Home APIs Public Beta release 1.7.1  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services:
• Google hub firmware, Cast, Nest WiFi Pro: 3.78.518349
• Google hub firmware, Cast, All other Cast-based hubs: 3.78.516526
• Google hub firmware, Fuchsia: 29.20251023.103.2201
• Google hub firmware, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_7_1
• Google Home App: 1.7.1
• androidx.core library: works with any version
• Matter version: 1.4.1.0
• Matter version: experimental support for 1.5.0

New features

• Camera and Doorbell Analytics opt-in in Device API.
• Camera and Doorbell Last connected time in Device API.
• Camera and Doorbell Connectivity state in Device API.
• Thermostat atomic requests in Device API.

Other changes of note

• Hubless mode has been removed.

Sample app

• Home APIs Android Sample App v1.7.1. See the GitHub release for details.

Fixed known issues

• For Nest Cam Indoor/Outdoor (battery or wired) and Nest Doorbell (battery, 2nd gen), the "Battery Time Remaining" Option is not present in Battery Settings.
• Chime duration setting is ignored.
• Philips BLE light incorrectly appears as "Online" even when the device is actually offline.

Known issues

• Cannot change the Google Nest Learning Thermostat (4th gen) temperature units (C/F).
• Potential delays in network stability and device responsiveness.
• In the mobile version of Google Home For Web, the top icon and back button are obscured by a header. Users may be unable to go back or see key user interface elements.
• Hub may become stuck in the "Connecting..." state after Federated mode OOBE.
• Commissioning a Matter device may fail.
• An Android TV hub may incorrectly report Matter devices as Offline.
• The correct software version may not appear for Current Camera Device Software version.
• A Thermostat UI slider shows temperatures that are out-of-range.
• When Chime Duration is set, the device doesn't chime for specified duration.

2026-02-13

The Home APIs Android Sample App has been updated for the Home APIs 1.7 release.

Sample app

• See the GitHub v1.7.0 release for complete release notes.

2026-02-09

  Home APIs Public Beta release 1.7  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 26.02.34
• Google hub firmware, Cast, Nest WiFi Pro: 3.76.508025
• Google hub firmware, Cast, All other Cast-based hubs: 3.77.510748
• Google hub firmware, Fuchsia: 29.20251023.103.2100
• Google hub firmware, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_7
• Google Home App: 1.7
• androidx.core library: works with any version
• Matter version: 1.4.1.0
• Matter version: experimental support for 1.5.0

New features

• Local Automations: based on conditions such as connectivity, device types, and traits, some automations may now execute locally in Automations API.
• Camera Out-of-Box Experience (OOBE) enablement in apps in Device API.
• Camera and Doorbell Chime Themes in Device API.
• Camera and Doorbell Automatic Battery Saver in Device API.
• Camera and Doorbell Battery Usage Preferences in Device API.
• Camera and Doorbell Battery Charging State in Device API.
• Camera and Doorbell Battery Levels in Device API.
• Camera and Doorbell Serial Number in Device API.
• Camera and Doorbell Model in Device API.
• Camera and Doorbell Software version in Device API.
• Custom Key-Value API in Device API.
• Permissions query lets an app determine which device types have been granted access by the user in Permissions API.

Other changes of note

• HomeException.unsupported has been replaced with HomeException.unimplemented to align with standard error codes.
• The packaged code generator for custom traits has changed for release 1.7. Developers who have custom traits need to recompile their traits once they've integrated the 1.7 SDK.

Fixed known issues

• The History API always returns a nextPageToken, causing an infinite loop.
• "User cancelled Permission flow" error occurs when trying to log in to a new account.

Known issues

• For Nest Cam Indoor/Outdoor (battery or wired) and Nest Doorbell (battery, 2nd gen), the "Battery Time Remaining" Option is not present in Battery Settings.
• Chime duration setting is ignored.
• Philips BLE light incorrectly appears as "Online" even when the device is actually offline. Workaround: Don't rely solely on the Smart Home Device Type (SHDT) online status. Instead, use the Target Device State Service (TDSS) map for devices with the LOCAL_SYNC source.

2025-12-22

  Home APIs Public Beta release 1.6  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 25.47.30
• Google hub firmware, Cast, Nest WiFi Pro: 3.75.479819
• Google hub firmware, Cast, All other Cast-based hubs: 3.77.505721
• Google hub firmware, Fuchsia: 28.20250723.103.2100300
• Google hub firmware, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_6
• Google Home App: 1.6
• androidx.core library: works with any version
• Matter version: 1.4.1.0

New features

• Automation API Weather trait support. Added support for the Weather trait in automation starters and conditions.
• Support for more Camera and Doorbell device capabilities: New settings (Night vision, Status LED, Viewport, Orientation, Sensitivity, Event length, Chime).
• App-initiated Google sign-in to streamline UX flow and eliminate active user checks.
• Hubless Mode lets users onboard and control certain Matter devices without a standalone hub.
• Hub Activation API to discover and activate hubs.

Other changes of note

• Android Sample App adds Camera settings, Predefined automations, Fan and Speaker support.

Known issues

• Device controls stop working after extended periods of use. Workaround: Restart the hub.
• Matter device commissioning may fail.
• "User cancelled Permission flow" error appears when trying to add a new account in the Sample App for Android. Workaround: Add Google accounts through Android device settings.
• A Walmart onn wired Security Camera commissioned using the Android Home APIs SDK cannot livestream over the Google Home App.
• Cameras commissioned in Home APIs apps are not able to start livestream sessions from the Google Home App.

2025-10-23

  Home APIs Public Beta release 1.5.1  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 25.41.30
• Google hub firmware, Cast: 3.76.495998
• Google hub firmware, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5_1
• Google Home App: works with any version
• androidx.core library: works with any version
• Matter version: 1.4.1.0

New features

• Hub activation API lets you programmatically discover and activate a Google Home hub in Structure API.

Other changes of note

• Android Sample App adds Doorbell Device Type support (OnOff, Livestream, Two-way talk) and Hub Activation API implementation.

Fixed known issues

• The Sample App isn't correctly showing device status on the Device view.

2025-09-26

  Home APIs Public Beta release 1.5.0  

This release introduces support for Camera devices, contains bug fixes, and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 25.37.31
• Google hub firmware, Cast: 3.76.492738
• Google hub firmware, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5
• Google Home App: works with any version
• androidx.core library: works with any version
• Matter version: 1.4.1.0

New features

• Starters, conditions, and actions now accept Matter structs as parameters in Automation API.
• Camera device type added to Device API (Livestream, Two-way talk, Start/stop recording).

Other changes of note

• Android Sample App adds Support for Camera, Multi-admin commissioning, Predefined OnOff automation.

Fixed known issues

• When the currently-active hub is force-removed, there is a five-minute window during which it isn't possible to control some devices. After five minutes, the ability to control devices is restored.
• After the user selects a color from a preset or from the color temperature picker, the Extended Color Light fails to update the color.

Known issues

• There may be increased device control latency when switching from Wi-Fi to a mobile network.
• Control of Fan device types backed by Cloud-to-Cloud may not work in the Sample App.

2025-08-29

  Home APIs Public Beta release 1.4.1  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 25.33.32
• Google hub firmware, Cast: 3.76.495998
• Google hub firmware, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_1
• Google Home App: works with any version
• androidx.core library: works with any version
• Matter version: 1.4.0.0

New features

• A new DecommissionIneligibleReason is defined for attempting to decommission a multi-source device in Device API.

Fixed known issues

• The Android Sample App crashes when a user attempts to set a thermostat to a mode it doesn't support.

Known issues

• When the currently-active hub is force-removed, there is a five-minute window during which it isn't possible to control some devices. After five minutes, the ability to control devices is restored.

2025-07-31

  Home APIs Public Beta release 1.4.0  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 25.28.34
• Google hub firmware, Cast: 3.76.486931
• Google hub firmware, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_0
• Google Home App: works with any version
• androidx.core library: works with any version
• Matter version: 1.4.0.0

New features

• Automations can be constrained to execute up to a finite number of times in Automation API.
• The ability to programmatically remove a Matter device in Device API.
• Removed deprecated HomeDevice members (trait(), isInRoom, isInStructure).
• Home.hasPermissions() now incorporates both OAuth structure access and app permission grants.

Other changes of note

• Android Sample App deletes Matter-only devices, renames devices, replaces deprecated API calls.

Fixed known issues

• Vacuum devices that have been docked don't register Docked state.

Known issues

• After logging out of a phone and logging back in, a Home APIs app can't control devices. Workaround: Close app and wait at least 10s.

2025-06-26

  Home APIs Public Beta release 1.3.2  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 25.23.31
• Google hub firmware, Cast, Google Home, Google Home Mini, and Google Nest Mini: 3.75.468362
• Google hub firmware, Cast, Google Nest Audio: 3.75.476451
• Google hub firmware, Fuchsia: 26.20250116.103.2900
• Android SDK: home.android.sdk_1_3_2
• Google Home App: works with any version
• androidx.core library: works with any version
• Matter version: 1.4.0.0

New features

• The SDK artifact has been divided into two separate artifacts: The Home APIs SDK framework (play-services-home-17.0.0.aar) and SDK traits and device types (play-services-home-types-17.0.0.aar). Starting with this release, developers need to include both artifacts in their project's compile-time and runtime library paths.

Other changes of note

• Android Sample App adds: Users can disconnect and revoke permissions from the app.
• Android Sample App adds: Updated SDK artifacts to include play-services-home-17.0.0 and play-services-home-types-17.0.0.

Known issues

• Vacuum devices that have been docked don't register Docked state.

2025-06-05

  Home APIs Public Beta release 1.3.1  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 25.19.32
• Google hub firmware, Cast: 3.75.468222
• Google hub firmware, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
• Google Home App: works with any version
• androidx.core library: works with any version
• Matter version: 1.4.0.0

New features

• Introduces the SyntheticSwitch trait which simplifies handling events generated by Matter Switch devices and allows switches to trigger automation starters.
• The ExtendedDoorLock trait has a breaking change: the user_id field datatype has been changed from String to Long. Apps that use this trait need to be recompiled.

Other changes of note

• Android Sample App adds functions to log the state of structures, devices, types, traits, and automations to make it easier to debug.

Fixed known issues

• The Google Home app crashes with a FailedPreconditionException when creating automations if the home location is not set in the Google Home app.
• In the Android Sample App, a device with connectivityState PARTIALLY_ONLINE was previously displayed as offline. This state is now represented as online.

Known issues

• In the Android Sample App, the Create automation button occasionally requires multiple taps to trigger.

2025-05-12

  Home APIs Public Beta release 1.3  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 25.16.33
• Google hub firmware, Cast: 3.75.468222
• Google hub firmware, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202504_EAP_1_3_RC00
• Google Home App: works with any version
• androidx.core library: works with any version
• Matter version: 1.4.0.0

New features

• Added support for recurring scheduled event starters in Automation API, which let developers create automations that run periodically based on clock time, solar time, and calendar-based conditions, using cron expressions.
• Added the ability to rename devices in Device API.
• Added the ability to rename rooms in Structure API.

Fixed known issues

• There may be increased device control latency when switching from Wi-Fi to a mobile network.
• After a hub is factory-reset, devices may appear to be offline.

Known issues

• The Google Home app crashes with a FailedPreconditionException when creating automations if the home location is not set in the Google Home app. Workaround: Check that the home address is present using the Discovery API before attempting to create automations.

2025-04-09

  Home APIs Public Beta release 1.2.1  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services: 25.09.33
• Google hub firmware minimum versions:
  • Cast: 3.75.468222
  • Fuchsia: 24.20241009.103.1900601¹
• Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
• Google Home App: works with any version
• androidx.core library: 1.10.0
• Matter version: 1.4.0.0

^{1. This build is currently rolling out to production and will be available to all devices by April 22, 2025.}

New features

• Improved performance when loading objects from the home graph.
• Automation API
  • Added support for entity filters, which allow automations to dynamically select devices based on criteria specified in the automation.
• Device API
  • Cloud-to-cloud device information is now available in the BasicInformationTrait.

Known issues

• There may be increased device control latency when switching from Wi-Fi to a mobile network.
• After a hub is factory-reset, devices may appear to be offline.

Fixed known issues

• If the Discovery API is called prior to initialization or before initialization is complete, a HomeException with code 14: UNKNOWN and the message "No route found." is thrown.
• In an environment containing multiple structures and multiple users, switching between structures and users may result in no devices being returned.

2025-03-14

  Home APIs Public Beta release 1.2.0  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services min version: 25.06.32
• Google hub firmware min versions:
  • Cast version: 3.75.456944
  • Fuchsia min version: 24.20241009.103.1900601
• Android SDK: home.android.sdk_1_2_0_RC06
• Google Home App min version: works with any version
• androidx.core library min version: 1.10.0
• Matter version: 1.3.0.0
  • Note: Provisional Matter device types and clusters are not supported.

New features

• Automation API:
  • Support for date ranges and partial dates in automation conditions. See Use dates with between.
  • In previous releases, the Discovery API returned a NumberSetConstraint for some bitmap fields when it should have returned a BitmapConstraint. These fields now return a BitmapConstraint as expected. This is limited to optionsMask and optionsOverride bitmaps in the LevelControl trait commands.

Known issues

• There may be increased device control latency when switching from Wi-Fi to a mobile network.
• After a hub is factory-reset, devices may appear to be offline.
• If the Discovery API is called prior to initialization or before initialization is complete, a HomeException with code 14: UNKNOWN and the message "No route found." is thrown.
  • Workaround: Only call the Discovery API when you actually need automation candidates. Don't pre-fetch and cache candidate entities. Check to see whether an entity is online before calling Discovery API methods on it.
• In an environment containing multiple structures and multiple users, switching between structures and users may result in no devices being returned.

Fixed known issues

• The first time a Home APIs app calls HomeManager.structures() after being launched, it receives zero structures, even when one or more structures is present. This gives the incorrect impression that there are no structures associated with the Google Account.
• When loading, creating and editing automations, users may experience long wait times.
• Users who start the setup flow from the Camera app have scan the QR code twice in order to complete Matter commissioning.
• In a structure that contains more than 200 devices, the Discovery API may simply return no candidates.

2025-01-29

  Home APIs Public Beta release 1.1.0  

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK.

Minimum versions

• Google Play services min version: 25.02.32
• Google hub firmware min versions:
  • Cast version: 3.75.456944
  • Fuchsia min version: 24.20241009.103.1900500
• Android SDK: home.android.sdk_202412_EAP_1_1_RC04
• Google Home App min version: works with any version
• androidx.core library min version: 1.10.0
• Matter version: 1.3.0.0
  • Note: Provisional Matter device types and clusters are not supported.

New features

• Streaming API:
  • Provides event streams that notify of structures, rooms, and devices that have been added, changed, and removed.
  • See Subscribe to entity relation events.
• Batching API (Experimental):
  • Allows the developer to send multiple commands in batches that are executed simultaneously.
  • See Send multiple commands at once.

Known issues

• When loading, creating and editing automations, users may experience long wait times.
• Users who start the setup flow from the Camera app have scan the QR code twice in order to complete Matter commissioning.
• In a structure that contains more than 200 devices, the Discovery API may simply return no candidates.

Fixed known issues

• Switching the logged in Google Account may fail and result in an error.
• Google TV devices may not work for automations that use the MediaPlayback trait.
• In a structure that contains only a Google hub:
  • Matter devices may appear to be offline in the Google Home App.
  • Google Assistant cannot control Matter devices.
  • Smart displays cannot control Matter devices or display the state of any Matter device.
• For some devices, an app may not always reflect accurate state, and your app may report a state that is different from that reported by a Google app such as the Google Home App. This is usually due to devices not reporting state to Google.
  • Workaround: Checking state with a Google app resolves the mismatch.

2025-01-14

Updated guidance for Home APIs initialization.

We've made it more clear that an instance of a Home should be initialized as a context singleton. This ensures a smoother user experience in your app and avoids errors with invalid sessions.

2025-01-07

  Home APIs Public Beta release  

During the public developer beta, all developers can begin building and testing their apps.

This release contains bug fixes and enhances beta quality for the Home APIs Android SDK, including improved support for Google Nest Audio and Google TV devices.

Minimum versions

• Google Play services min version: 24.45.34
• Google hub firmware min versions:
  • Cast version: 3.74.444798
  • Fuchsia min version: 22.20240805.103.161
• Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
• Google Home app (GHA) min version: works with any version
• androidx.core library min version: 1.10.0
• Matter version: 1.3.0.0
  • Note: Provisional Matter device types and clusters are not supported.

Known issues

• Switching the logged in Google Account may fail and result in an error.
  • Workaround: Re-run the permissions flow or restart the app.
• Google TV devices may not work for automations that use the MediaPlayback trait.
• In a structure that contains only a Google hub:
  • Matter devices may appear to be offline in the Google Home app (GHA).
  • Google Assistant cannot control Matter devices.
  • Smart displays cannot control Matter devices or display the state of any Matter device.
• For some devices, an app may not always reflect accurate state, and your app may report a state that is different from that reported by a Google app such as the Google Home app (GHA). This is usually due to devices not reporting state to Google.
  • Workaround: Checking state with a Google app resolves the mismatch.

Fixed known issues

• Commissioning may fail if the app is minimized during the process.
  • Workaround: Use the suppressHalfSheetNotification() API to suppress halfsheet notifications when the Commissioning API is used in your app.
• A server-side issue may prevent OkGoogle starters from working in automations.
• When using a hub running Fuchsia that doesn't have any Matter devices in the structure, if the hub is left idle for more than 3 hours, commissioning the first Matter device results in the Matter device being offline.
• After a factory data reset is performed for a hub, commands to newly-commissioned devices may fail despite the device being reported as online.