Bugly SDK接入指南（Android）

bugly

---

0. 使用说明

    本文档主要介绍Bugly SDK（Android）使用方法， 利用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/），下载Android SDK。

2.2 将BuglySDK.jar包引入到你的Android工程；

2.3 注册Bugly SDK的调用事件;

import android.app.Activity;
import com.tencent.bugly.sdk.BuglyFeedbackShake;
//你需要调用Bugly的Activity，或者是根Activity。
public class BaseActivity extends Activity {
    @Override
    protected void onResume() {
        super.onResume();
        //开始监听摇一摇
        BuglyFeedbackShake.getInstance().start(this);
    }
    @Override
    protected void onPause() {
        super.onPause();
        //停止监听摇一摇
        BuglyFeedbackShake.getInstance().stop();
    }
}

2.4 添加appid配置信息，在 AndroidManifest.xml 文件的 application 中加入 BUGLY_APPID 配置信息，如下：

<application>
    <meta-data
        android:name="BUGLY_APPID"
        android:value="你的appid" />
</application>

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

---

至此Bugly SDK最简单的使用方法已经完成了，下面是进阶教程。

---

3. 使用不同的Bugly唤起方式

3.1 摇一摇（上述基础教程的唤起方式）

import android.app.Activity;
import com.tencent.bugly.sdk.BuglyFeedbackShake;
public class BaseActivity extends Activity {
    @Override
    protected void onResume() {
        super.onResume();
        //开始监听摇一摇
        BuglyFeedbackShake.getInstance().start(this);
    }
    @Override
    protected void onPause() {
        super.onPause();
        //停止监听摇一摇
        BuglyFeedbackShake.getInstance().stop();
    }
}

3.2 音量键

import android.app.Activity;
import com.tencent.bugly.sdk.BuglyFeedback;
public class BaseActivity extends Activity {
    @Override
    public boolean onKeyDown(int keyCode, KeyEvent event) {
        //拦截音量键
        if(keyCode == KeyEvent.KEYCODE_VOLUME_UP || keyCode == KeyEvent.KEYCODE_VOLUME_DOWN){
            BuglyFeedback.getInstance().show(this);
            return false;
        }
        return super.onKeyDown(keyCode, event);
    }
}

3.3 普通按钮

import android.app.Activity;
import com.tencent.bugly.sdk.BuglyFeedback;
public class BaseActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...
        ...
        button.setOnClickListener(new OnClickListener(){
            @Override
            public void onClick(View view) {
                //唤起反馈对话框
                BuglyFeedback.getInstance().show(this);
            }
        });
    }
}

---

自定义API

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

import com.tencent.bugly.sdk.BuglyFeedbackApi;
//唤起反馈界面之前调用，会获取最后界面的截图
BuglyFeedbackApi.getInstance().createScreenShot(this);
//反馈提交按钮事件
private void onClick {
    //用户自定义字段
    Map<String, String> map = new HashMap<String, String>();
    map.put("name1", "value1");
    map.put("name2", "value2");
    /**
    * 开始进入提交流程、抓日志、获取机型信息、压缩、上传
    * 第一个参数：context
    * 第二个参数：反馈描述
    * 第三个参数：用户名
    * 第四个参数：自定义字段
    **/
    BuglyFeedbackApi.getInstance().submitDataAsync(this, content, "melt", map);
}

---

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