HomeExtensions
Add custom UI to the Home app, to configure and control accessories.
Overview
Use the Home Extensions framework to make accessories that you manufacture available in the Home app for people to set up, control, and configure. You can provide accessory settings, create custom SwiftUI views for configuration, and offer supporting content.
To use this framework, add a new target in Xcode by selecting File > New > Target, and then choose Home Extension. If you’re configuring your project manually, do the following:
Add the com.apple.developer.home entitlement to your app extension.
Add the
EXAppExtensionAttributeskey in the Info pane in Xcode for your app extension. Its value is a dictionary withEXExtensionPointIdentifieras a key andcom.apple.Home.HomeExtensionas a value.Add the
NSHomeExtensionManufacturerkey in the Info pane in Xcode for your app. Its value is a string containing the accessory manufacturer’s name.
Topics
Essentials
Displaying accessory configuration
HomeAccessorySettingsProviderHomeAccessorySettingsContainerAnyHomeAccessorySettingsContainerHomeAccessorySettingsContextHomeAccessorySettingsHomeAccessoryConfiguration
Defining accessory settings
HomeAccessorySettingHomeAccessorySettingLabelHomeAccessoryEnumSettingHomeAccessoryEnumSettingConstantHomeAccessoryInformationSettingHomeAccessoryRangeSettingHomeAccessoryRangeSettingDescriptorHomeAccessoryTextFieldSettingHomeAccessoryToggleSetting