integrating-tuya-android-device-activator-ui
概述 {#description}
在已接入 Tuya Smart App SDK 的 Android Kotlin 工程中，集成设备配网 UI 业务包，提供自动发现配网、手动配网（Wi-Fi/蓝牙/Zigbee/Matter）、扫码配网等功能，用户通过统一入口即可完成各类设备的网络配置。
前置条件：已完成 integrating-tuya-android-sdk 和 integrating-tuya-android-bizbundle-framework（BizBundleInitializer 已初始化、主题已配置、家庭服务已注册）。
适用场景 {#scene}
已完成 BizBundle 框架层初始化，用户已登录且有至少一个家庭，需要为 App 添加设备配网入口时使用。
步骤：
-
添加 Gradle 依赖（Kotlin DSL）：在
app/build.gradle.kts的 dependencies 块中加入thingsmart-bizbundle-device_activator（必选）和thingsmart-bizbundle-qrcode_mlkit（强烈建议）。版本由已有的thingsmart-BizBundlesBom统一管理，无需手动指定。 -
配置混淆规则（如尚未配置）：检查
app/proguard-rules.pro是否已包含 FastJSON、RxJava、Fresco、ThingClips 的 keep 规则。完整规则见references/device-activator-ui.md。 -
（可选）自定义配网行为：热点 SSID 前缀通过
res/values/strings.xml的ap_mode_ssid配置；蓝牙/扫码开关通过res/values/bools.xml配置；自动发现搜索通过assets/activator_auto_search_capacity.json配置。详见references/device-activator-ui.md。 -
注册配网监听器：在首页或 Application 中注册
ThingDeviceActivatorManager.addListener，处理配网成功、房间更新、跳转面板等回调。