Bugly iOS SDK 使用指南

接入前准备

在接入sdk之前,请务必认真阅读《开发者合规指南》和《Bugly SDK(iOS)个人信息保护规则》

SDK 集成

如果您是从Bugly 2.0以下版本升级过来的,请查看iOS SDK 升级指南

Bugly iOS SDK 最低兼容系统版本 iOS 10.0


请务必确保您已经将Bugly SDK升级到满足监管新规的最新版本
请务必在用户授权《隐私政策》后再初始化Bugly SDK

手动集成

  • 下载 Bugly iOS SDK
  • 拖拽Bugly.xcframework文件到Xcode工程内(请勾选Copy items if needed选项)
  • 添加依赖库
    • SystemConfiguration.framework
    • Security.framework
    • libz.dylib 或 libz.tbd
    • libc++.dylib 或 libc++.tbd

启动 Bugly 监控

导入头文件

在工程的AppDelegate.m文件导入头文件

#import <Bugly/Bugly.h>

#import <Bugly/BuglyConfig.h>

如果是Swift工程,请在对应bridging-header.h中导入

启动 Bugly

在工程AppDelegate.m的application:didFinishLaunchingWithOptions:方法中启动 Bugly:

  • Objective-C
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    BuglyConfig *config = [[BuglyConfig alloc] initWithAppId:@"此处替换为你的AppId"
                                               appKey:@"此处可为空字符串"];
    // 以下功能需要SDK版本升级为2.7.1.1版本
    // 设置是否采集cpu属性,默认采集
    [config setEnableCpuInfo:NO];
    // 设置是否采集剩余磁盘空间,默认采集
    [config setEnableDiskSpace:NO];
    // 设置是否采集剩余内存,默认采集
    [config setEnableFreeMemory:NO];
    // 设置是否采集地区编码,默认采集
    [config setEnableCountryCode:NO];
    // 设置是否采集设备型号,默认采集
    [config setEnableDeviceModel:NO];
    // 设置是否采集wifi状态,默认采集
    [config setEnableNetworkType:NO];
    // 设置是否采集进程内存,默认采集
    [config setEnableProcessMemory:NO];
    // 设置是否采集系统版本,默认采集
    [config setEnableSystemVersion:NO];
    // 设置是否采集越狱信息,默认采集
    [config setEnableJailbreakStatus:NO];
    // 设置是否采集操作系统内部版本号,默认采集
    [config setEnableSystemVersionCode:NO];
    // 启动Bugly监控
    [Bugly startWithConfig:config];
    return YES;
}
  • Swift
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
    let config = BuglyConfig(appId: "此处替换为你的AppId", appKey: "此处输入空字符串")
    // 以下功能需要SDK版本升级为2.7.1.1版本
    // 设置是否采集cpu属性,默认采集
    config.setEnableCpuInfo(false)
    // 设置是否采集剩余磁盘空间,默认采集
    config.setEnableDiskSpace(false)
    // 设置是否采集剩余内存,默认采集
    config.setEnableFreeMemory(false)
    // 设置是否采集地区编码,默认采集
    config.setEnableCountryCode(false)
    // 设置是否采集设备型号,默认采集
    config.setEnableDeviceModel(false)
    // 设置是否采集wifi状态,默认采集
    config.setEnableNetworkType(false)
    // 设置是否采集进程内存,默认采集
    config.setEnableProcessMemory(false)
    // 设置是否采集系统版本,默认采集
    config.setEnableSystemVersion(false)
    // 设置是否采集越狱信息,默认采集
    config.setEnableJailbreakStatus(false)
    // 设置是否采集操作系统内部版本号,默认采集
    config.setEnableSystemVersionCode(false)

    // 启动Bugly监控
    Bugly.start(with: config)
    return true
}

如果您需要上报iOS Watch2 App或iOS App Extension的异常,请参见 Bugly iOS Extension SDK 接入指南。