一. SDK 集成

Bugly提供两种集成方式供iOS开发者选择：

• CocoaPods
• 手动集成

1.1 CocoaPods 集成方式

在工程的Podfile里面添加以下代码：

pod 'Bugly'

保存并运行pod install,然后用后缀为.xcworkspace的文件打开工程。

关于CocoaPods的更多信息请查看CocoaPods官方网站

二. 初始化SDK

2.1 导入头文件

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

#import <Bugly/Bugly.h>

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

2.2 初始化Bugly

在工程AppDelegate.m的application:didFinishLaunchingWithOptions:方法中初始化Bugly：

• Objective-C

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [Bugly startWithAppId:@"此处替换为你的AppId"]; return YES; }

• Swift

  func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool { Bugly.startWithAppId("此处替换为你的AppId")return true}

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

至此，Xcode工程集成Bugly已完成，接下来可以编译并运行你的Xcode工程。

高级功能

Bugly SDK提供一系列自定义配置或接口供开发者调用，如:

• 文件配置初始化参数

• 自定义日志

• 界面追踪

• 卡顿监控

Bugly iOS SDK 高级功能使用指南

一. 文件配置初始化参数

Bugly支持读取Info.plist文件读取SDK初始化参数，可配置的参数如下：

  - Appid- Key: BuglyAppIDString- Value: 字符串类型- 渠道标识- Key: BuglyAppChannelString- Value: 字符串类型- 版本信息- Key: BuglyAppVersionString - Value: 字符串类型 - 开启Debug信息显示 - Key: BuglyDebugEnable - Value: BOOL类型

如下初始化方式，则会读取Info.plist内添加的key-value配置进行SDK初始化：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // 读取Info.plist中的参数初始化SDK [Bugly startWithAppId:nil]; return YES;
}

二. 自定义日志

SDK提供自定义日志打印接口，用于记录一些关键的业务调试信息，可以更全面地反应App发生崩溃或异常时的上下文环境。
使用方式与NSLog一致，可定义日志级别以便过滤，日志接口宏定义如下：

    BLYLogError(fmt, ...) BLYLogWarn(fmt, ...) BLYLogInfo(fmt, ...) BLYLogDebug(fmt, ...) BLYLogVerbose(fmt, ...)void BLYLog(BuglyLogLevel level, NSString *format, ...); void BLYLogv(BuglyLogLevel level, NSString *format, va_list args);

Bugly iOS 符号表配置

一、介绍

什么是符号表？

符号表是内存地址与函数名、文件名、行号的映射表。符号表元素如下所示：

<起始地址> <结束地址> <函数> [<文件名: 行号>]

为什么要配置符号表？

为了能快速并准确地定位用户APP发生Crash的代码位置，Bugly使用符号表对APP发生Crash的程序堆栈进行解析和还原。

举一个实例：

Bugly iOS提供了自动和手动两种方法配置符号表

二、自动配置：XCode + sh脚本

• 符号表提取工具依赖 java 运行环境 java 环境下载

• 下载解压 自动配置符号表 zip 文件

• 把符号表提取工具buglySymboliOS.jar 保存在 ~/bin 目录下 (如果用户主目录没有bin文件夹,请自行创建，如下图所示)

  

• 在 Xcode 工程对应 Target 的Build Phases中新增Run Scrpit Phase

  

  

  1.打开dSYM_upload.sh，复制所有内容，在新增的Run Scrpit Phase中粘贴

  2.修改新增的Run Scrpit中的 <YOUR_APP_ID> 为您的 appid,<YOUR_APP_KEY>为您的 appkey，<YOUR_BUNDLE_ID> 为 app 的 Bundle Id

  注意去掉尖括号

  

  脚本默认在 Debug 模式及 模拟器编译 情况下不会上传符号表，在需要上传的时候，请修改下列选项

  3.Debug模式编译是否上传，1＝上传，0＝不上传，默认不上传

  UPLOAD_DEBUG_SYMBOLS=0

  4.模拟器编译是否上传，1＝上传，0＝不上传，默认不上传

  UPLOAD_SIMULATOR_SYMBOLS=0

  至此，自动上传符号表脚本配置完毕，Bugly 会在每次 Xcode 工程编译后自动完成符号表配置工作。

  如果不想自动上传模拟器编译后的符号文件，请修改脚本UPLOAD_SIMULATOR_SYMBOLS=0

  三、手动上传

  1. 下载最新版Bugly iOS符号表工具，其中工具包括：

     buglySymboliOS<Version>.zip

     符号表工具iOS版-使用指南

     buglySymboliOS.sh（Shell脚本）

     buglySymboliOS.jar（Jar包）

  2. 定位dSYM文件并使用Bugly iOS符号表工具生成符号表文件（xxx.zip）

  3. 定位dSYM文件方法和工具的使用方法请参考：符号表工具iOS版-使用指南

  4. 在Bugly的版本管理页面（产品页面 -> 设置 -> 版本管理）上传相应版本的符号表文件，如下图所示：

  

  四、符号表HTTP上传接口

  Bugly提供了上传符号表的HTTP（使用HTTP POST方式上传）

  • iOS符号表接口：http://bugly.qq.com/upload/dsym

  参数说明：

  • pid：2
  • app：App ID
  • key：App Key
  • bid：包名（Package Name）
  • ver：版本号（需要URL Encode）
  • n：符号表文件名（需要URL Encode）

  Content‐Type：

  • 上传.txt 文件：text/plain
  • 上传.zip 文件：application/zip

  可以使用Curl工具来上传。

  curl --header "Content-Type: application/zip" --data-binary
  @symbol.zip 'http://bugly.qq.com/upload/dsym?pid=2&app=123456789&key=XXXXXX&bid=com.demo.test&ver=1.0.1&n=symbol.zip' --verbose

http://bugly.qq.com