ios开发用户反馈 客服sdk

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;

1. AudioToolbox.framework
2. CoreMotion.framework
3. CoreTelephony.framework
4. ExternalAccessory.framework
5. Foundation.framework
6. libz.dylib
7. Security.framework
8. SystemConfiguration.framework
9. UIKit.framework

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

1. #import
3. - (void)applicationDidBecomeActive:(UIApplication *)application {
4. ...
5. ...
6. [BuglySDK startWithAppID:@"你的appid"];
7. }
9. - (void)applicationWillResignActive:(UIApplication *)application {
10. ...
11. ...
12. [BuglySDK stop];
13. }

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

---

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

---

自定义API

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

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