homekitlisted
Install: claude install-skill thienqo/ios-skills
# HomeKit
Control home automation accessories and commission Matter devices into an app ecosystem. HomeKit manages the home/room/accessory hierarchy, characteristics, and automation triggers; MatterSupport handles ecosystem device commissioning.
## Contents
- [Setup & Framework Boundaries](#setup--framework-boundaries)
- [HomeKit Data Model](#homekit-data-model)
- [Accessories & Characteristics](#accessories--characteristics)
- [Action Sets & Triggers](#action-sets--triggers)
- [Matter Device Commissioning](#matter-device-commissioning)
- [iOS 27 Updates](#ios-27-updates)
- [Common Mistakes](#common-mistakes)
- [Review Checklist](#review-checklist)
- [References](#references)
## Setup & Framework Boundaries
### Entitlements & Info.plist
1. Enable the **HomeKit** capability in Xcode.
2. Add `NSHomeKitUsageDescription` to Info.plist.
3. For MatterSupport commissioning: add a MatterSupport Extension target, declare Bonjour services (`_matter._tcp`, `_matterc._udp`, `_matterd._udp`), and set the extension's principal class to `MatterAddDeviceExtensionRequestHandler`.
### Boundary Division
- **HomeKit**: Homes, rooms, accessory control, characteristics, scenes, triggers.
- **MatterSupport**: Commissioning Matter hardware into a third-party ecosystem.
- **AccessorySetupKit**: Selecting/pairing nearby Bluetooth/Wi-Fi devices without broad permissions.
- **CoreBluetooth / NetworkExtension**: Raw data transport after device authorization.
## HomeKit Data Model
HomeKit loads as