跳转至

macOS 应用接入


简介

观测云应用监测能够通过收集各个 macOS 应用的指标数据,以可视化的方式分析各个 macOS 应用端的性能。

前置条件

macOS 应用接入

登录观测云控制台,进入「用户访问监测」页面,点击左上角「新建应用」,即可开始创建一个新的应用。

1.输入「应用名称」、「应用ID」,选择 「自定义」 应用类型

  • 应用名称:用于识别当前用户访问监测的应用名称。
  • 应用 ID :应用在当前工作空间的唯一标识,对应字段:app_id 。该字段仅支持英文、数字、下划线输入,最多 48 个字符。

安装

源码地址https://github.com/GuanceCloud/datakit-macos

Demohttps://github.com/GuanceCloud/datakit-macos/Example

1.配置 Podfile 文件。

   target 'yourProjectName' do

   # Pods for your project
   pod 'FTMacOSSDK', '~>[latest_version]'

   end

2.在 Podfile 目录下执行 pod install 安装 SDK。

1.选中 PROJECT -> Package Dependency ,点击 Packages 栏目下的 +

2.在弹出的页面的搜索框中输入 https://github.com/GuanceCloud/datakit-macos,这是代码的存储位置。

3.Xcode 获取软件包成功后,会展示 SDK 的配置页。

Dependency Rule :建议选择 Up to Next Major Version

Add To Project :选择支持的工程。

填好配置后点击 Add Package 按钮,等待加载完成。

4.在弹窗 Choose Package Products for datakit-macos 中选择需要添加 SDK 的 Target,点击 Add Package 按钮,此时 SDK 已经添加成功。

如果您的项目由 SPM 管理,将 FTMacOSSDK 添加为依赖项,添加 dependenciesPackage.swift

  dependencies: [
    .package(url: "https://github.com/GuanceCloud/datakit-macos.git", .upToNextMajor(from: "[latest_version]"))
]

添加头文件

#import "FTMacOSSDK.h"
import FTMacOSSDK

SDK 初始化

基础配置

由于第一个显示的视图 NSViewControllerviewDidLoad 方法、 NSWindowControllerwindowDidLoad 方法调用要早于 AppDelegate applicationDidFinishLaunching,为避免第一个视图的生命周期采集异常,建议在 main.m 文件中进行 SDK 初始化。

// main.m 文件
#import "FTMacOSSDK.h"

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        // Setup code that might create autoreleased objects goes here.
        FTSDKConfig *config = [[FTSDKConfig alloc]initWithMetricsUrl:@"YOUR_ACCESS_SERVER_URL"];
        config.enableSDKDebugLog = YES;
        [FTSDKAgent startWithConfigOptions:config];
    }
    return NSApplicationMain(argc, argv);
}
字段 类型 说明 必须
metricsUrl NSString datakit 安装地址 URL 地址,例子:http://datakit.url:[port]。注意:安装 SDK 设备需能访问这地址
enableSDKDebugLog BOOL 设置是否允许打印日志 否(默认NO)
env NSString 环境,支持自定义,也可根据提供的 FTEnv 枚举通过 -setEnvWithType: 方法设置 否 (默认prod)
service NSString 设置所属业务或服务的名称,影响 Log 和 RUM 中 service 字段数据。默认:df_rum_macos
globalContext NSDictionary 添加自定义标签

env 环境

/// 环境字段。属性值:prod/gray/pre/common/local。
typedef NS_ENUM(NSInteger, FTEnv) {
    /// 线上环境
    FTEnvProd         = 0,
    /// 灰度环境
    FTEnvGray,
    /// 预发布环境
    FTEnvPre,
    /// 日常环境
    FTEnvCommon,
    /// 本地环境
    FTEnvLocal,
};

/// 根据提供的 FTEnv 类型设置 env
/// - Parameter envType: 环境
- (void)setEnvWithType:(FTEnv)envType;

RUM 配置

  //开启 rum
  FTRumConfig *rumConfig = [[FTRumConfig alloc]initWithAppid:appid];
  rumConfig.enableTrackAppCrash = YES;
  rumConfig.enableTrackAppANR = YES;
  rumConfig.enableTrackAppFreeze = YES;
  rumConfig.enableTraceUserAction = YES;
  rumConfig.enableTraceUserVIew = YES;
  rumConfig.enableTraceUserResource = YES;
  rumConfig.errorMonitorType = FTErrorMonitorAll;
  rumConfig.deviceMetricsMonitorType = FTDeviceMetricsMonitorAll;
  [[FTSDKAgent sharedInstance] startRumWithConfigOptions:rumConfig];
