Home APIs iOS 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 iOS SDK.

Minimum versions

  • 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
  • iOS SDK: home_platform_ios_1.8.0_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

Fixed known issues

  • The Nest Cam Outdoor (wired, 2nd gen) may fail to Commission. Its tile stays grayed-out, error messages appear, and the camera cannot be controlled.
  • Cannot change the Google Nest Learning Thermostat (4th gen) v4 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.
  • After switching users on the same controller, GHA device tiles go offline. Multi-user households where users are using the same controller may experience offline devices until the app is relaunched.

Known issues

  • Commissioning Matter devices 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 iOS SDK.

Minimum versions

  • iOS: iOS 17.0+, Xcode 15.3+
  • For Matter commissioning: iOS 17.6+
  • 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.260120.001
  • iOS SDK: home_platform_ios_1.7.1
  • Google Home App min version: 1.7.1
  • Matter version: 1.4.1.0
  • Matter version: experimental support for 1.5.0

New features

Other changes of note

  • Simplified subscriptions consent flow.

Sample app

Fixed known issues

  • History filtering doesn't display all expected events for the day and device upon initial loading. Workaround: Clear all filters to so that all events appear.
  • 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.

Known issues

  • The Nest Cam Outdoor (wired, 2nd gen) may fail to Commission. Its tile stays grayed-out, error messages appear, and the camera cannot be controlled.
  • Cannot change the Google Nest Learning Thermostat (4th gen) v4 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.
  • After switching users on the same controller, GHA device tiles go offline. Multi-user households where users are using the same controller may experience offline devices until the app is relaunched.
  • Commissioning Matter devices may fail.

2026-02-13

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

Sample app

2026-02-09

  Home APIs Public Beta release 1.7  

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

Minimum versions

  • iOS: iOS 17.0+, Xcode 15.3+
  • For Matter commissioning: iOS 17.6+
  • 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
  • iOS SDK: home_platform_ios_1.7.0
  • Google Home App min version: 1.7
  • Matter version: 1.4.1.0
  • Matter version: experimental support for 1.5.0

New features

Other changes of note

Fixed known issues

  • The History API always returns a nextPageToken, causing an infinite loop.
  • A "stream disconnected" error may interrupt long-duration camera stream sessions.
  • Matter device commissioning fails during the execution of CommissionDeviceCommand.

Known issues

  • History filtering doesn’t display all expected events for the day and device upon initial loading. Workaround: Clear all filters to so that all events appear.
  • 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.
  • The correct software version may not appear for Current Camera Device Software version.
  • Chime duration setting is ignored.
  • Turning Off a Nest Doorbell (battery, 2nd gen) Camera results in a frozen screen.
  • Nest Cam IQ camera settings should show only three chime themes, but many more appear.
  • 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 iOS SDK.

Minimum versions

  • iOS: iOS 17.0+, Xcode 15.3+
  • For Matter commissioning: iOS 17.6+
  • 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
  • iOS SDK: home_platform_ios_1.6.0
  • Google Home App min version: 1.6
  • Matter version: 1.4.1.0

New features

Other changes of note

  • iOS Sample App adds more settings for Camera and Doorbell, integrates SDK by default using Swift Package Manager.

Fixed 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-10-22

  Home APIs Public Beta release 1.5.1  

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

Minimum versions

  • iOS: iOS 17.0+, Xcode 15.3+
  • For Matter commissioning: iOS 17.6+
  • Google hub firmware, Cast: 3.76.495998
  • Google hub firmware, Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.1.zip
  • Google Home App min version: works with any version
  • Matter version: 1.4.1.0

New features

Fixed known issues

  • When using the Sample App, the livestream would crash unexpectedly.

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.
  • An error occurs when commissioning a Matter-over-Thread device using iOS Home API. Workaround: Add the Thread border router through iOS GHA on the same phone.

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 iOS SDK.

Minimum versions

  • iOS: iOS 17.0+, Xcode 15.3+
  • For Matter commissioning: iOS 17.6+
  • Google hub firmware, Cast: 3.76.495998
  • Google hub firmware, Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.0.zip
  • Google Home App min version: works with any version
  • Matter version: 1.4.1.0

New features

Other changes of note

  • iOS Sample App adds Support for Camera device type and Hub activation.

Fixed known issues

  • An error occurs when creating an automation and an unknown device type was incorrectly appearing as a selectable option.

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.
  • An error occurs when commissioning a Matter-over-Thread device using iOS Home API. Workaround: Add the Thread border router through iOS GHA on the same phone.

2025-08-28

  Home APIs Public Beta release 1.4.1  

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

