通过 CocoaPods 集成

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

注意:

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

步骤:

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

    pod install
    

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

    pod repo update
    

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

  3. 重要! 执行完 pod 命令后,请确认在应用对应 target 的设置中,Build Settings -> Linking 项下的 Other Linker Flags 中是否已自动添加 $(inherited),如果未添加,请手动添加 Other Linker Flags

  4. AppDelegate.m 中导入头文件

    #import <Bugtags/Bugtags.h>
    

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

  5. 在项目 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 方法中的第一行

  6. 如果你需要自定义 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 中看到一个小球,成功了!看不到悬浮球? 想隐藏悬浮球?

参考资源:

评论