字段 类型 说明 必须
appid NSString 用户访问监测应用 ID 唯一标识,在用户访问监测控制台上面创建监控时自动生成。
sampleRate int 采样采集率 否(默认100)
enableTrackAppCrash BOOL 设置是否需要采集崩溃日志 否(默认NO)
enableTrackAppANR BOOL 采集ANR卡顿无响应事件 否(默认NO)
enableTrackAppFreeze BOOL 采集UI卡顿事件 否(默认NO)
enableTraceUserView BOOL 设置是否追踪用户 View 操作 否(默认NO)
enableTraceUserAction BOOL 设置是否追踪用户 Action 操作 否(默认NO)
enableTraceUserResource BOOL 设置是否追踪用户网络请求 (仅作用于 native http ) 否(默认NO)
errorMonitorType NS_OPTIONS 错误事件监控补充类型
monitorFrequency NS_OPTIONS 视图的性能监控采样周期
deviceMetricsMonitorType NS_OPTIONS 视图的性能监控类型
globalContext NSDictionary 添加自定义标签

监控数据配置

配置 FTRumConfigerrorMonitorType 属性,将在采集的崩溃数据中添加对应的信息。可采集的类型如下:

/// ERROR 中的设备信息
typedef NS_OPTIONS(NSUInteger, FTErrorMonitorType) {
    /// 开启所有监控: 电池、内存、CPU使用率
    FTErrorMonitorAll          = 0xFFFFFFFF,
    /// 电池电量
    FTErrorMonitorBattery      = 1 << 1,
    /// 内存总量、内存使用率
    FTErrorMonitorMemory       = 1 << 2,
    /// CPU使用率
    FTErrorMonitorCpu          = 1 << 3,
};

配置 FTRumConfigdeviceMetricsMonitorType 属性,将在采集的 View 数据中添加对应监控项信息,同时可配置 monitorFrequency 来设置监控采样周期。可采集的类型与采样周期如下:

/// 设备信息监控项
typedef NS_OPTIONS(NSUInteger, FTDeviceMetricsMonitorType){
    /// 开启所有监控项:内存、CPU
    FTDeviceMetricsMonitorAll      = 0xFFFFFFFF,
    /// 平均内存、最高内存
    FTDeviceMetricsMonitorMemory   = 1 << 2,
    /// CPU 跳动最大、平均数
    FTDeviceMetricsMonitorCpu      = 1 << 3,
};

/// 监控项采样周期
typedef NS_ENUM(NSUInteger, FTMonitorFrequency) {
    /// 500ms (默认)
    FTMonitorFrequencyDefault,
    /// 100ms
    FTMonitorFrequencyFrequent,
    /// 1000ms
    FTMonitorFrequencyRare,
};

Log 配置

  //开启 logger
  FTLoggerConfig *loggerConfig = [[FTLoggerConfig alloc]init];
  loggerConfig.enableCustomLog = YES;
  loggerConfig.enableLinkRumData = YES;
  loggerConfig.printCustomLogToConsole = YES;
  [[FTSDKAgent sharedInstance] startLoggerWithConfigOptions:loggerConfig];
字段 类型 说明 必须
sampleRate int 采样采集率 否(默认100)
enableCustomLog BOOL 是否上传自定义 log 否(默认NO)
logLevelFilter NSArray 设置要采集的自定义 log 的状态数组 否(默认全采集)
enableLinkRumData BOOL 是否与 RUM 数据关联 否(默认NO)
discardType FTLogCacheDiscard 设置日志废弃策略 否(默认丢弃最新数据)
printCustomLogToConsole BOOL 设置是否将自定义日志打印到控制台 否(默认NO)
globalContext NSDictionary 添加自定义标签

日志废弃策略

上传机制 : 日志数据采集后会存储到本地数据库中,等待时机进行上传。数据库存储日志数据的量限制在 5000 条,如果网络异常等原因导致数据堆积,存储 5000 条后,会根据您设置的废弃策略丢弃数据。

