快速集成

本文介绍如何将涂鸦安卓版 智能守护 App SDK 集成到您的开发环境中，例如 Android Studio，并介绍初始化方法以及如何启用调试模式。然后，您可以尝试运行 Demo，快速上手 App SDK 开发。

集成 SDK

• 开始操作前，请确保您已经完成 准备工作。
• 如果您还未安装 Android Studio，请访问 安卓官网 进行下载安装。

第一步：创建 Android 工程

在 Android Studio 中新建工程。

第二步：配置 build.gradle 文件

在安卓项目的 build.gradle 文件里，添加集成准备中下载的 dependencies 依赖库。

android {
	defaultConfig {
		ndk {
			abiFilters "armeabi-v7a", "arm64-v8a"
		}
	}
	packagingOptions {
		pickFirst 'lib/*/libc++_shared.so' // 多个 AAR（Android Library）文件中存在此 .so 文件，请选择第一个
	}
}
dependencies {
	implementation 'com.alibaba:fastjson:1.1.67.android'
	implementation 'com.squareup.okhttp3:okhttp-urlconnection:3.14.9'
    implementation "androidx.annotation:annotation:1.1.0"

	// App SDK 最新稳定安卓版：
	implementation 'com.tuya.smart:tuyasecurity-sdk:3.4.1'
}

在根目录的 build.gradle 文件中，增加涂鸦 Maven 仓库地址，进行仓库配置。

repositories {
	jcenter()
	google()
	// 涂鸦仓库地址
	maven {
		url "https://maven-other.tuya.com/repository/maven-releases/"
	}
}

第三步：集成安全图片和设置 Appkey 和 AppSecret

1. 在 涂鸦 IoT 开发平台，找到您创建的 SDK。

2. 在 获取密钥 中，点击 下载安全图片 > 安全图片下载 下载安全图片。

   
   Android 端需要设置 SHA256。详情请参考 如何获取 SHA256 密钥。

3. 将下载的安全图片命名为 t_s.bmp，放置到工程目录的 assets 文件夹下。

   

4. 返回安卓项目，在 AndroidManifest.xml 文件里配置 appkey 和 appSecret，在配置相应的权限等。

   <meta-data
   android:name="TUYA_SMART_APPKEY"
   android:value="应用 Appkey" />
   <meta-data
   android:name="TUYA_SMART_SECRET"
   android:value="应用密钥 AppSecret" />
   

第四步：混淆配置

在 proguard-rules.pro 文件配置相应混淆配置。

#fastJson
-keep class com.alibaba.fastjson.**{*;}
-dontwarn com.alibaba.fastjson.**

#mqtt
-keep class com.tuya.smart.mqttclient.mqttv3.** { *; }
-dontwarn com.tuya.smart.mqttclient.mqttv3.**

#OkHttp3
-keep class okhttp3.** { *; }
-keep interface okhttp3.** { *; }
-dontwarn okhttp3.**

-keep class okio.** { *; }
-dontwarn okio.**

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

第五步：初始化 SDK

您需要在 Application 的主线程中初始化 SDK，确保所有进程都能初始化。示例代码如下：

public class TuyaSmartApp extends Application {
	@Override
	public void onCreate() {
		super.onCreate();
		TuyaHomeSdk.init(this);
	}
}

TuyaHomeSdk.init(Application application, String appkey, String appSerect)

第六步：注销云连接

在退出应用的时候，调用以下接口可以注销云连接。

TuyaHomeSdk.onDestroy();

第七步：开启或关闭日志

• 在 debug 模式下，您可以开启 SDK 的日志开关，查看更多的日志信息，帮助您快速定位问题。

• 在 release 模式下，建议关闭日志开关。

  TuyaHomeSdk.setDebugMode(true);
  

Demo App

Demo App 演示 App SDK 的开发流程。在开发 App 之前，建议您先按照以下流程完成 Demo App 的操作。

Demo App 介绍

Demo App 主要包括：

• 用户管理：使用手机号或者邮箱进行登录和注册。

• 家庭管理和设备管理：

  • 创建家庭，切换用户所属的当前家庭。
  • 展现家庭中设备列表，控制设备功能点。
  • 设备重命名和设备移除。

• 设备配网：包括 Wi-Fi 快连配网模式、热点配网模式、有线网关配网、网关子设备配网、蓝牙配网、Mesh 子设备配网。

• 安防模块：包括服务码管理、撤布防管理、报警管理、安防设置、安防消息。

  

更多详情，请参考 tuya-security-android-sdk-sample。

运行 Demo

1. 替换 app 目录下 build.gradle 文件中的 applicationId 为您的应用包名。

   

2. 确认您已经完成 第三步：集成安全图片和设置 Appkey 和 AppSecret。

3. 点击 运行，运行 Demo。