通过 CocoaPods 集成

Bugtags SDK 全部版本均采用 HTTPS 协议进行网络传输，完全符合 Apple ATS 安全标准，请放心使用。

Bugtags SDK 并未直接集成 JSPatch，只是检测应用是否已集成 JSPatch，以便为 Bugtags 用户提供在线修复管理功能，2.2.1 及以上版本已移除对 JSPatch 的检测逻辑，请大家及时更新。

注意：

  • 当前最新版本为 3.2.1，请通过 pod update Bugtags 更新，不要用 --no-repo-update 选项，如果无法获取到最新版本，请先运行 pod repo update 更新本地的 pod 仓库；
  • SDK 最低兼容 iOS 7.0；
  • 请勿与其他带有崩溃分析的 SDK 同时使用，否则将有可能影响崩溃捕捉功能的正常使用；
  • 集成有问题，请查看集成视频，查看 FAQ，或者进入 QQ 群：126207501；
  • App 在联机 Debug 状态下，SDK 默认不自动上报闪退，如需上报，请手动设置 BugtagsOptions -> trackingCrashes 参数；
  • 使用说明请参阅产品说明文档。

步骤：

  1. 在你项目的 Podfile 中添加以下代码
pod 'Bugtags'
  1. 执行 pod 安装命令
pod install

如果无法获取到最新版本的 Bugtags SDK，请运行以下命令更新本地的 pod 仓库

pod repo update

运行完成后，重新执行安装命令 pod install

  1. 重要！ 执行完 pod 命令后，请确认在应用对应 target 的设置中，Build Settings -> Linking 项下的 Other Linker Flags 中是否已自动添加 $(inherited)，如果未添加，请手动添加 Other Linker Flags
  2. 在 AppDelegate.m 中导入头文件
#import <Bugtags/Bugtags.h>

如果是 Swift 项目，请在对应的 bridging-header.h 中导入

  1. 在项目 AppDelegate 的 application didFinishLaunchingWithOptions 方法中初始化 Bugtags（请不要在异步线程中调用）

    Objective-C

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    [Bugtags startWithAppKey:@"APP_KEY" invocationEvent:BTGInvocationEventBubble];
    return YES;
}

    Swift 3

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    Bugtags.start(withAppKey: "APP_KEY", invocationEvent: BTGInvocationEventBubble)
    return true
}

    Swift 2

    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {

    Bugtags.startWithAppKey("APP_KEY", invocationEvent: BTGInvocationEventBubble)
    return true
}

    尽量将初始化 Bugtags 的代码放在 application didFinishLaunchingWithOptions 方法中的第一行

  2. 如果你需要自定义 Bugtags 的功能，可以向 Bugtags 的初始化方法中传入 BugtagsOptions 参数：

    Objective-C

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    BugtagsOptions *options = [[BugtagsOptions alloc] init];
    options.trackingUserSteps = YES; // 具体可设置的属性请查看 Bugtags.h
    [Bugtags startWithAppKey:@"APP_KEY" invocationEvent:BTGInvocationEventBubble options:options];
    return YES;
}

    Swift 3

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    let options = BugtagsOptions()
    options.trackingUserSteps = true // 具体可设置的属性请查看 Bugtags.h
    Bugtags.start(withAppKey: "APP_KEY", invocationEvent: BTGInvocationEventBubble, options: options)
    return true
}

    Swift 2

    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {

    let options = BugtagsOptions()
    options.trackingUserSteps = true // 具体可设置的属性请查看 Bugtags.h
    Bugtags.startWithAppKey("APP_KEY", invocationEvent: BTGInvocationEventBubble, options: options)
    return true
}

    尽量将初始化 Bugtags 的代码放在 application didFinishLaunchingWithOptions 方法中的第一行

编译运行 App，将会在 App 中看到一个小球，成功了！看不到悬浮球？ 想隐藏悬浮球？

参考资源：