iOS 应用接入¶

简介¶

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

前置条件¶

安装 DataKit（DataKit 安装文档）

iOS应用接入¶

登录观测云控制台，进入「用户访问监测」页面，点击右上角「新建应用」，在新窗口输入「应用名称」并自定义「应用 ID 标识」，点击「创建」，即可选择应用类型获取接入方式。

应用名称（必填项）：用于识别当前实施用户访问监测的应用名称。
应用 ID（必填项）：应用在当前工作空间的唯一标识，用于 SDK 采集数据上传匹配，数据入库后对应字段：app_id 。该字段仅支持英文、数字、下划线输入，最多为 48 个字符。

安装¶

Demo：https://github.com/GuanceCloud/datakit-ios/demo

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

源码方式¶

1.从 GitHub 获取 SDK 的源代码。

2.将 SDK 源代码导入 App 项目，并选中 Copy items if needed。直接将 FTMobileSDK 整个文件夹导入项目。

CocoaPods 方式¶

1.配置 Podfile 文件。

target 'yourProjectName' do

# Pods for your project
pod 'FTMobileSDK', '1.3.7-beta.1'

end

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

Carthage 方式¶

1.配置 Cartfile 文件。

github "GuanceCloud/datakit-ios" == 1.3.7-beta.1

2.在 Cartfile 目录下执行 carthage update --platform iOS ，并将 FTMobileSDK.framework 拖拽到您的项目中使用。若出现 "Building universal frameworks with common architectures is not possible. The device and simulator slices for "FTMobileSDK.framework" both build for: arm64" 错误，请执行 carthage update --platform iOS --use-xcframeworks 命令，生成 FTMobileSDK.xcframework，与普通的 Framework 使用方法相同，请将它拖拽到您的项目中使用。

3.debug 模式下，为了方便 SDK 调试，建议使用 debug 模式的静态库。在命令后添加 --configuration Debug 获取 debug 模式的静态库。

4.在 TARGETS -> Build Setting -> Other Linker Flags 添加 -ObjC。

5.目前只支持 1.3.4-beta.2 及以上的版本。

添加头文件¶

//使用 Carthage 方式
#import <FTMobileAgent/FTMobileAgent.h>
...
//使用 源码 或 CocoaPods 方式
#import "FTMobileAgent.h"

SDK 初始化¶

基础配置¶

