다음을 통해 공유


HockeySDK에서 Unity용 App Center SDK로 마이그레이션

중요

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

지원 타임라인 및 대안에 대해 자세히 알아보세요.

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

1. 라이브러리 업데이트

1.1 이전 HockeySDK 제거

  1. 설정 아이콘 > 구성 요소 제거를 클릭하여 SDK에 대해 만든 게임 개체를 선택하고 구성 요소를 제거HockeyAppAndroid / HockeyAppiOS합니다.

  2. Unity 프로젝트 내의 Assets 폴더에서 HockeyAppUnityAndroid / HockeyAppUnityiOS 폴더를 제거합니다.

1.2 새 App Center SDK 추가

App Center SDK는 Unity 패키지를 프로젝트로 가져와 통합됩니다. 이렇게 하려면 먼저 App Center Unity 편집기 확장 플러그 인을 설치합니다. Unity 메뉴: >앱 센터>편집기 확장을 통해 편집기 확장을 열고 App Center SDK 설치를 선택합니다.

App Center SDK는 모듈식 접근 방식으로 설계되었으며 관심 있는 서비스만 통합할 수 있습니다. 다음 표의 동등성을 참조하세요.

HockeyApp 모듈 App Center 모듈
Crashes and Exceptions Crashes
Metrics Analytics
Version Updates Distribute

서비스를 별도로 설치하려면 각 탭에서 SDK 설치 를 선택할 수 있습니다.

참고

App Center Unity SDK는 Android, iOS 및 UWP의 세 가지 플랫폼 모두에 대한 것입니다. 각 SDK를 별도로 설치할 필요는 없습니다.

App Center Unity SDK를 통합하는 권장 방법은 App Center 편집기 확장을 사용하는 것이지만 다른 시나리오를 지원합니다. 자세한 내용은 App Center Unity 설명서를 참조하세요.

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 구성

App Center 스크립트 연결

프로젝트 창에서 프로젝트에 추가된 AppCenter 폴더로 이동합니다. App Center 로고가 아이콘 AppCenterBehavior인 스크립트를 찾아 이전에 HockeySDK에 사용했던 게임 개체로 끕니다.

App Center 설정 구성

이 게임 개체를 클릭하면 검사기 창에 App Center 구성이 표시됩니다.

App Center 스크립트 구성

아래에 제공된 자세한 구성 매핑 테이블을 사용하여 추가 정보를 입력합니다.

3. 서비스 및 기능 비교

HockeyApp 설정 App Center 설정 참고
앱 ID Android/iOS 앱 비밀 이전 단계에서 변환한 앱 ID 사용
서버 URL 사용자 지정 로그 URL, 기타 설정 섹션 사용자 지정 로그 URL 사용 확인
제한된 앱 내 업데이트 해당 없음 Distribute.UpdateTrack
크래시 및 예외(기본적으로 사용) 크래시 사용 크래시 모듈
자동 업로드 충돌 NA(기본적으로 사용) 설명서(기본적으로 사용하도록 설정, 구성할 수 있음)
예외 로깅 초기 로그 수준, 기타 설정 섹션 더 자세한 로깅을 원하는 경우 를 사용합니다. Verbose
사용자 메트릭 분석 사용 분석 모듈
버전 업데이트(기본적으로 사용) 배포 사용 모듈 배포
경고 업데이트 해당 없음 설명서(구성해야 함)

참고

프로젝트가 설정에 나열된 세 개의 플랫폼 중 하나를 지원하지 않는 경우 앱 비밀 필드를 있는 그대로 둡니다. 영향을 주지 않습니다. 프로젝트에서 App Center에서 지원하지 않는 플랫폼을 지원하는 경우 API 및 구성은 해당 플랫폼에 영향을 주지 않습니다.

프로젝트에 애플리케이션 전체에서 HockeySDK API 호출이 있는 경우 아래에 제공된 자세한 API 매핑 테이블을 사용하여 바꿉니다.

기능 HockeyApp App Center
속성을 사용하여 사용자 지정 이벤트 HockeyAppIOS.TrackEvent 또는 HockeyAppAndroid.TrackEvent Analytics.TrackEvent
업데이트에 대해 명시적으로 검사 HockeyAppIOS.CheckForUpdate 또는 HockeyAppAndroid.CheckForUpdate Distribute.CheckforUpdate
피드백 양식 표시 HockeyAppIOS.ShowFeedbackForm 또는 HockeyAppAndroid.ShowFeedbackForm NA(아래 섹션 참조)

피드백 서비스

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