Matter Vertical Category SDK Integration
1. Overview
This document mainly introduces how to integrate the Matter Vertical Category SDK.
2. Prerequisites
- Confirm completion of Preparation
- Confirm completion of Environment Build
3. Features
3.1 Core Functions
- Supports Aqara Matter hub network configuration
- Supports Aqara Matter hub device control
- Supports Matter sub-device network configuration
- Supports Matter sub-device control
PS: Currently, Matter sub-devices cannot be directly configured and connected through the SDK. They must be connected via an Aqara Matter hub (using Aqara's private Magic Pair protocol) before device configuration and control can be performed.
3.2 SDK Size
| Dependency | Description | Size |
|---|---|---|
| React Native (0.63.4) | React Native framework | 10MB |
| Aqara bridge layer | Required components for SDK operation | 24MB |
| Others | Other components required for SDK operation | 14MB |
| Total | - | 48MB |
Note: 48MB represents the maximum incremental size of SDK integration, which occurs when there is no overlap between the third-party app’s dependencies and those of the SDK. In most cases, it will be smaller.
3.3 Compatibility Information
The Matter SDK requires the latest compilation tools and environment. The following are the necessary requirements:
Supported Android Versions
| Parameter | Version | Description |
|---|---|---|
| minSdkVersion | 26 | Android 8 |
| targetSdkVersion | 36 | Android 16 |
| compileSdk | 36 | Android 16 |
Build Tools & Environment
| Parameter | Minimum Version Requirement | Description |
|---|---|---|
| Android Studio Version | 2024.3.1 | Optional |
| Android Gradle Plugin Version | 8.7 | Optional |
| Gradle Version | 8.9 | Required |
| JDK Version | 17 | Required |
| NDK Version | 27.0.12077973 | Optional |
| Kotlin Version | 2.1.0 | Required |
| SDK Build Tools | 34.0.0 | Required |
Note: If these conditions are not met, the demo or SDK may not function properly.
3.3.1 New Project Creation
If you are starting a new project, create a new one using the latest version of Android Studio (2024.3.1) that meets the requirements above.
3.3.2 Upgrading an Existing Project
If you are upgrading an existing project, updating Kotlin to version 2.0 may affect your code or business logic. Below are some official reference documents:
Appendix 1: Google Official Docs - Android Studio & AGP Version Compatibility
Appendix 2: Google Official Docs - AGP Upgrade Guide
Appendix 3: Google Official Docs - Kotlin Upgrade Guide
Appendix 4: Gradle Official Docs - Gradle and Kotlin Version Compatibility
4. Integration
4.1 Integrate Matter SDK
4.1.1 Edit build.gradle in the app Directory
Get the latest version: The Latest Version of the SDK
dependencies {
implementation 'com.lumi.external:core:2.2.62'
implementation 'com.lumi.commonui:ui:1.5.33'
// Pairing SDK (With 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'
// Device control
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 Initialization
4.3.1 Unified Initialization
See Environment Build - Unified Initialization
5. Code Obfuscation
-dontwarn com.facebook.**
-keep class com.facebook.** { *; }