-(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{
    // SDK FTMobileConfig 设置
    FTMobileConfig *config = [[FTMobileConfig alloc]initWithMetricsUrl:@"Your App metricsUrl"];
    config.enableSDKDebugLog = YES;
    //启动 SDK
    [FTMobileAgent startWithConfigOptions:config];

   //...
    return YES;
}

字段	类型	说明	必须
metricsUrl	NSString	数据上报地址	是
enableSDKDebugLog	BOOL	设置是否允许打印日志	否（默认NO）
env	NS_ENUM	环境	否（默认FTEnvProd）
XDataKitUUID	NSString	请求HTTP请求头X-Datakit-UUID 数据采集端如果用户不设置会自动配置	否
globalContext	NSDictionary	添加自定义标签	否

env 环境¶

typedef NS_ENUM(NSInteger, FTEnv) {
    FTEnvProd         = 0, //线上环境
    FTEnvGray,             //灰度环境
    FTEnvPre,              //预发布环境
    FTEnvCommon,           //日常环境
    FTEnvLocal,            //本地环境
};

@property (nonatomic, assign) FTEnv env;

RUM 配置¶

    //开启 rum
    FTRumConfig *rumConfig = [[FTRumConfig alloc]init];
    rumConfig.appid = appid;
    rumConfig.enableTrackAppCrash = YES;
    rumConfig.enableTrackAppANR = YES;
    rumConfig.enableTrackAppFreeze = YES;
    rumConfig.enableTraceUserAction = YES;
      rumConfig.enableTraceUserVIew = YES;
    rumConfig.deviceMetricsMonitorType = FTDeviceMetricsMonitorAll;
    [[FTMobileAgent sharedInstance] startRumWithConfigOptions:rumConfig];

字段	类型	说明	必须
appid	NSString	DataFlux rum应用唯一ID标识，在DataFlux控制台上面创建监控时自动生成。	否（开启RUM 必选）
samplerate	int	采样采集率	否（默认100）
errorMonitorType	NS_OPTIONS	error数据中的采集数据	否
enableTrackAppCrash	BOOL	设置是否需要采集崩溃日志	否（默认NO）
enableTrackAppANR	BOOL	采集ANR卡顿无响应事件	否（默认NO）
enableTrackAppFreeze	BOOL	采集UI卡顿事件	否（默认NO）
enableTraceUserAction	BOOL	设置是否追踪用户 Action 操作	否（默认NO）
enableTraceUserView	BOOL	设置是否追踪用户 View 操作	否（默认NO）
globalContext	NSDictionary	添加自定义标签	否
deviceMetricsMonitorType	NS_OPTIONS	监控类型	否（未设置则不开启监控）
monitorFrequency	NS_OPTIONS	设置监控采样周期	否

监控数据配置¶

配置 FTRumConfig 的 errorMonitorType 属性，将在采集的崩溃数据中添加对应的信息。可采集的类型如下：

/**
 *
 * @constant
 *  FTMonitorInfoTypeBattery  - 电池电量
 *  FTMonitorInfoTypeMemory   - 内存总量、内存使用率
 *  FTMonitorInfoTypeCpu      - CPU使用率
 */
typedef NS_OPTIONS(NSUInteger, FTMonitorInfoType) {
    FTMonitorInfoTypeAll          = 0xFFFFFFFF,
    FTMonitorInfoTypeBattery      = 1 << 1,
    FTMonitorInfoTypeMemory       = 1 << 2,
    FTMonitorInfoTypeCpu          = 1 << 3,
};

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

/**
 * 监控项
 * @constant
 *  FTDeviceMetricsMonitorMemory   - 平均内存、最高内存
 *  FTDeviceMetricsMonitorCpu      - CPU跳动最大、平均数
 *  FTDeviceMetricsMonitorFps      - fps 最低帧率、平均帧率
 */
typedef NS_OPTIONS(NSUInteger, FTDeviceMetricsMonitorType){
    FTDeviceMetricsMonitorAll      = 0xFFFFFFFF,
    FTDeviceMetricsMonitorCpu      = 1 << 1,
    FTDeviceMetricsMonitorMemory   = 1 << 2,
    FTDeviceMetricsMonitorFps      = 1 << 3,
};

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

Log 配置¶

    //开启 logger
    FTLoggerConfig *loggerConfig = [[FTLoggerConfig alloc]init];
    loggerConfig.enableCustomLog = YES;
    loggerConfig.enableLinkRumData = YES;
    loggerConfig.enableConsoleLog = YES;
    [[FTMobileAgent sharedInstance] startLoggerWithConfigOptions:loggerConfig];

字段	类型	说明	必须
samplerate	int	采样采集率	否（默认100）
serviceName	NSString	设置日志所属业务或服务的名称	否（默认df_rum_ios）
enableConsoleLog	BOOL	设置是否需要采集控制台日志	否（默认NO）
prefix	NSString	设置采集控制台日志过滤字符串	否（默认全采集）
enableCustomLog	BOOL	是否上传自定义 log	否（默认NO）
logLevelFilter	NSArray	设置要采集的自定义 log 的状态数组	否（默认全采集）
enableLinkRumData	BOOL	是否将 logger 数据与 rum 关联	否（默认NO）
discardType	FTLogCacheDiscard	设置日志废弃策略	否（默认丢弃最新数据）
globalContext	NSDictionary	添加自定义标签	否

日志废弃策略¶

typedef NS_ENUM(NSInteger, FTLogCacheDiscard)  {
    FTDiscard,        //默认，当日志数据数量大于最大值（5000）时，新数据不进行写入
    FTDiscardOldest   //当日志数据数量大于最大值时,废弃旧数据
};

/**
 * 设置日志废弃策略
 */
@property (nonatomic, assign) FTLogCacheDiscard  discardType;

采集控制台日志¶

一般情况下，因为 NSLog 的输出会消耗系统资源，而且输出的数据也可能会暴露出App里的保密数据，所以在发布正式版时会把这些输出全部屏蔽掉。此时开启采集控制台日志，也并不能抓取到工程里打印的日志。建议使用自定义上报日志来上传想查看的日志。

开启采集控制台日志

/**
 *设置是否需要采集控制台日志 默认为NO
 */
 @property (nonatomic, assign) BOOL enableConsoleLog;

设置采集控制台日志的过滤条件

/**
 * 设置采集控制台日志过滤字符串 包含该字符串控制台日志会被采集 默认为全采集
 */
@property (nonatomic, copy) NSString *prefix;

Trace 配置¶

    //开启 trace
    FTTraceConfig *traceConfig = [[FTTraceConfig alloc]init];
    traceConfig.enableLinkRumData = YES;
      traceConfig.enableAutoTrace = YES;
    traceConfig.networkTraceType = FTNetworkTraceTypeDDtrace;
    [[FTMobileAgent sharedInstance] startTraceWithConfigOptions:traceConfig];

字段	类型	说明	必须
samplerate	int	采样采集率	否（默认100)
networkTraceType	NS_ENUM	设置网络请求信息采集时使用链路追踪类型，如果接入 OpenTelemetry 选择对应链路类型时，请注意查阅支持类型及 agent 相关配置	否（默认DDtrace）
enableLinkRumData	BOOL	是否将 Trace 数据与 rum 关联	否（默认NO）
enableAutoTrace	BOOL	设置是否开启自动 http trace，目前只支持 NSURLSession	否（默认NO）

