SDK 支持业务主动调用上报接口,上传自定义日志、文件等信息。该功能可用于用户反馈、异常发生等场景及时上报本地日志信息,帮助保留问题现场。
下发指令

TDOS_DiagnoseSDK 会默认在启动/进入前台等时机时,以一定的时间间隔主动检查有无日志捞取命令。对于有日志命令的设备,会进行对应日志的上报任务。
主动上报
由于主动上报是程序自动触发,其频率与时机存在不可控性。为了保障上报安全,避免 App 异常情况下高频上报,导致浪费流量等问题,TDOS_Diagnose SDK 对主动上报提供了如下4种安全机制:
大小限制机制:限制压缩前的总文件大小(默认500M),超过上限则只保留修改时间较新的部分文件。
频率限制机制:支持设置主动上传的频率,如10分钟内3次(SDK 默认不开启)。设置接口参见 TDLogSDKConfig。
流量限制机制:支持设置每24小时的总上报流量与 XG 流量(SDK 默认不开启),超过额度将禁止上报。设置接口参见 TDLogSDKConfig。
错误熔断机制:连续上传失败10次后,将停用自动上报6h。(此机制为 SDK 内部安全兜底机制,暂不支持调整)。
该功能可用于用户反馈、异常发生等场景及时上报本地日志信息,帮助保留问题现场。接口说明如下:
/// 主动上报日志/// @param files 日志文件列表/// @param tag 标签,必填,最大长度64bytes/// @param summary 摘要信息(支持搜索),最大长度256bytes/// @param extendInfoDict 扩展信息,最大长度1K/// @param completionBlock 上传结果回调- (void)uploadFiles:(nonnull NSArray <NSString *> *)fileswithTag:(NSString *)tagsummary:(nullable NSString *)summaryandExtendInfo:(nullable NSDictionary *)extendInfoDictcompletion:(void (^)(BOOL result, NSString *_Nullable errMsg))completionBlock;

注意:
请合理指定上报内容或时间范围,避免主动上报日志过大或调用过于频繁。