/// 日志废弃策略
typedef NS_ENUM(NSInteger, FTLogCacheDiscard)  {
    /// 默认,当日志数据数量大于最大值(5000)时,新数据不进行写入
    FTDiscard,
    /// 当日志数据大于最大值时,废弃旧数据
    FTDiscardOldest
};
/// 日志废弃策略
@property (nonatomic, assign) FTLogCacheDiscard  discardType;

Trace 配置

  //开启 trace
  FTTraceConfig *traceConfig = [[FTTraceConfig alloc]init];
  traceConfig.enableLinkRumData = YES;
  traceConfig.enableAutoTrace = YES;
  traceConfig.networkTraceType = FTNetworkTraceTypeDDtrace;
  [[FTSDKAgent sharedInstance] startTraceWithConfigOptions:traceConfig];
字段 类型 说明 必须
sampleRate int 采样采集率 否(默认100)
networkTraceType NS_ENUM 设置网络请求信息采集时 使用链路追踪类型,如果接入 OpenTelemetry 选择对应链路类型时,请注意查阅支持类型及 agent 相关配置 否(默认DDtrace)
enableLinkRumData BOOL 是否与 RUM 数据关联 否(默认NO)
enableAutoTrace BOOL 设置是否开启自动 http trace,目前只支持 NSURLSession 否(默认NO)

链路追踪类型

/// 网络链路追踪使用类型
typedef NS_ENUM(NSInteger, FTNetworkTraceType) {
    /// datadog trace
    FTNetworkTraceTypeDDtrace,
    /// zipkin multi header
    FTNetworkTraceTypeZipkinMultiHeader,
    /// zipkin single header
    FTNetworkTraceTypeZipkinSingleHeader,
    /// w3c traceparent
    FTNetworkTraceTypeTraceparent,
    /// skywalking 8.0+
    FTNetworkTraceTypeSkywalking,
    /// jaeger
    FTNetworkTraceTypeJaeger,
};

RUM 用户数据追踪

可以 FTRUMConfig 配置开启自动模式,或手动添加。Rum 相关数据,通过 FTGlobalRumManager 单例,进行传入,相关 API 如下:

View

若设置 enableTraceUserView= YES 开启自动采集 ,SDK 将自动采集 Window 的生命周期,以 window 的 becomeKeyWindow 为开始,记录进入页面, 以 resignKeyWindow 为结束,记录离开页面。页面名称根据 contentViewController > windowController > window 的优先顺序来设置,即若 window 的 contentViewController 存在,则页面名称为 contentViewController 的类名,如 contentViewController 不存在,则查看 windowController 是否存在,存在即为 windowController 的类名,反之则为 Window 的类名。

若想记录 window 内更为详细的 NSViewController 的生命周期,可以使用下面的 API 手动采集。

//进入页面时调用  duration 以纳秒为单位 示例中为 1s
[[FTGlobalRumManager sharedManager] onCreateView:@"TestVC" loadTime:@1000000000];

[[FTGlobalRumManager sharedManager] startViewWithName:@"TestVC"];

[[FTGlobalRumManager sharedManager] stopView];
/// 创建页面
///
/// 在 `-startViewWithName` 方法前调用,该方法用于记录页面的加载时间,如果无法获得加载时间该方法可以不调用。
/// - Parameters:
///   - viewName: 页面名称
///   - loadTime: 页面加载时间
-(void)onCreateView:(NSString *)viewName loadTime:(NSNumber *)loadTime;
/// 进入页面
///
/// - Parameters:
///   - viewName: 页面名称
-(void)startViewWithName:(NSString *)viewName;
/// 进入页面
/// - Parameters:
///   - viewName: 页面名称
///   - property: 事件自定义属性(可选)
-(void)startViewWithName:(NSString *)viewName property:(nullable NSDictionary *)property;
/// 离开页面
-(void)stopView;
/// 离开页面
/// - Parameter property: 事件自定义属性(可选)
-(void)stopViewWithProperty:(nullable NSDictionary *)property;

Action

[[FTGlobalRumManager sharedManager]  addActionName:@"UITableViewCell click" actionType:@"click"];
/// 添加 Action 事件
///
/// - Parameters:
///   - actionName: 事件名称
///   - actionType: 事件类型
- (void)addActionName:(NSString *)actionName actionType:(NSString *)actionType;
/// 添加 Action 事件
/// - Parameters:
///   - actionName: 事件名称
///   - actionType: 事件类型
///   - property: 事件自定义属性(可选)
- (void)addActionName:(NSString *)actionName actionType:(NSString *)actionType property:(nullable NSDictionary *)property;

