快速集成

本文介绍如何将涂鸦 iOS 版 智慧行业 App SDK 集成到您的开发环境中，例如 Xcode，并介绍如何初始化和如何启用调试模式。之后，您可以尝试运行 Demo，快速上手行业 App SDK 开发。

前提条件

• 开始操作前，确保您已经完成账号注册和 SDK 下载。详情请参考 准备工作。
• 安装以下软件：
  • Xcode 14.0 或更高版本。
  • CocoaPods 1.10.0 或更高版本。
• 您的项目必须面向 iOS 10.0 或更高版本。

集成 SDK

涂鸦为每个 App 提供唯一的安全 SDK，本文介绍如何使用 CocoaPods 为您的项目集成 2.2.0 SDK。

步骤 1：获取重要文件信息

在 SDK 开发 页面，单击目标 SDK，显示 获取 SDK 页签。

下载并解压 ios_core_sdk.tar.gz 后，您将得到以下三个重要文件信息：

• Build：存放您的 App 专属安全 SDK。它和 App 密钥信息一样重要，请妥善保管，谨防资源泄漏或对外公开。
• ThingSmartCryption.podspec：用于引用、集成使用 2.2.0 SDK。
• domain.txt：请求使用的域名，包含六大数据中心。

建议 Build 和 ThingSmartCryption.podspec 这两个文件与 podfile 保持同级存放，便于后续引用操作。

步骤 2：更新 podfile

在 podfile 中声明如下信息:

    # 从 platform.tuya.com 构建和获取 ThingSmartCryption
    # 购买正式版后，需重新在开发者平台构建 SDK 并重新集成
    # ./ 表示将 'ios_core_sdk.tar.gz' 解压之后所在目录与 podfile 同级
    # 若自定义存放目录，可以修改 path 为自定义目录层级

    pod 'ThingSmartCryption', :path => './'

如果您从开发者平台下载了 podfile 文件，该文件已为您声明您选择的功能 SDK。您可以在 podfile 文件中，快速获取其他功能 SDK 的引用声明。

步骤 3：集成 SDK

执行 $ pod update 命令，将会自动集成下载的 SDK 到 iOS 工程项目中。

步骤 4：应用配置信息

App 包名

打开 Xcode 项目设置，选择 Target > General，修改 Bundle Identifier 为 涂鸦开发者平台 对应的 iOS 包名。

秘钥信息

在 SDK 开发 页面，单击目标 SDK，并单击 获取密钥 页签。

云项目概况

用户登录时需要 projectCode 信息。在 云开发 页面，单击目标云项目 操作 栏的 进入项目，可看到类似于下图的 概况 页面。

App 授权信息

SDK 初始化时，需要的 Client ID 和 Client Secret 信息。

1. 在 云开发 页面，单击目标云项目 操作 栏的 进入项目。

2. 选择 授权 > App 授权。

   

步骤 5：初始化 SDK

Objective-C

// init url
[IndustryLinkSDK setHost:<#your_app_host#>];

// IndustryLinkSDK
[IndustryLinkSDK initializeWithAppKey:<#your_app_key#>
                            appSecret:<#your_app_secret_key#>
                             clientId:<#your_clientId#>
                         clientSecret:<#your_client_secret#>];

[MQTTBusinessPlugin initializePlugin];

Swift

// init url
IndustryLinkSDK.host = <#your_app_host#>

// IndustryLinkSDK
IndustryLinkSDK.initialize(withAppKey: <#your_app_key#>,
                            appSecret: <#your_app_secret_key#>,
                            clientId: <#your_clientId#>,
                            clientSecret: <#your_client_secret#>)

// If need mqtt
MQTTBusinessPlugin.initializePlugin()

请求的 Host 和云项目的数据中心保持一致，不同数据中心的数据是互相隔离的。

• AY：中国数据中心
• EU：中欧数据中心
• AZ：美西数据中心
• WE：西欧数据中心
• UE：美东数据中心
• IN：印度数据中心

注意事项

开发版 SDK 仅供开发使用，请勿直接商用。如需上架商用，请前往平台购买正式版。

购买正式版 SDK 后

1. 需在涂鸦开发者平台上，重新构建和下载正式版 SDK。
2. 在项目中重新集成正式版 SDK。

更多信息，访问 《涂鸦开发服务协议》。