개요

MSDK에서 Bugly의 데이터 보고를 통합하는 기능으로, 클라이언트 crash 시 클라이언트의 정보를 서버에 업로드하고 개발자와 함께 확인합니다. 개발자로 하여금, 애플리케이션이 온라인 상에 있을 때의 치명적인 bug를 발견할 수 있게 해 줍니다.

아래 그림은 온라인 애플리케이션 crash 후에, Bugly 플랫폼을 통해 확인하는 클라이언트 정보(주의: 애플리케이션 crash 시 캡처 화면 보고하지 않음)입니다.

a) 아래 그림의 “오류 스레드”, “모든 스레드”, “시스템 로그” 표시와 같은 crash 진행의 스택 정보를 보고합니다.

b) 현재 휴대전화기의 기본 정보를 보고합니다. : 기기 명칭(제조업체, 모델), 시스템 버전, 디스크 이용 가능 공간, SD카드 이용 가능 공간, 메모리 이용 가능 공간 등.

c) 아래 그림의 “사용자 이름”으로 표시된 사용자의 openid를 보고합니다.

d) 사용자가 아래 그림의 “더 많은 정보”에 표시된 보고 정보를 정의합니다.

귀하께서는 애플리케이션의 crash 시 보고하는 문자열을 정의할 수 있으며, 그 예시도는 아래와 같습니다.

또한 crash 시 2진법 데이터를 보고할 수 있으며, 2진법 데이터는 현재 rdm 플랫폼 -> 이상 보고 모듈 아래에서 구체적인 crash 이벤트를 찾을 수 있으며, 2진법 데이터 파일도 다운로드할 수 있습니다.

소량의 정의된 log를 애플리케이션 crash 시에 Bulgy 플랫폼에 보고할 수 있으며, 추가 데이터 -> 자체 정의 로그에서 확인하실 수 있습니다.

액세스 내비게이션

1 사전 요구 사항

1) 초기화 모듈 설명에 따라 초기화

MSDK->Config Settings 내 CLOSD_BUGLY_REPORT 옵션에서 체크 표시를 해제하십시오.

(./res/bugly_bugly_switch.png)

3) 약정에 따른 혼합

jar 패키지를 혼합할 필요가 없을 경우, 이 단계를 무시하십시오. jar 패키지를 혼합해야 할 경우, msdk*.jar 파일을 혼합하지 마십시오. 또는, msdk*.jar 파일을 혼합할 때 아래 <br>의 keep 정보를 App의 혼합 설정 내에 추가하십시오.

-keep class * extends android.app.Activity{*;}
-keep class * extends android.app.Service{*;}
#Bugly 인터페이스
-keep public class com.tencent.bugly.crashreport.crash.jni.NativeCrashHandler{public *; native <methods>;}
-keep public interface com.tencent.bugly.crashreport.crash.jni.NativeExceptionHandler{*;}

4) App 환원 기호표 설정 Bulgy 플랫폼 설정으로 가서 환원 기호표를 설정하십시오. 주소는 http://bugly.qq.com/이며, 자주 묻는 질문을 참조해 설정할 수 있습니다.

상기 4개 단계를 완료한 후에, 온라인 애플리케이션 crash 시의 스택 정보를 확인할 수 있습니다.

2 crash 보고 기능 사용

crash 보고 기능은 애플리케이션 crash 시에 문자열을 보고할 수 있으며, 2진법 정보를 서버에서 귀하를 위해 분석합니다. 상세 정보는 별도 작업 로그 추가 보고, 별도 2진법 데이터 추가 보고, 출력 로그 보고를 참조하십시오.

보고서 데이터 확인

파트너 계정을 사용해 bugly.qq.com 웹사이트에 로그인하셔서 귀하께서 검색할 앱을 선택해 다음 그림과 같이 bugly 보고 데이터를 확인하십시오. 파트너 계정을 모를 경우, 페이잉 비서 또는 MSDK에 연결해 문의하십시오.

추가 작업 로그 첨부 보고

1 개요 설명

프로그램 Crash 시에는, 경우에 따라 일련의 별도의 자체 정의 데이터를 추가해야 할 수 있습니다.

2 콜백

1) 기능 설명

프로그램 Crash 시에는, 일련의 별도의 자체 정의 데이터를 추가해야 될 수 있으며, crash 로그에 따라 Bugly 플랫폼에 보고할 수 있습니다. 이렇게 함으로써 crash가 발생한 원인을 더욱 잘 규명할 수 있습니다. 개요 상의 3.1 별도 문자열 표시 업로드에서, 보고하는 데이터는 Bugly 플랫폼 상의 “자체 정의 로그” -> “별도의 데이터” 내에서 찾을 수 있습니다.

2) 인터페이스 선언

public delegate String CrashReportMessageDelegate();

3) 파라미터 설명

없음

4) 반환값

5) 예시 코드

초기화 시에 추가 데이터 보고 이벤트 CrashReportMessageEvent를 등록해야 하며, 보고 로그를 도출해야 합니다.

MsdkEvent.Instance.CrashReportMessageEvent += () => {
    //TODO 보고 자체 정의 문자열
    return "Report extra message when crash happened. MSDK version : "
    + WGPlatform.Version;
};

