Bugly SDK接入指南（iOS）

bugly

---

0. 使用说明

    本文档主要介绍Bugly SDK（iOS）使用方法， 利用SDK可以直接完成从填写反馈、收集机型信息、抓取日志和屏幕截图等一系列动作。 
    本文属于入门级文档，旨在帮助开发者快速学习Bugly SDK的使用并应用到产品当中。

---

1. 获取应用授权码

所有使用Bugly SDK服务的应用都需要有一个应用授权码(appid)。使用该appid可以帮你统计和分析相关应用的用户反馈情况。

要获取appid，请执行以下操作：

1.1 访问Bugly官网网站（http://t.bugly.qq.com/login/），并使用你的账号登陆；
1.2 点击左下角菜单成为开发者，完善个人信息；
1.3 注册一个应用，然后可以在“我的应用”界面看到对应的appid。

2. 嵌入Bugly SDK到你的应用

2.1 进入下载页（网址：http://t.bugly.qq.com/download/），下载iOS SDK。

2.2 将BuglySDK.framework引入到你的iOS工程；

2.3 引入以下依赖的系统framework;

AudioToolbox.framework
CoreMotion.framework
CoreTelephony.framework
ExternalAccessory.framework
Foundation.framework
libz.dylib
Security.framework
SystemConfiguration.framework
UIKit.framework

2.4 注册Bugly SDK的调用事件，在你的xxAppDelegate.m中加入以下方法：

#import <BuglySDK/BuglySDK.h>
- (void)applicationDidBecomeActive:(UIApplication *)application {
    ...
    ...
    [BuglySDK startWithAppID:@"你的appid"];
}
- (void)applicationWillResignActive:(UIApplication *)application {
    ...
    ...
    [BuglySDK stop];
}

2.5 测试你的应用，进入应用后摇一摇你的手机，看是否可以能正常唤起Bugly的反馈界面。效果图如下：

---

至此Bugly SDK最简单的使用方法已经完成了。

---

自定义API

自定义API可以方便开发者构建属于自己的反馈UI界面，通过调用BuglyAPI来完成上报操作。

#import <BuglySDK/BuglySDKApi.h>
//唤起反馈界面之前调用，会获取最后界面的截图
[BuglySDKApi createScreenShot];
//反馈提交按钮事件
- (IBAction)ok:(id)sender {
    //dict为用户自定义字段
    NSMutableDictionary *dict = [NSMutableDictionary dictionary];
    [dict setObject:@"value1" forKey:@"name1"];
    [dict setObject:@"value2" forKey:@"name2"];
    /**
    * 开始进入提交流程、抓日志、获取机型信息、压缩、上传
    * 第一个参数：appid
    * desc：反馈描述
    * username：用户名
    * extras：自定义字段
    **/
    [BuglySDKApi submitDataWithAppID:@"123456789" desc:@"test" username:@"usernmae" extras :dict];
}

---

更多内容请登录：http://t.bugly.qq.com