skills/developer.tuya.com/integrating-tuya-android-sdk

integrating-tuya-android-sdk

Installation
SKILL.md

概述 {#description}

按 Tuya 官方 Smart App SDK 集成页推进 Android 新工程接入。优先核对最新官方页面,再把示例从 Groovy DSL 改写成当前工程实际使用的 Kotlin DSL / Version Catalog 结构。

适用场景 {#scene}

新建 Android 工程需要接入涂鸦 SDK 时使用,或现有工程出现鉴权失败需要排查时使用。

集成步骤:

  1. 确认工程形态:检查 settings.gradle.ktsapp/build.gradle.ktsAndroidManifest.xml,确认是否已有 Application 子类。若启用了 RepositoriesMode.FAIL_ON_PROJECT_REPOS,只在 settings.gradle.kts 配仓库。

  2. 落地接入

    • 在仓库级配置里加入 Tuya Maven 源
    • app/build.gradle.kts 加入 abiFilterspackaging 冲突处理、AAR 目录依赖、thingsmart 依赖和模块排除
    • 把下载包里的 security-algorithm.aar 放到模块 libs/ 目录
    • AndroidManifest.xml<application> 下配置 THING_SMART_APPKEYTHING_SMART_SECRET
    • Application.onCreate() 主线程调用 ThingHomeSdk.init(this);只在 debug 构建开启 ThingHomeSdk.setDebugMode(true)
    • app/proguard-rules.pro 合并官方 keep 规则
Installs
11
First Seen
May 19, 2026
integrating-tuya-android-sdk from developer.tuya.com