链路追踪类型¶

/**
 * @enum
 * 网络链路追踪使用类型
 *
 * @constant
 *  FTNetworkTraceTypeDDtrace       - datadog trace
 *  FTNetworkTraceTypeZipkinMultiHeader   - zipkin multi header
 *  FTNetworkTraceTypeZipkinSingleHeader  - zipkin single header
 *  FTNetworkTraceTypeTraceparent         - w3c traceparent
 *  FTNetworkTraceTypeSkywalking    - skywalking 8.0+
 *  FTNetworkTraceTypeJaeger        - jaeger
 */

typedef NS_ENUM(NSInteger, FTNetworkTraceType) {
    FTNetworkTraceTypeDDtrace,
    FTNetworkTraceTypeZipkinMultiHeader,
    FTNetworkTraceTypeZipkinSingleHeader,
    FTNetworkTraceTypeTraceparent,
    FTNetworkTraceTypeSkywalking,
    FTNetworkTraceTypeJaeger,
};

RUM 用户数据追踪¶

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

View¶

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

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

[[FTExternalDataManager sharedManager] stopView];

/**
 * 创建页面 需要在 -startView 与 -stopView 方法前使用 
 * @param viewName     页面名称
 * @param loadTime     页面加载时间
 */
-(void)onCreateView:(NSString *)viewName loadTime:(NSNumber *)loadTime;
/**
 * 进入页面 viewId 内部管理
 * @param viewName        页面名称
 */
-(void)startViewWithName:(NSString *)viewName;
/**
 * 离开页面
 */
-(void)stopView;

Action¶

/**
 * 添加 Click Action 事件
 * @param actionName 事件名称
 */
- (void)addClickActionWithName:(NSString *)actionName;

Error¶

[[FTExternalDataManager sharedManager] addErrorWithType:@"type" situation:RUN message:@"message" stack:@"stack"];

/**
 * 添加 Error 事件
 * @param type       error 类型
 * @param situation  APP状态
 * @param message    错误信息
 * @param stack      堆栈信息
 */
- (void)addErrorWithType:(NSString *)type situation:(AppState)situation message:(NSString *)message stack:(NSString *)stack;

LongTask¶

[[FTExternalDataManager sharedManager] addLongTaskWithStack:@"堆栈信息 string" duration:@1000000000];

/**
 * 添加 卡顿 事件
 * @param stack      卡顿堆栈
 * @param duration   卡顿时长 (纳秒级)
 */
- (void)addLongTaskWithStack:(NSString *)stack duration:(NSNumber *)duration;

Resource¶

//第一步：请求开始前
[[FTExternalDataManager sharedManager] startResourceWithKey:key];

