What problem does it solve?
Provides clear, actionable guidance for building iOS apps that manage HomeKit homes, rooms, and accessories and for commissioning Matter devices into an ecosystem, reducing integration errors and entitlement/configuration pitfalls.
Core Features & Use Cases
- Home and Accessory Management: Patterns for initializing a single HMHomeManager, observing homes/rooms/accessories, and wiring HMHomeDelegate and HMAccessoryDelegate for reliable state updates.
- Characteristics and Scenes: Read, write, and subscribe to HMCharacteristic values safely, create and execute HMActionSet scenes, and configure time or event-based HMTrigger automation.
- Matter Commissioning: End-to-end guidance for MatterSupport commissioning flows including MatterAddDeviceRequest usage, filtering device criteria, and implementing a MatterAddDeviceExtensionRequestHandler for validation, room selection, and commissioning.
- Real-world Example: Implement a SwiftUI HomeStore that shares a single HMHomeManager, displays rooms and accessories, enables characteristic writes with metadata checks, and uses a Matter extension to validate and persist commissioned devices.
Quick Start
Add HomeKit capability, implement a single shared HMHomeManager with its delegate, and call the system pairing UI or MatterAddDeviceRequest to add accessories and commission devices.