Error

[[FTGlobalRumManager sharedManager] addErrorWithType:@"type" situation:RUN message:@"message" stack:@"stack"];
/// 添加 Error 事件
///
/// - Parameters:
///   - type: error 类型
///   - message: 错误信息
///   - stack: 堆栈信息
- (void)addErrorWithType:(NSString *)type message:(NSString *)message stack:(NSString *)stack;
/// 添加 Error 事件
/// - Parameters:
///   - type: error 类型
///   - message: 错误信息
///   - stack: 堆栈信息
///   - property: 事件自定义属性(可选)
- (void)addErrorWithType:(NSString *)type message:(NSString *)message stack:(NSString *)stack property:(nullable NSDictionary *)property;

LongTask

[[FTGlobalRumManager sharedManager] addLongTaskWithStack:@"堆栈信息 string" duration:@1000000000];
/// 添加 卡顿 事件
///
/// - Parameters:
///   - stack: 卡顿堆栈
///   - duration: 卡顿时长(纳秒)
- (void)addLongTaskWithStack:(NSString *)stack duration:(NSNumber *)duration;
/// 添加 卡顿 事件
/// - Parameters:
///   - stack: 卡顿堆栈
///   - duration: 卡顿时长(纳秒)
///   - property: 事件自定义属性(可选)
- (void)addLongTaskWithStack:(NSString *)stack duration:(NSNumber *)duration property:(nullable NSDictionary *)property;

Resource

#import "FTMacOSSDK.h"
#import "FTResourceContentModel.h"
#import "FTResourceMetricsModel.h"
//第一步:请求开始前
 [[FTGlobalRumManager sharedManager] startResourceWithKey:key];

 //第二步:请求完成
 [[FTGlobalRumManager sharedManager] stopResourceWithKey:key];

 //第三步:拼接 Resource 数据
 //FTResourceContentModel 数据
  FTResourceContentModel *content = [[FTResourceContentModel alloc]init];
  content.httpMethod = request.HTTPMethod;
  content.requestHeader = request.allHTTPHeaderFields;
  content.responseHeader = httpResponse.allHeaderFields;
  content.httpStatusCode = httpResponse.statusCode;
  content.responseBody = responseBody;
  //ios native
  content.error = error;

  //如果能获取到各阶段的时间数据 
  //FTResourceMetricsModel
  //ios native 获取到 NSURLSessionTaskMetrics 数据 直接使用 FTResourceMetricsModel 的初始化方法
  FTResourceMetricsModel *metricsModel = [[FTResourceMetricsModel alloc]initWithTaskMetrics:metrics];

  //其他平台 所有时间数据以纳秒为单位
  FTResourceMetricsModel *metricsModel = [[FTResourceMetricsModel alloc]init];
  [metricsModel setDnsStart:dstart end:dend];
  [metricsModel setTcpStart:tstart end:tend];
  [metricsModel setSslStart:sstart end:send];
  [metricsModel setTtfbStart:ttstart end:ttend];
  [metricsModel setTransStart:trstart end:trend];
  [metricsModel setFirstByteStart:fstart end:fend];
  [metricsModel setDurationStart:dstart end:dend];

 //第四步:add resource 如果没有时间数据 metrics 传 nil
 [[FTGlobalRumManager sharedManager] addResourceWithKey:key metrics:metricsModel content:content];
/// HTTP 请求开始
///
/// - Parameters:
///   - key: 请求标识
- (void)startResourceWithKey:(NSString *)key;
/// HTTP 请求开始
/// - Parameters:
///   - key: 请求标识
///   - property: 事件自定义属性(可选)
- (void)startResourceWithKey:(NSString *)key property:(nullable NSDictionary *)property;
/// HTTP 请求结束
///
/// - Parameters:
///   - key: 请求标识
- (void)stopResourceWithKey:(NSString *)key;
/// HTTP 请求结束
/// - Parameters:
///   - key: 请求标识
///   - property: 事件自定义属性(可选)
- (void)stopResourceWithKey:(NSString *)key property:(nullable NSDictionary *)property;
/// HTTP 请求数据
///
/// - Parameters:
///   - key: 请求标识
///   - metrics: 请求相关性能属性
///   - content: 请求相关数据
- (void)addResourceWithKey:(NSString *)key metrics:(nullable FTResourceMetricsModel *)metrics content:(FTResourceContentModel *)content;