//第二部：请求完成
[[FTExternalDataManager 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 原生 获取到 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
 [[FTExternalDataManager sharedManager] addResourceWithKey:key metrics:metricsModel content:content];

/**
 * @param key       请求标识
 */
- (void)startResourceWithKey:(NSString *)key;
/**
 * @param key       请求标识
 */
- (void)stopResourceWithKey:(NSString *)key;
/**
 * @param key       请求标识
 * @param metrics   请求相关性能属性
 * @param content   请求相关数据
 */
- (void)addResourceWithKey:(NSString *)key metrics:(nullable FTResourceMetricsModel *)metrics content:(FTResourceContentModel *)content;

Logger 日志打印¶

上传机制 : 将数据存储到数据库中，等待时机进行上传。数据库存储量限制在 5000 条，如果网络异常等原因导致数据堆积，存储 5000 条后，会丢弃新传入的数据。

[[FTMobileAgent sharedInstance] logging:@"TestLoggingBackground" status:FTStatusInfo];

日志等级¶

typedef NS_ENUM(NSInteger, FTStatus) {
    FTStatusInfo         = 0,
    FTStatusWarning,
    FTStatusError,
    FTStatusCritical,
    FTStatusOk,
};
/**
 * 日志上报
 * @param content  日志内容，可为json字符串
 * @param status   事件等级和状态，info：提示，warning：警告，error：错误，critical：严重，ok：恢复，默认：info

 */
-(void)logging:(NSString *)content status:(FTStatus)status;

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];

/**
 * 获取 trace 请求头
 * @param key 请求标识
 */
- (NSDictionary *)getTraceHeaderWithKey:(NSString *)key url:(NSURL *)url;

用户的绑定与注销¶

/**
 * 登录后 绑定用户信息
 * @param Id        用户Id
 * @param userName  用户名称
 * @param extra     用户的额外信息
*/
[[FTMobileAgent sharedInstance] bindUserWithUserID:USERID];
//or
[[FTMobileAgent sharedInstance] bindUserWithUserID:USERID userName:USERNAME userEmail:USEREMAIL];
//or
[[FTMobileAgent sharedInstance] bindUserWithUserID:USERID userName:USERNAME userEmail:USEREMAIL extra:@{EXTRA_KEY:EXTRA_VALUE}];

//登出后 注销当前用户
[[FTMobileAgent sharedInstance] logout];

添加自定义标签¶

静态使用¶

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

创建多 Configurations ：

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

使用预编译指令：

//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};
... //其他设置操作
[[FTMobileAgent sharedInstance] startRumWithConfigOptions:rumConfig];

动态使用¶

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

通过存文件本地保存，例如NSUserDefaults，配置使用 SDK，在配置处添加获取标签数据的代码。

NSString *dynamicTag = [[NSUserDefaults standardUserDefaults] valueForKey:@"DYNAMIC_TAG"]?:@"NO_VALUE";

FTRumConfig *rumConfig = [[FTRumConfig alloc]init];
rumConfig.globalContext = @{@"dynamic_tag":dynamicTag};
... //其他设置操作
[[FTMobileAgent sharedInstance] startRumWithConfigOptions:rumConfig];

在任意处添加改变文件数据的方法。

 [[NSUserDefaults standardUserDefaults] setValue:@"dynamic_tags" forKey:@"DYNAMIC_TAG"];

最后重启应用生效。

注意¶

特殊 key : track_id (在 RUM 中配置，用于追踪功能)
当用户通过 globalContext 添加自定义标签与 SDK 自有标签相同时，SDK 的标签会覆盖用户设置的，建议标签命名添加项目缩写的前缀，例如 df_tag_name。
在调用 -startRumWithConfigOptions 方法启动 RUM 前设置 globalContext 才能生效。
FTMobileConfig 中配置的自定义标签将添加在所有类型的数据中。

详细细节请见 SDK Demo。

崩溃日志符号化¶

上传符号表¶

方法一：脚本集成到 Xcode 工程的 Target¶

XCode 添加自定义 Run Script Phase：Build Phases -> + -> New Run Script Phase
将脚本复制到 Xcode 项目的构建阶段运行脚本中，脚本中需要设置参数如：＜app_id＞、＜dea_address＞、＜env＞、＜version＞(脚本默认配置的版本格式为 CFBundleShortVersionString)。
脚本

#脚本中需要配置的参数
#＜app_id＞
FT_APP_ID="YOUR_APP_ID"
#＜dea_address＞
FT_DEA_ADDRESS="YOUR_DEA_ADDRESS"
# ＜env＞ 环境字段。属性值：prod/gray/pre/common/local。需要与 SDK 设置一致
FT_ENV="common"
#
#＜version＞ 脚本默认配置的版本格式为CFBundleShortVersionString,如果你修改默认的版本格式, 请设置此变量。注意：需要确保在此填写的与SDK设置的一致。
# FT_VERSION=""

多环境便捷的配置参数¶

示例：使用预设宏和 .xcconfig 配置文件

添加预设宏：Target —> Build Settings -> + -> Add User-Defined Setting

使用多 Xcconfig 来实现多环境，新建 Xcconfig

.xcconfig 文件中配置预设宏：

//如果有使用 cocoapods 将 pods 的.xcconfig路径 添加到你的 .xcconfig文件中 如果路径不清楚可以终端进入项目文件夹，pod install ,终端会有提示路径，将该路径复制后引用就可以。

#include "Pods/Target Support Files/Pods-testDemo/Pods-testDemo.debug.xcconfig"

SDK_APP_ID = app_id_common
SDK_ENV = common
SDK_DEA_ADDRESS = http:\$()\xxxxxxxx:9531

配置自定义编译环境

使用

脚本中

#脚本中需要配置的参数
#＜app_id＞
FT_APP_ID=SDK_APP_ID
#＜dea_address＞
FT_DEA_ADDRESS=SDK_DEA_ADDRESS
# ＜env＞ 环境字段。属性值：prod/gray/pre/common/local。需要与 SDK 设置一致
FT_ENV=SDK_ENV

项目某一文件中

方法一：对指定文件进行配置：-D'SDK_APP_ID=@"$(SDK_APP_ID)"'

在指定文件中可以使用

方法二：映射到 Info.plist 文件中

在文件中可以使用

详细细节请见 SDK Demo。

方法二：终端运行脚本¶

找到 .dSYM 文件放在一个文件夹内，命令行下输入应用基本信息, .dSYM 文件的父目录路径, 输出文件目录即可

sh FTdSYMUpload.sh <dea_address> <app_id> <version> <env> <dSYMBOL_src_dir> <dSYMBOL_dest_dir>

方法三：手动上传¶

Sourcemap 上传

常见问题¶

关于崩溃日志分析¶

在开发时的 Debug 和 Release 模式下， Crash 时捕获的线程回溯是被符号化的。而发布包没带符号表，异常线程的关键回溯，会显示镜像的名字，不会转化为有效的代码符号，获取到的 crash log 中的相关信息都是 16 进制的内存地址，并不能定位崩溃的代码，所以需要将 16 进制的内存地址解析为对应的类及方法。

XCode 编译后没有生成 dSYM 文件？¶

XCode Release 编译默认会生成 dSYM 文件，而 Debug 编译默认不会生成，对应的 Xcode 配置如下：

Build Settings -> Code Generation -> Generate Debug Symbols -> Yes

Build Settings -> Build Option -> Debug Information Format -> DWARF with dSYM File

开启了 bitCode 怎么上传符号表？¶

当你上传你的 bitcode App 到 App Store，在提交对话框里勾选声明符号文件（dSYM文件）的生成：

在配置符号表文件之前，需要从App Store中把该版本对应的dSYM文件下载回本地，然后用脚本根据输入参数处理上传符号表文件。
不需要将脚本集成到 Xcode 工程的 Target 了，也不要用本地生成的 dSYM 文件来生成符号表文件，因为本地编译生成的 dSYM 文件的符号表信息都被隐藏了。如果用本地编译生成的 dSYM 文件上传，还原出来的结果将是类似于“__hiden#XXX”这样的符号。

如何找回已发布到 App Store 的 App 对应的 dSYM 文件？¶

应用上传到App Store Connect的Distribution options	dSym文件
Don’t include bitcode Upload symbols	通过 Xcode 找回
Include bitcode Upload symbols	通过 iTunes Connect 找回通过 Xcode 找回，需要使用 `.bcsymbolmap` 去混淆处理。
Include bitcode Don’t upload symbols	通过 Xcode 找回，需要使用 `.bcsymbolmap` 去混淆处理。
Don’t include bitcode Don’t upload symbols	通过 Xcode 找回

通过 Xcode 找回¶

Xcode -> Window -> Organizer
选择 Archives 标签

找到发布的归档包，右键点击对应归档包，选择Show in Finder操作

右键选择定位到的归档文件，选择显示包内容操作

选择dSYMs目录，目录内即为下载到的 dSYM 文件

通过 iTunes Connect 找回¶

登录App Store Connect；
进入"我的App（My Apps）"
在 "App Store" 或 "TestFlight" 中选择某一个版本"，点击 "构建版本元数据（Build Metadata）" 在此页面，点击按钮 "下载dSYM（Download dSYM）" 下载 dSYM 文件

.bcsymbolmap 去混淆处理¶

在通过 Xcode 找到 dSYM 文件时，可以看到 BCSymbolMaps 目录

打开终端并使用以下命令进行去混淆处理

xcrun dsymutil -symbol-map <BCSymbolMaps_path> <.dSYM_path>