看板卡片类SDK集成

修改历史

一、概述

本文主要介绍如何集成看板卡片类SDK，并结合宿主工程快速接入家庭首页、房间布局和卡片渲染能力。

二、前提条件

1. 确认完成准备工作
2. 确认完成环境搭建

三、功能特性

3.1 主体功能

看板卡片类SDK提供Aqara风格的UI组件，支持第三方App直接调用，实现如下能力：

1. 家庭、房间、设备卡片列表与布局能力
2. 场景、服务入口等聚合展示能力
3. 多语言、换肤等UI扩展能力
4. 通过ARouter与宿主现有路由体系联动

3.2 SDK大小

注意：48MB为集成SDK的最大增量，即宿主依赖与SDK依赖完全无交集时的预估值，实际通常会小于该值。

3.3 支持能力范围

详情查看看板卡片清单

四、集成

4.1 打开 Android Studio 项目

使用 Android Studio 打开需要接入SDK的工程。

4.2 编辑 app 目录下 build.gradle

dependencies {
    implementation "com.lumi.external:core:2.2.3"

    // 家庭配置 SDK
    implementation "com.lumi.module.homeconfiguration:home:6.0.60"

    // 家庭卡片 SDK（配套卡片渲染能力）
    implementation "com.lumi.module.homecard:card:6.0.60"

    // 家庭位置 SDK（支持切换家庭）
    implementation "com.lumi.module.position:position:3.1.40"
}

4.3 初始化

参见环境搭建-统一初始化，并确保：

1. external core 等基础库已完成初始化
2. ARouter、账号、多语言等依赖能力已启动
3. 业务登录及设备数据准备完毕

五、代码混淆

# 如项目未统一配置 ARouter，可参考以下规则
-keep class com.alibaba.android.arouter.routes.** { *; }
-keep interface com.alibaba.android.arouter.facade.template.IProvider
-keep class * implements com.alibaba.android.arouter.facade.template.IProvider { *; }
-keep class * implements com.alibaba.android.arouter.facade.template.ISyringe { *; }

若项目已有统一混淆配置，仅需补充看板卡片相关SDK规则即可。