Matter垂直品类SDK集成

一、概述

本文主要介绍如何集成Matter垂直品类SDK

二、前提条件

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

三、功能特性

3.1 主体功能

1. 支持Aqara Matter中枢配网
2. 支持Aqara Matter中枢设备控制
3. 支持Matter子设备配网
4. 支持Matter子设备控制

PS：当前Matter子设备无法直接通过SDK配网接入，需要借助Aqara Matter中枢（使用Aqara私有协议Magic Pair配网）进行接入后，才可以进行设备配网与控制

3.2 SDK大小

注意：48MB为集成SDK最大增量，即第三方App的依赖和SDK的第三方依赖毫无交集时。通常情况下，会小于该值。

3.3 兼容性信息

Matter SDK需要最新版本的编译工具及编译环境，以下是您必须满足的条件：

支持的Android版本

编译工具&环境

注意：不满足条件，Demo或者SDK无法正常工作。

3.3.1 新项目创建

如果您是新项目，可按照上述要求，下载最新版本的Android Studio（2024.3.1）创建新项目即可。

3.3.2 老项目升级

如果您是老项目，升级Kotlin版本至2.0后，可能会对您的代码或者业务产生影响。以下是一些可供参考的官方文档：

附录1: Google官方文档-Android Studio与AGP的版本关系

附录2: Google官方文档-AGP升级指引

附录3: Google官方文档-Kotlin升级指引

附录4: Gradle官方文档-Gradle版本与Kotlin版本的对应关系

四、集成

4.1 集成Matter SDK

4.1.1 编辑app目录下build.gradle

获取最新版本：SDK最新版本

dependencies {
    implementation 'com.lumi.external:core:2.2.62'
    implementation 'com.lumi.commonui:ui:1.5.33'

    // 配网 SDK（含 UI）
    implementation 'com.lumi.module.access:access:3.5.82'
    implementation 'com.lumi.module.smart_connect:connect:4.0.37'
    implementation 'com.lumi.module:scanQR:1.0.14'
    implementation 'com.lumi.module:devicekit:1.0.23'
    implementation 'com.lumi.api:thread:1.0.21'

    //设备控制
    implementation 'com.lumi.sdk:reactnative:8.1.2'
    implementation 'com.lumi.sdk:rmextra:2.0.10'
    implementation 'com.lumi.sdk:device-router:1.0.10'
    implementation 'com.lumi.sdk:module-setting:2.0.35'
}

4.3 初始化

4.3.1 统一初始化

参见环境搭建-统一初始化

五、代码混淆

-dontwarn com.facebook.**
-keep class com.facebook.** { *; }