Resource url 过滤

当开启自动采集后,内部会进行处理不采集 SDK 的数据上报地址。您也可以通过 Open API 设置过滤条件,采集您需要的网络地址。

[[FTSDKAgent sharedInstance] isIntakeUrl:^BOOL(NSURL * _Nonnull url) {
        // 您的采集判断逻辑
        return YES;//return NO; (YES 采集,NO 不采集)
 }];
//  FTSDKAgent.h
//  
/// 自动埋点功能中,过滤不需要进行采集的地址,一般用于排除非业务相关的一些请求
/// - Parameter handler: 判断是否采集回调,返回 YES 采集, NO 过滤掉
- (void)isIntakeUrl:(BOOL(^)(NSURL *url))handler;

Logger 日志打印

// 方法一:通过 FTSDKAgent
// 注意:需要保证在使用的时候 SDK 已经初始化成功,否则在测试环境会断言失败从而崩溃。
[[FTSDKAgent sharedInstance] logging:@"TestLoggingBackground" status:FTStatusInfo];

// 方法二:通过 FTLogger (推荐)
// SDK 如果没有初始化成功,调用 FTLogger 中方法添加自定义日志会失败,但不会有断言失败崩溃问题。
[[FTLogger sharedInstance] info:@"test" property:@{@"custom_key":@"custom_value"}];
//  FTSDKAgent.h
//  FTMacOSSDK
///事件等级和状态,默认:FTStatusInfo
typedef NS_ENUM(NSInteger, FTLogStatus) {
    /// 提示
    FTStatusInfo         = 0,
    /// 警告
    FTStatusWarning,
    /// 错误
    FTStatusError,
    /// 严重
    FTStatusCritical,
    /// 恢复
    FTStatusOk,
};
/// 日志上报
/// @param content 日志内容,可为json字符串
/// @param status  事件等级和状态
-(void)logging:(NSString *)content status:(FTLogStatus)status;

/// 日志上报
/// @param content 日志内容,可为json字符串
/// @param status  事件等级和状态
/// @param property 事件属性
-(void)logging:(NSString *)content status:(FTLogStatus)status property:(nullable NSDictionary *)property;
//
//  FTLogger.h
//  FTMacOSSDK

/// 添加 info 类型自定义日志
/// - Parameters:
///   - content: 日志内容
///   - property: 自定义属性(可选)
-(void)info:(NSString *)content property:(nullable NSDictionary *)property;
/// 添加 warning 类型自定义日志
/// - Parameters:
///   - content: 日志内容
///   - property: 自定义属性(可选)
-(void)warning:(NSString *)content property:(nullable NSDictionary *)property;
/// 添加 error 类型自定义日志
/// - Parameters:
///   - content: 日志内容
///   - property: 自定义属性(可选)
-(void)error:(NSString *)content  property:(nullable NSDictionary *)property;
/// 添加 critical 类型自定义日志
/// - Parameters:
///   - content: 日志内容
///   - property: 自定义属性(可选)
-(void)critical:(NSString *)content property:(nullable NSDictionary *)property;
/// 添加 ok 类型自定义日志
/// - Parameters:
///   - content: 日志内容
///   - property: 自定义属性(可选)
-(void)ok:(NSString *)content property:(nullable NSDictionary *)property;

设置 printCustomLogToConsole = YES ,开启将自定义日志输出到控制台,将会在 xcode 调试控制台看到以下格式的日志:

2023-06-29 13:47:56.960021+0800 App[64731:44595791] [MACOS APP] [INFO] content ,{K=V,...,Kn=Vn}

2023-06-29 13:47:56.960021+0800 App[64731:44595791]:os_log 日志输出的标准前缀;

[MACOS APP]:用来区分 SDK 输出自定义日志的前缀;

[INFO]:自定义日志的等级;

content:自定义日志内容。

{K=V,...,Kn=Vn}:自定义属性。

Trace 网络链接追踪

可以 FTTraceConfig 配置开启自动模式,或手动添加。Trace 相关数据,通过 FTTraceManager 单例,进行传入,相关 API 如下:

 NSString *key = [[NSUUID UUID]UUIDString];
    NSURL *url = [NSURL URLWithString:@"http://www.baidu.com"];