6) 특수 설명

native 보고 진행 시에 해당 콜백은 무효가 될 수 있습니다.

7) 용어 해석

없음

3 인터페이스 호출

없음

추가 2진법 데이터 첨부 보고

1 개요 설명

프로그램 Crash 시에는, 경우에 따라 일련의 별도의 2진법 데이터를 추가해야 할 수 있습니다.

2 콜백

1) 기능 설명

프로그램 Crash 시에는, 일련의 별도의 2진법 데이터를 추가해야 될 수 있으며, crash 로그에 따라 Bugly 플랫폼에 보고할 수 있습니다. 이렇게 함으로써 crash가 발생한 원인을 더욱 잘 규명할 수 있습니다. 마지막으로 rdm 플랫폼 상에서 오류 상세 정보를 확인할 수 있으며, 그중 별도의 업무 로그는 userExtraByteData 안에 저장됩니다. bugly는 현재 userExtraByteData 검색 기능을 공개하지 않고 있으며, 현재 개발 중에 있습니다. 비교적 오래된 버전의 rdm 웹사이트(http://rdm.oa.com/) 상에서 표시할 수 있습니다. 개요의 3.2 별도의 2진법 데이터 업로드 그림의 경우, 보고한 데이터는 현재 rdm 플랫폼 -> 이상 보고 모듈 아래에서 구체적인 crash 이벤트를 찾을 수 있으며, 2진법 데이터 파일도 다운로드할 수 있습니다.

2) 인터페이스 선언

public delegate byte[] CrashReportDataDelegate();

3) 파라미터 설명

없음

4) 반환값

5) 예시 코드

초기화 시에 추가 데이터 보고 이벤트 CrashReportDataEvent를 등록해야 하며, 보고 로그를 도출해야 합니다.

MsdkEvent.Instance.CrashReportDataEvent += () => {
 //TODO 보고 자체 정의 2진법 정보
    string extraDataStr="Report extra data when crash happened. MSDK version : " + WGPlatform.Version;
    byte[] extraData=System.Text.Encoding.Default.GetBytes(extraDataStr);
    return extraData;
};

6) 특수 설명

native에서 보고할 경우, 해당 콜백은 무효가 될 수 있습니다.

7) 용어 해석

없음

3 인터페이스 호출

없음

출력 로그 보고

1 개요 설명

프로그램 Crash 시에는, 경우에 따라 일련의 별도의 2진법 데이터를 추가해야 할 수 있습니다.

2 콜백

없음

3 인터페이스 호출

1) 기능 설명

임의의 native crash 환경에서, bugly의 OnCrashReportDataEvent 및 CrashReportDataEvent에 대한 이벤트 콜백 함수 등록은 실행할 수 없을 수도 있으며, 귀하께서 자체 정의한 로그의 인터페이스를 사용할 것을 권장합니다. 해당 인터페이스는 일련의 개발자 관심 테스트 로그에 사용될 수 있으며, 더욱 적극적으로 App의 이상 시 전후 환경에 대응할 수 있습니다. 사용 방식은 android.util.Log와 같습니다. 사용자가 전송 입력한 TAG 및 로그 내용. 해당 로그는 Logcat에서 출력되며, 이상 발생 시에 보고하고 로그 보고서의 최대 용량은 30KB입니다.

bugly 페이지의 “상세 정보” -> "자체 정의 로그"에서 자체 정의 로그를 확인할 수 있습니다.

2) 인터페이스 선언

void WGBuglyLog(eBuglyLogLevel level, string log);

3) 파라미터 설명

4) 반환값 및 콜백 설명

없음

5) 예시 코드

WGPlatform.Instance.WGBuglyLog(eBuglyLogLevel.eBuglyLogLevel_E, "bugly message test");

6) 특수 설명

사용자가 전송 입력한 TAG 및 로그 내용. 해당 로그는 Logcat에서 출력되며, 이상 발생 시에 보고하고 로그 보고서의 최대 용량은 30KB입니다.

7) 용어 해석

없음

Lua/C#/JS스크립트 오류 보고

1 설명

게임 Lua/C#/JS스크립트에 오류 발생 시, bugly에 해당 오류 정보 보고 가능.

2 콜백

1) 기능 설명

스크립트 오류 내용을bugly에 보고할 시, bugly에서 “오류 분석” ->"Lua스크립트 오류/C#스크립트 오류/JS스크립트 오류" 에서 해당 보고를 열람 가능

2) 인터페이스 선언

void WGReportException(eExceptionType exception_type,
                           unsigned char *exception_name,
                           unsigned char *exception_msg,
                           unsigned char *exception_stack,
                           std::vector &ext_info)

3) 파라미터 설명

4) 반환값

없음

5) 예시 코드

std::vectorextInfo;
KVPair item;
item.key = "extInfo_Body";
item.value = std::string("wegame_extInfo_body");
eveList.push_back(item);
WGPlatform::GetInstance()->WGReportException((eExceptionType) exceptionType,
        									"MSDK_excetipon_name",
									        "MSDK_exception_msg",
									        "MSDK_exception_stack_test",
									    	extInfo);

6) 특수 설명

없음

7) 명칭 해석

없음