快速集成

本主题介绍如何使用 CocoaPods 将智慧居住 iOS App SDK 快速集成到您的项目中。智慧居住 SDK 要求 iOS 版本不低于 10.0。

集成 SDK

使用 CocoaPods 快速集成

CocoaPods 建议更新至最新版本，然后在 Podfile 文件中添加以下内容：

platform :ios, '10.0'

target 'Your_Project_Name' do
	pod 'TuyaSmartResidenceKit'
end

然后在项目根目录下执行 pod update 命令进行集成。

CocoaPods 的使用请参考 CocoaPods 官方文档。

初始化 SDK

1. 打开项目设置，Target > General，修改 Bundle Identifier 为涂鸦 IoT 平台对应的 iOS 包名。

2. 导入安全图片到工程根目录，重命名为 t_s.bmp，并加入 项目设置 > Target > Build Phases > Copy Bundle Resources 中。
   
   

3. 在项目的 PrefixHeader.pch 文件添加以下内容。

   #import <TuyaSmartResidenceKit/TuyaSmartResidenceKit.h>
   

   Swift 项目可以在 xxx_Bridging-Header.h 桥接文件中添加以下内容。

   #import <TuyaSmartResidenceKit/TuyaSmartResidenceKit.h>
   

4. 打开 AppDelegate.m 文件，在 [AppDelegate application:didFinishLaunchingWithOptions:] 方法中初始化 SDK：

配置 SDK

- (void)startWithAppKey:(NSString *)appKey secretKey:(NSString *)secretKey;

参数说明

参数	说明
appKey	App key
secretKey	App 密钥 key

实例代码

Objc:

[[TuyaSmartSDK sharedInstance] startWithAppKey:<#your_app_key#> secretKey:<#your_secret_key#>];

Swift:

 TuyaSmartSDK.sharedInstance()?.start(withAppKey: <#your_app_key#>, secretKey: <#your_secret_key#>)

至此，准备工作已经全部完毕。

打开 Debug 模式

在开发的过程中可以开启 Debug 模式，打印一些日志用于分析问题。

Objc:

#ifdef DEBUG
    [[TuyaSmartSDK sharedInstance] setDebugMode:YES];
#else
#endif

Swift:

#if DEBUG
   TuyaSmartSDK.sharedInstance()?.debugMode = true
#else
#endif

语言设置

接口返回的错误信息与文案等，将会根据您工程所支持的多语言和用户手机的当前语言来显示。

如果想要支持某种语言，可以在工程中的 Localization 中添加你想要支持的语言。

演示工程主要介绍了 SDK 开发流程，以及一些简单的业务逻辑。在开发 App 之前，建议先按照本文完成演示工程的操作。

Demo app

准备 Demo

在 准备工作 阶段获取 iOS 的 AppKey、 AppSecret、安全图片。集成 SDK 时请确认 BundleId、AppKey、AppSecret、安全图片是否与平台上的信息一致，任意一个不匹配会导致 SDK 无法使用。

Demo 概述

演示工程提供了 Objective-C 的版本，请访问 Objective-C 示例 获取演示工程。工程主要包括以下模块：

• 用户注册及登录
• 空间管理
• 通行管理
• 设备管理
• 场景自动化

Demo 示意图：

运行 Demo

1. 确认您已经完成了 SDK 的初始化。
2. 进入 demo 目录，执行 pod update。

常见问题

• 问题现象：API 接口请求提示签名错误。

  {
  	"success" : false,
  	"errorCode" : "SING_VALIDATE_FALED",
  	"status" : "error",
  	"errorMsg" : "Permission Verification Failed",
  	"t" : 1583208740059
  }
  

• 解决办法：确认 BundleId、AppKey、AppSecret、安全图片是否与 涂鸦 IoT 平台 上的信息一致，任意一个不匹配都将校验失败。具体请按照 准备工作 章节来进行检查。