快速集成

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

集成 SDK

• 开始操作前，请确保您已经完成账号注册和 App 授权。详情请参考 准备工作。
• 如果您还未安装 Android Studio，请访问 安卓官网 进行下载安装。

第一步：创建 Android 工程

1. 在 Android Studio 中新建工程。

2. 将密钥文件 key.jks 拷贝到工程的根目录下。

   key.jks 是在 准备工作 阶段生成的密钥文件。

第二步：配置 build.gradle 文件

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

   android {
   	defaultConfig {
   		ndk {
   			abiFilters "armeabi-v7a", "arm64-v8a"
   		}
   		packagingOptions {
   			pickFirst 'lib/*/libc++_shared.so' // 多个 aar 存在此 so，需要选择第一个
   		}
   	}
   
   	// 在准备工作中生成的 keyStore 文件，需要在此配置密钥信息
   	signingConfigs {
   		release {
   			storeFile file("../key.jks")
   			storePassword "xxxx"
   			keyAlias "xxxx"
   			keyPassword "xxxx"
   			v1SigningEnabled true
   			v2SigningEnabled true
   		}
   
   		debug {
   			storeFile file("../key.jks")
   			storePassword "xxxx"
   			keyAlias "xxxx"
   			keyPassword "xxxx"
   			v1SigningEnabled true
   			v2SigningEnabled true
   		}
   	}
   }
   
   dependencies {
   	implementation 'androidx.appcompat:appcompat:1.2.0'
   	implementation 'com.google.android.material:material:1.3.0'
   	implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
   
   	// 需要加入的依赖
   	implementation 'com.tencent:mmkv-static:1.2.7'
   	implementation 'com.squareup.okhttp3:okhttp-urlconnection:3.14.9'
   	implementation 'com.alibaba:fastjson:1.2.32'
   	implementation 'com.google.zxing:core:3.3.3'
   	implementation 'com.journeyapps:zxing-android-embedded:3.6.0'
   
   	// 行业 App SDK 最新稳定安卓版
   	implementation 'com.tuya.smart:iot-app-sdk:1.0.2'
   }
   

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

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

第三步：混淆配置

在 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.**

第四步：查询 AppId 和 AppSecret

1. 登录 IoT 平台。

2. 在 云开发 > 云开发 > 目标项目页面，选择 授权 > App 授权，可查看 AppId 和 AppSecret。

   

第五步：初始化SDK

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

public class BaseApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        // 需要替换下面的appId和appSecret
        TuyaIoTSDK.builder().init(this, "appId", "appSecret")
                .hostConfig(RegionHostConst.REGION_HOST_CN)
                // true开启了debug模式，默认是false
                .debug(true)
                .build();
    }
}

运行 Demo App

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

Demo 介绍

Demo App 提供了设备配网、登录注册、资产管理等基本功能的示例。Demo App 基于 涂鸦 Open API 的 Restful API 接口实现相关功能。行业 App SDK 是涂鸦 SaaS 开发框架产品的重要组成部分。更多详情，请参考 tuya-android-iot-app-sdk-sample GitHub 项目。

Demo App 实现了以下功能：

• 用户管理：账号登录、登出

• 资产管理：资产查询、选择

• 设备配网：Wi-Fi 热点配网、Wi-Fi 快连配网、有线配网、Zigbee 子设备配网、扫码配网、NB-IoT 扫码配网

• 设备管理：设备查询、设备解绑

  

运行 Demo

1. 根据 keyStore 文件中的信息，在工程的 build.gradle 里配置 signingConfigs，storeFile 字段用来指定 .jks 的存储位置。

   

2. 获取程序包名称。如下所示，您还可以自定义程序包名称，但包名称必须和 涂鸦 IoT 平台 上的配置保持一致。

   

3. Application 中，将 AppId 和 AppSecret 粘贴到代码对应位置，如下图所示。

   

4. 运行 Demo。