通过 CocoaPods 集成
- React-Native 集成,请参考:Bugtags-React-Native
Bugtags SDK 全部版本均采用 HTTPS 协议进行网络传输,完全符合 Apple ATS 安全标准,请放心使用。
Bugtags SDK 并未直接集成 JSPatch,只是检测应用是否已集成 JSPatch,以便为 Bugtags 用户提供在线修复管理功能,2.2.1 及以上版本已移除对 JSPatch 的检测逻辑,请大家及时更新。
注意:
- 当前最新版本为
3.2.3
,请通过pod update Bugtags
更新,不要用--no-repo-update
选项,如果无法获取到最新版本,请先运行pod repo update
更新本地的pod
仓库; - SDK 最低兼容 iOS 7.0;
- 请勿与其他带有崩溃分析的 SDK 同时使用,否则将有可能影响崩溃捕捉功能的正常使用;
- 集成有问题,请查看集成视频,查看 FAQ,或者进入 QQ 群:126207501;
- App 在联机 Debug 状态下,SDK 默认不自动上报闪退,如需上报,请手动设置
BugtagsOptions -> trackingCrashes
参数; - 使用说明请参阅产品说明文档。
步骤:
- 在你项目的 Podfile 中添加以下代码
pod 'Bugtags'
- 执行 pod 安装命令
pod install
如果无法获取到最新版本的 Bugtags SDK
,请运行以下命令更新本地的 pod
仓库
pod repo update
运行完成后,重新执行安装命令 pod install
- 重要! 执行完
pod
命令后,请确认在应用对应target
的设置中,Build Settings
->Linking
项下的Other Linker Flags
中是否已自动添加$(inherited)
,如果未添加,请手动添加 - 在
AppDelegate.m
中导入头文件
#import <Bugtags/Bugtags.h>
如果是 Swift 项目,请在对应的 bridging-header.h 中导入
在项目 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
方法中的第一行如果你需要自定义
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 中看到一个小球,成功了!看不到悬浮球? 想隐藏悬浮球?