영어로 읽기

다음을 통해 공유


오류

중요

Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. Visual Studio App Center가 완전히 사용 중지될 때까지 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.

지원 타임라인 및 대안에 대해 자세히 알아봅니다.

App Center 오류를 사용하면 앱의 오류를 처리하고 앱에서 잠재적인 문제를 방지할 수 있습니다. 이 섹션에서는 앱에서 오류를 catch하고 보고하는 방법을 살펴봅니다. 예외에 대한 공식 설명서에서 오류를 사용하는 시기와 방법에 대한 모범 사례에 대해 자세히 알아봅니다.

참고

처리된 오류는 현재 Xamarin 플랫폼에서만 지원됩니다.

일반 정보

애플리케이션에서 App Center를 실행할 때 서비스는 애플리케이션 수명 동안 모든 오류를 보고합니다. 이러한 오류는 발생하거나(네트워크 연결이 있는 경우) 또는 다음에 애플리케이션이 시작될 때 서버로 전송됩니다.

오류 설명서에서 기능 집합에 대해 자세히 알아보세요.

크래시 SDK를 통합하여 시작

Xamarin 앱에서 오류를 추적하려면 App Center SDK에서 크래시 모듈을 통합합니다. 크래시 SDK 설명서를 확인하여 이 작업을 수행하는 방법을 알아보세요.

Catch되지 않은 오류(충돌)

catch되지 않은 오류(크래시)는 try/catch 블록 외부에서 발생하는 오류입니다. App Center는 App Center SDK의 크래시 모듈을 통합할 때 기본적으로 이러한 크래시를 자동으로 보고합니다.

Try/Catch 엔클로저 내부(오류)

try/catch 엔클로저 내에서 메서드를 호출 TrackError 하면 오류가 발생할 때 App Center 서비스로 전송되는 정보를 제어하고 오류 및 디바이스 상태를 보다 명확하게 파악할 수 있습니다.

메서드를 사용하면 다음과 같은 여러 가지 이점이 있습니다.TrackError

  • 더 높은 정확도로 서비스에 보고서를 보냅니다.
  • 추가 정보를 사용하여 서비스에 보고서를 보냅니다.

App Center에서 처리된 오류 추적

크래시 SDK를 포함하여 오류를 처리하고 App Center에 보고합니다. 이 모듈의 일부로 메서드를 사용하여 오류를 추적할 수 있습니다.TrackError

try
{
    int divByZero = 42 / int.Parse("0");
} catch (DivideByZeroException ex){
    Crashes.TrackError(ex);
}

크래시 SDK 설명서에서 Xamarin에서 크래 시 SDK를 사용하여 오류를 추적하는 방법에 대해 자세히 알아봅니다.

오류 Catch에 추가 정보 추가

App Center로 전송된 오류 보고서를 조정하여 오류에 대한 추가 컨텍스트에 대한 추가 정보를 제공할 수 있습니다. 문자열 키/값 쌍의 사전을 메서드에 전달하여 TrackError 이 작업을 수행합니다. 이러한 속성은 선택적입니다. 예를 들면 다음과 같습니다.

try
{
    using (var text = File.OpenText("saved_game001.txt"))
    {
        Console.WriteLine("{0}", text.ReadLine());
        ...
    }
}
catch (FileNotFoundException ex)
{
    Crashes.TrackError(ex, new Dictionary<string,string>{
        { "Filename", "saved_game001.txt" },
        { "Where", "Reload game" },
        { "Issue", "Index of available games is corrupted" }
    });
}

여기서는 전체 예외(예: )가 여전히 App Center 서비스로 다시 전송되고 있지만 이 외에도 추가 디버깅 정보가 포함된 사전도 만들어지고 전송됩니다.

제한 사항

  • 오류당 최대 20개의 속성을 정의할 수 있습니다. 이 제한을 초과하는 속성은 거부됩니다.
  • 오류 속성 키 및 오류 속성 값당 최대 문자 수는 125자입니다.