2026/10/27 17:43:29
本地日志
适用于 Whiteboard iOS SDK 2.16.147。
iOS 已内嵌日志运行时,通过 Native 配置开启。
创建 SDK 前开启
Objective-C
WhiteLocalLogOptions *logs = [WhiteLocalLogOptions new];
logs.enabled = @YES; logs.enabledUpload = @YES;
config.localLogOptions = logs;
状态与按需上报
Objective-C
[sdk getLocalLogStateWithCompletionHandler:^(NSDictionary *result, NSError *error) {
NSLog(@"%@ %@", result, error);
}];
[sdk uploadLocalLogsWithCompletionHandler:^(NSDictionary *result, NSError *error) {
NSLog(@"%@ %@", result, error);
}];
状态查询用于确认运行时是否可用;配置 enabled=true 仍需结合状态确认,不能只据配置判断落盘成功。collectLocalLogsWithCompletionHandler: 收集导出结果,不等价于上传;flushLocalLogsWithCompletionHandler: 等待缓冲写入;uploadLocalLogsWithCompletionHandler: 触发上传,需要等待结果并处理失败。enabledUpload=false 时可以保留本地写入而关闭上传。
Objective-C
// 在创建 WhiteSDK 时传入的 WhiteCommonCallbackDelegate 中实现:
- (void)localLogStateChange:(NSDictionary *)state {
NSLog(@"%@", state);
}
建议在错误反馈流程中按需收集/上传,记录结果并限制重复触发。自定义上传参数和返回字段以客户端 /api-ref/whiteboard/ios/overview为准;不要把不同平台的回调对象当作相同模型解析。
iOS 12 及以下版本会强制关闭本地日志写入与上传,以规避 WKWebView Worker IndexedDB 的兼容问题;应读取状态确认可用性。