Bugly SDK接入指南(iOS)
bugly
sdk
ios
0. 使用说明
本文档主要介绍Bugly SDK(iOS)使用方法, 利用SDK可以直接完成从填写反馈、收集机型信息、抓取日志和屏幕截图等一系列动作。
本文属于入门级文档,旨在帮助开发者快速学习Bugly SDK的使用并应用到产品当中。
1. 获取应用授权码
所有使用Bugly SDK服务的应用都需要有一个应用授权码(appid)。使用该appid可以帮你统计和分析相关应用的用户反馈情况。
要获取appid,请执行以下操作:
1.1 访问Bugly官网网站(http://bugly.qq.com/login/),并使用你的账号登陆;
1.2 点击左下角菜单成为开发者,完善个人信息;
1.3 注册一个应用,然后可以在“我的应用”界面看到对应的appid。
2. 嵌入Bugly SDK到你的应用
2.1 进入下载页(网址:http://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];
}