integrating-tuya-ios-device-activator-ui

概述 {#description}

在已接入 Tuya Smart App SDK 的 iOS ObjC 工程中，集成设备配网 UI 业务包，提供自动发现配网、手动配网（Wi-Fi/蓝牙/Zigbee/Matter）、扫码配网等功能，用户通过统一入口即可完成各类设备的网络配置。

前置条件：已完成 integrating-tuya-ios-sdk 和 integrating-tuya-ios-bizbundle-framework（ThingSmartBizCore 已初始化、updateConfig 已在登录后调用）。

适用场景 {#scene}

已完成 BizBundle 框架层初始化，用户已登录且有至少一个家庭，需要为 App 添加设备配网入口时使用。

步骤：

1. 添加 Podfile 依赖：加入 ThingSmartActivatorBizBundle（必选），按需加入蓝牙/Matter 扩展。详见 references/device-activator-ui.md。

2. 配置 Info.plist 权限：配网需要定位、相机权限；蓝牙配网需蓝牙权限；Matter 配网需额外 Bonjour 配置。详见 references/device-activator-ui.md。

3. 更新 thing_custom_config.json：在 config 节点中加入 needBle、needQRCode、is_matter_support、activator_auto_serach_capacity 等字段。详见 references/device-activator-ui.md。

4. 注册 ThingSmartHomeDataProtocol 服务（必须）：实现 getCurrentHome 返回当前 ThingSmartHome 实例，必须在打开配网页面之前注册。详见 references/device-activator-ui.md。