简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

快速集成

更新时间:2022-03-17 05:53:54下载pdf

本文介绍如何将涂鸦安卓版 行业 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();
    }
}
  • 在 debug 模式下,您可以开启 SDK 的日志开关,查看更多的日志信息,帮助您快速定位问题。
  • 在 release 模式下,建议关闭日志开关。

运行 Demo App

在完成集成 SDK 后,您将 获取到 SDK 使用的 AppId、 AppSecret、ApplicationId。集成 SDK 时请确认 AppId、AppSecret、ApplicationId 是否与涂鸦 IoT 平台上的信息一致,任意一个不匹配会导致 SDK 无法使用。

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 里配置 signingConfigsstoreFile 字段用来指定 .jks 的存储位置。

    快速集成

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

    快速集成

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

    快速集成

  4. 运行 Demo。