HockeySDK에서 Unity용 App Center SDK로 마이그레이션
중요
Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. Visual Studio App Center가 완전히 사용 중지될 때까지 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.
HockeySDK 대신 App Center SDK를 사용하도록 애플리케이션을 업데이트하려는 경우 이 설명서를 따릅니다.
1. 라이브러리 업데이트
1.1 이전 HockeySDK 제거
설정 아이콘 > 구성 요소 제거를 클릭하여 SDK에 대해 만든 게임 개체를 선택하고 구성 요소를 제거
HockeyAppAndroid/HockeyAppiOS합니다.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 구성이 표시됩니다.
아래에 제공된 자세한 구성 매핑 테이블을 사용하여 추가 정보를 입력합니다.
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 피드백을 참조하세요.