//需要的手动操作: 请求前获取 traceHeader 添加到请求头
    NSDictionary *traceHeader = [[FTTraceManager sharedInstance] getTraceHeaderWithKey:key url:url];
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
    if (traceHeader && traceHeader.allKeys.count>0) {
        [traceHeader enumerateKeysAndObjectsUsingBlock:^(id field, id value, BOOL * __unused stop) {
            [request setValue:value forHTTPHeaderField:field];
        }];
    }
    NSURLSession *session=[NSURLSession sessionWithConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration] delegate:self delegateQueue:[NSOperationQueue mainQueue]];

    NSURLSessionTask *task = [session dataTaskWithRequest:request completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
       //您的代码
    }];

    [task resume];
// FTTraceManager.h

/// 获取 trace 的请求头参数
/// - Parameters:
///   - key: 能够确定某一请求的唯一标识
///   - url: 请求 URL
/// - Returns: trace 的请求头参数字典
- (NSDictionary *)getTraceHeaderWithKey:(NSString *)key url:(NSURL *)url;

用户的绑定与注销

/// 绑定用户信息
///
/// - Parameters:
///   - Id:  用户Id
///   - userName: 用户名称
///   - userEmail: 用户邮箱
///   - extra: 用户的额外信息
[[FTSDKAgent sharedInstance] bindUserWithUserID:USERID];
//or
[[FTSDKAgent sharedInstance] bindUserWithUserID:USERID userName:USERNAME userEmail:USEREMAIL];
//or
[[FTSDKAgent sharedInstance] bindUserWithUserID:USERID userName:USERNAME userEmail:USEREMAIL extra:@{EXTRA_KEY:EXTRA_VALUE}];

///解绑用户
[[FTSDKAgent sharedInstance] unbindUser];

添加自定义标签

静态使用

可采用创建多 Configurations ,使用预编译指令进行设置值

  1. 创建多 Configurations :

  1. 设置预设属性来区分不同 Configurations:

  1. 使用预编译指令:
//Target -> Build Settings -> GCC_PREPROCESSOR_DEFINITIONS 进行配置预设定义
#if PRE
#define Track_id       @"0000000001"
#define STATIC_TAG     @"preprod"
#elif  DEVELOP
#define Track_id       @"0000000002"
#define STATIC_TAG     @"common"
#else
#define Track_id       @"0000000003"
#define STATIC_TAG     @"prod"
#endif

FTRumConfig *rumConfig = [[FTRumConfig alloc]init]; 
rumConfig.globalContext = @{@"track_id":Track_id,@"static_tag":STATIC_TAG};
... //其他设置操作
[[FTSDKAgent sharedInstance] startRumWithConfigOptions:rumConfig];

动态使用

因 RUM 启动后设置的 globalContext 不会生效,用户可自行本地保存,在下次应用启动时进行设置生效。

  1. 通过存文件本地保存,例如NSUserDefaults,配置使用 SDK,在配置处添加获取标签数据的代码。
NSString *dynamicTag = [[NSUserDefaults standardUserDefaults] valueForKey:@"DYNAMIC_TAG"]?:@"NO_VALUE";

FTRumConfig *rumConfig = [[FTRumConfig alloc]init];
rumConfig.globalContext = @{@"dynamic_tag":dynamicTag};
... //其他设置操作
[[FTSDKAgent sharedInstance] startRumWithConfigOptions:rumConfig];
  1. 在任意处添加改变文件数据的方法。
 [[NSUserDefaults standardUserDefaults] setValue:@"dynamic_tags" forKey:@"DYNAMIC_TAG"];
  1. 最后重启应用生效。

注意

  1. 特殊 key : track_id (在 RUM 中配置,用于追踪功能)

  2. 当用户通过 globalContext 添加自定义标签与 SDK 自有标签相同时,SDK 的标签会覆盖用户设置的,建议标签命名添加项目缩写的前缀,例如 df_tag_name

  3. 在调用 -startRumWithConfigOptions 方法启动 RUM 前设置 globalContext 才能生效。

  4. FTSDKConfig 中配置的自定义标签将添加在所有类型的数据中。

详细细节请见 SDK Demo

常见问题

关于崩溃日志分析

出现 Include of non-modular header inside framework module 报错

因为 SDK 的 .h 文件中引⼊了依赖库的 .h 文件,所以需要设置

Target -> Build Settings -> CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES 设置为 YES.

文档评价

文档内容是否对您有帮助? ×