常见问题

各类版本问题

1. Xcode 11 为什么找不到 Application Loader？

从 Xcode 11 开始，不再内置 Application Loader。苹果官方推出了一个新的 ipa 上传工具，您可以直接在 Mac 应用商店搜 Transporter 进行 ipa 上传。

2. 执行 pod install 为什么会报错?

请确认 CocoaPods 是 1.3.0 及以上版本，执行 pod --version 命令可查看版本。

3. 执行 pod install 时，为什么提示 CDN: trunk Repo update failed / trunk URL couldn't be downloaded？

CocoaPods 1.8.0 版本默认使用 CDN Repo 源。详情请访问 CocoaPods。

如果您因为网络原因无法访问源，可以编辑 Podfile 修改为之前的 Master Repo：

- source 'https://cdn.cocoapods.org/'
+ source 'https://github.com/CocoaPods/Specs.git'

4. iOS 12 使用 [[ThingSmartActivator sharedInstance] currentWifiSSID] 为什么无法获取到 SSID？

在 Xcode 10 中，获取 Wi-Fi 信息需要开启相关权限。解决方法：Xcode > [Project Name] > Targets > [Target Name] > Capabilities > Access WiFi Information > ON。

5. iOS 13 版本有哪些 SDK 权限变化？

详情请参考 iOS 版本适配。

6. 为什么升级 SDK 至 2.8.0 及以上版本，SDK 初始化后发生 App 闪退？

SDK 2.8.0 版本之后加入了安全图片校验，并启用了新的 AppKey 和 AppSecret。如果发生了 App 闪退，并提示 Terminating app due to uncaught exception 'start sdk error', reason: 'security image not found'，请按照 准备工作 前往涂鸦开发者平台重新生成 SDK 初始化所需文件。

SDK 使用问题

1. 下发控制指令，设备为什么没有上报状态？

请确认设备功能的数据类型是否正确。例如，如果设备功能的数据类型是数值型（Value），那控制命令发送的应该是 @{@"2": @(25)} 而不是 @{@"2": @"25"}。

2. 如何开启调试模式，打印日志？

请在初始化 SDK 之后，调用以下代码：

[[ThingSmartSDK sharedInstance] setDebugMode:YES];

3. 基于 SDK 开发的 App，上传了推送证书，为什么收不到推送信息？

1. 确认 Xcode 的 Push Notification 是否打开。
2. 在 涂鸦开发者平台 上传 Push 证书。
3. 在 didFinishLaunchingWithOptions 方法中初始化 Push 方法。
4. 在 涂鸦开发者平台 的 营销推送 页面，新建 App 消息推送。

更多详情，请参考 集成 Push。

4. 为什么 SDK 获取本地语言为英文，而不是手机系统的语言？

因为 SDK 现在获取的本地语言是根据 [[NSBundle mainBundle] preferredLocalizations] 获取的，您需要在工程中创建多语言显示。

5. SDK 是否支持红外设备控制？

现在 SDK 不支持红外设备控制。

6. 为什么设备控制合并发送了多个设备功能（dps），却没有收到所有的设备功能响应？

设备控制发送多个功能时，您需要先判断设备功能是否有冲突。建议将没功能冲突的功能放在一起发送。例如照明的设备：

• 可以把灯的亮度、冷暖设备功能放在一起发送。
• 不可以把开关、亮度，冷暖 3 个设备功能放在一起，否则会存在有些设备功能执行没有响应的问题。

7. 如果没有蓝牙功能，是否可以不依赖 SDK 蓝牙模块，减少包大小？

可以的。此时只需要设备配网和控制功能，可以只依赖以下两个模块：

# 家庭管理，设备，房间，群组管理相关功能
pod 'ThingSmartDeviceKit',
# 设备配网相关功能
pod 'ThingSmartActivatorKit',

以下模块可以根据您的实际需要引用：

# 单点蓝牙相关功能
pod 'ThingSmartBLEKit',
# sigMesh 相关功能
pod 'ThingSmartBLEMeshKit',
# 智能场景相关功能
pod 'ThingSmartSceneKit',
# 设备和群组定时相关功能
pod 'ThingSmartTimerKit',
# 消息中心相关功能
pod 'ThingSmartMessageKit',
# 问题反馈相关功能
pod 'ThingSmartFeedbackKit',

SDK 运行报错

1. SDK 为什么集成错误，显示 Undefined symbols xxx？

一般是由于引用的 SDK 各个组件版本不一致导致。

请确认引用的每个库是否都是统一版本，即版本号的最高位和中位一致，例如 v3.12.1 和 v3.12.5 是统一的版本。如果不是，使用 pod update 进行更新后，重新编译即可。

2. 为什么调用 SDK 接口以后，会报 Error Domain=NSURLErrorDomain Code=-999 "已取消" 的错误？

请确认请求的对象是全局变量，否则会被提早释放，例如 self.feedBack = [[ThingSmartFeedback alloc] init];。

3. 为什么提示签名错误？

请确认 bundleId、appKey、appSecret、安全图片 是否与 涂鸦开发者平台 上的信息一致，任意一个不匹配都将校验失败。更多详情，请参考 准备工作。

4. Demo 编译为什么失败，提示 library not found for -XXX？

请确认您打开的工程为 .xcworkspace 而不是 .xcproject。

5. M1 芯片的电脑编译 iOS 为什么报错 Undefined symbols for architecture arm64？

报错示例：

Undefined symbols for architecture arm64:
"OBJC_CLASS$ThingAudioEngine", referenced from:
objc-class-ref in ThingSpeechKit(ThingSpeechVADetector.o)
"OBJC_CLASS$ThingSceneIntent", referenced from:
objc-class-ref in ThingSiriShortcutModule(ThingSceneShortcutManager.o)
"OBJC_CLASS$_DWKWebView", referenced from:
objc-class-ref in ThingHybridContainer(ThingHybridContainerVC.o)
ld: symbol(s) not found for architecture arm64.

解决方法：

1. 在 Podfile 文件里添加以下代码。

   post_install do |installer|
       installer.pods_project.build_configurations.each do |config|
           config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = "arm64"
       end
   end
   

2. 在 XCode 的 Build Settings > Excluded Architectures 路径下，增加 Any iOS Simulator SDK 选项，值为 arm64。

3. 重新执行 pod install。

家庭创建数量限制问题

家庭和房间创建数量如下表格。更多信息，可查看 功能及用量使用数量限制（上限）。

项目	描述	上限
家庭数量	单个 App 账号最多可以创建的家庭数量	20
家庭成员数量	单个家庭中最多可以添加的家庭成员的数量	20
房间数量	单个家庭最多可以创建的房间数量	20
房间设备数量	单个房间最多可以添加的设备数量	50
被邀请家庭数量	单个 App 账号最多可以被其他家庭邀请的数量	20

邀请码失效问题

通过邀请码添加成员，邀请码有效期只有三天。

开发者社区

如果本文未能解决您遇到的问题，您可以在 开发者社区 搜索相关问题。如果没有找到需要的结果，可以尝试在开发者社区发帖求助。