HockeySDK에서 App Center WPF/Winforms로 마이그레이션

아티클
03/15/2024

중요

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

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

HockeySDK 대신 App Center SDK를 사용하도록 애플리케이션을 업데이트하려는 경우 이 설명서를 따릅니다.

1. 라이브러리 업데이트

HockeySDK.WPF NuGet 패키지를 솔루션의 모든 프로젝트에서 App Center 패키지로 바꿉니다.

Visual Studio for Windows

Windows용 Visual Studio를 엽니다.
파일>열기를 클릭하고 솔루션을 선택합니다.
솔루션 탐색기에서 참조를 마우스 오른쪽 단추로 클릭하고 NuGet 패키지 관리를 선택합니다.
HockeySDK.WPF 패키지를 제거합니다.
App Center를 검색하고 Microsoft.AppCenter.Analytics 및 Microsoft.AppCenter.Crashes 패키지를 설치합니다.

패키지 관리자 콘솔

Visual Studio에서 콘솔을 엽니다. 이렇게 하려면 도구>NuGet 패키지 관리자 패키지 관리자>콘솔을 선택합니다.
Mac용 Visual Studio 작업하는 경우 NuGet 패키지 관리 확장이 설치되어 있는지 확인합니다. 이를 위해 Visual Studio>확장을 선택하고 , NuGet 을 검색하고, 필요한 경우 설치합니다.
콘솔에서 다음 명령을 입력합니다.

Uninstall-Package HockeySDK.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

App Center SDK는 모듈식 접근 방식을 사용합니다. 통합하려는 서비스를 선택할 수 있습니다. 이 섹션에서는 각 SDK 모듈을 별도의 종속성으로 추가해야 합니다.

2. SDK 설치 코드 업데이트

2.1 애플리케이션 식별자 변환

App Center SDK는 GUID(Globally Unique Identifier) 형식의 애플리케이션 식별자를 사용합니다. HockeyApp 앱 ID는 App Center에서 사용할 수 있지만 다른 형식으로 변환해야 합니다. 식별자를 변환하려면 4개의 하이픈을 추가하여 표현을 가져와 8-4-4-4-12 야 합니다.

이전(HockeyApp): 00112233445566778899aabbccddeeff

이후(App Center): 00112233-4455-6677-8899-aabbccddeeff

2.2 애플리케이션 코드에서 SDK 초기화 바꾸기

이전 HockeyApp 등록 코드를 제거합니다. 문 선언에서 using 다음 줄을 제거합니다.
```
using Microsoft.HockeyApp;
```
App 클래스 생성자의 시작 부분에서 다음 줄을 제거합니다.
```
HockeyClient.Current.Configure("Your_App_ID");
```
App Center SDK를 시작합니다. API를 사용하기 전에 적절한 네임스페이스를 추가합니다.
```
using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;
```
애플리케이션의 생성자에 다음 호출을 추가합니다.
```
AppCenter.Start("{Your App Secret}",  typeof(Analytics), typeof(Crashes));
```

3. 서비스 및 기능 비교

핵심

기능	HockeyApp	App Center
로그 수준 조정	Yes	AppCenter.LogLevel

분석

기능	HockeyApp	App Center
세션 자동 추적	Yes	세션 및 디바이스 정보
속성이 있는 사용자 지정 이벤트	`HockeyClient.TrackEvent`	Analytics.TrackEvent

크래시

기능	HockeyApp	App Center
자동으로 크래시 보내기	기본적으로 사용하도록 설정됨	크래시 보고
추가 메타 데이터 연결	Yes	첨부 파일 추가
처리된 예외 추적	`HockeyClient.Current.TrackException`	처리된 오류

배포

App Center SDK는 아직 WPF/Winforms 앱에 대한 배포를 지원하지 않습니다.

피드백 서비스

피드백 서비스는 App Center에서 지원되지 않습니다. HockeyApp 피드백을 참조하세요.

Share via