integrating-tuya-android-device-control-ui

概述 {#description}

在已接入 Tuya Smart App SDK 的 Android Kotlin 工程中，集成设备控制 UI 业务包（RN 面板方案），实现一键跳转设备/群组控制面板，无需自行开发面板 UI。

前置条件：已完成 integrating-tuya-android-sdk 和 integrating-tuya-android-bizbundle-framework（BizBundleInitializer 已初始化、主题已配置）。

适用场景 {#scene}

已完成 BizBundle 框架层初始化，需要为 App 设备列表中的设备添加面板跳转能力时使用。

步骤：

1. 添加 Gradle 依赖：在 app/build.gradle.kts 中加入必选依赖 + 按需加入可选依赖。thingsmart-bizbundle-basekit 需要 exclude group: "com.thingclips.smart", module: "thingplugin-annotation"。参考 references/device-control-ui.md。

2. 配置 packaging 冲突处理：除 libc++_shared.so 外，还需 pickFirst 多个 so 文件（libv8android.so、libbytehook.so 等）。完整列表见 references/device-control-ui.md。

3. 配置混淆规则：将 RN、高德/谷歌地图、ThingClips 的 keep 规则追加到 app/proguard-rules.pro。完整规则见 references/device-control-ui.md。

4. 实现 BizBundleFamilyServiceImpl（必须）：继承 AbsBizBundleFamilyService，实现 getCurrentHomeId() 和 shiftCurrentFamily()。打开面板前必须先调用 shiftCurrentFamily(homeId, homeName) 绑定当前家庭。