Minimum versions

  • iOS: iOS 17.0+, Xcode 15.3+
  • For Matter commissioning: iOS 17.6+
  • Google hub firmware, Cast: 3.76.495998
  • Google hub firmware, Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.4.1.zip
  • Google Home App min version: works with any version
  • Matter version: 1.4.1.0

New features

Other changes of note

  • iOS Sample App adds Thermostat control.

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.
  • An error occurs when commissioning a Matter-over-Thread device using iOS Home API. Workaround: Add the Thread border router through iOS GHA on the same phone.

2025-07-30

  Home APIs Public Beta release 1.4.0  

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

Minimum versions

  • iOS: iOS 17.0+, Xcode 15.3+
  • For Matter commissioning: iOS 17.6+
  • Google hub firmware, Cast: 3.75.456944
  • Google hub firmware, Fuchsia: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.4.0.zip
  • Google Home App min version: works with any version
  • Matter version: 1.4.0.0

New features

Other changes of note

  • iOS Sample App drops ability to delete Matter-only devices.

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.
  • An error occurs when commissioning a Matter-over-Thread device using iOS Home API. Workaround: Add the Thread border router through iOS GHA on the same phone.

2025-06-26

  Home APIs Public Beta release 1.3.2  

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

Minimum versions

  • iOS: iOS 16.4+, Xcode 15.3+
  • Google hub firmware, Cast: 3.75.456944
  • Google hub firmware, Fuchsia: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.3.2.zip
  • Google Home App min version: works with any version
  • Matter version: 1.4.0.0

New features

Fixed known issues

  • Thermostats backed by Cloud-to-Cloud may not work.

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.
  • An error occurs when commissioning a Matter-over-Thread device using iOS Home API. Workaround: Add the Thread border router through iOS GHA on the same phone.

2025-06-05

  Home APIs Public Beta release 1.3.1  

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

Minimum versions

Other changes of note

Fixed known issues

  • The iOS version of the GHA may crash during network changes from local to Wi-Fi or switching between apps.

Known issues

  • There may be increased device control latency when switching from Wi-Fi to a mobile network.
  • Thermostats backed by Cloud-to-Cloud may not work.
  • Control of Fan device types backed by Cloud-to-Cloud may not work in the sample app.
  • An error occurs when commissioning a Matter-over-Thread device using iOS Home API. Workaround: Add the Thread border router through iOS GHA on the same phone.

2025-05-09

  Home APIs Public Beta release 1.3  

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

Minimum versions

New features

Fixed known issues

  • When granting permissions in the iOS version of the Google Home App, the Learn more and back buttons may be unresponsive. Workaround: Long press the Learn more link to open it in the system browser, or tap the close button in the upper-left to exit the view.
  • Basic Video Player may not work in the sample app.
  • Control of Window Covering device types backed by Cloud-to-Cloud may not work.
  • Revoking permission while the Google Home app is open will crash the app.

Known issues

  • There may be increased device control latency when switching from Wi-Fi to a mobile network.
  • Thermostats backed by Cloud-to-Cloud may not work.
  • Control of Fan device types backed by Cloud-to-Cloud may not work in the sample app.
  • The iOS version of the GHA may crash during network changes from local to Wi-Fi or switching between apps.

2025-04-09

  iOS Home APIs Public Beta release  

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

This release contains bug fixes and enhances general availability (GA) quality for the Home APIs iOS SDK.

Minimum versions

  • Rolls up to connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS: iOS 16.4+, Xcode 15.3+
  • Google hub firmware min versions:
    • Cast version: 3.75.456944
    • Fuchsia min version: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.0_1.zip
  • Google Home App min version: works with any version
  • Matter version: 1.4.0.0
    • Note: Provisional Matter device types and clusters are not supported.

Known issues

  • There may be increased device control latency when switching from Wi-Fi to a mobile network.
  • When granting permissions in the iOS version of the Google Home App, the Learn more and back buttons may be unresponsive.
    • Workaround: Long press the Learn more link to open it in the system browser, or tap the close button in the upper-left to exit the view.
  • Revoking permission while the Google Home App is open will crash the app.
  • Basic Video Player may not work in the sample app.
  • Thermostats backed by Cloud-to-Cloud may not work.
  • Control of Fan device types backed by Cloud-to-Cloud may not work in the sample app.
  • Control of Window Covering device types backed by Cloud-to-Cloud may not work.
  • The iOS version of the GHA may crash during network changes from local to Wi-Fi or switching between apps.

Fixed known issues

  • Device naming and renaming is not supported.
  • For commissioning, the first Matter device in a structure needs to be commissioned using the iOS Google Home App. The Home APIs are currently not capable of creating a new fabric, only adding to an existing fabric for structures created before 2023. Structures created after 2023 are unaffected by this issue.