Home APIs iOS SDK 版本说明

2025-04-09

  iOS Home API 公开 Beta 版发布  

在公开开发者 Beta 版期间，所有开发者都可以开始构建和测试其 iOS 应用。

此版本修复了一些 bug，并提升了 Home API iOS SDK 的正式版 (GA) 质量。

最低版本

  • 汇总到 connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS：iOS 16.4 及更高版本、Xcode 15.3 及更高版本
  • Google Hub 固件最低版本：
    • Cast 版本：3.75.456944
    • Fuchsia 最低版本：24.20241009.103.1900601
  • iOS SDK：home_platform_ios_1.0_1.zip
  • Google Home 应用最低版本：适用于任何版本
  • Matter 版本： 1.4.0.0
    • 注意：不支持临时 Matter 设备类型和集群。

已知问题

  • 从 Wi-Fi 切换到移动网络时，设备控制延迟可能会增加。
  • 在 iOS 版 Google Home 应用中授予权限时，了解详情和返回按钮可能无响应。
    • 解决方法：长按了解详情链接，在系统浏览器中打开该链接，或点按左上角的关闭按钮退出该视图。
  • 在 Google Home 应用处于打开状态时撤消权限会导致应用崩溃。
  • 基本视频播放器可能无法在示例应用中运行。
  • 采用 Cloud-to-Cloud 的温控器可能无法正常运行。
  • 在示例应用中，对由 Cloud-to-Cloud 支持的风扇设备类型的控制可能不起作用。
  • 对依托 Cloud-to-Cloud 的窗帘设备类型的控制可能无法正常运行。
  • 在从本地网络切换到 Wi-Fi 或在应用之间切换期间，iOS 版 GHA 可能会崩溃。

修复的已知问题

  • 不支持设备命名和重命名。
  • 如需进行调试，需要使用 iOS 版 Google Home 应用调试结构中的第一台 Matter 设备。Home API 目前无法创建新的 fabric，只能为 2023 年之前创建的结构添加到现有 fabric。2023 年之后创建的结构不受此问题影响。