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

아티클
03/15/2024

중요

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

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

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

1. 라이브러리 업데이트

1.1 이전 HockeySDK 제거

터미널 창을 열고 Cordova 프로젝트 폴더로 이동한 후 다음 명령을 실행합니다.
```
cordova plugin add cordova-plugin-appcenter-analytics
```
앱 플랫폼 > android > platform_www > 플러그 인 폴더로 이동하고 해당 폴더에서 cordova-plugin-hockeyapp을 삭제합니다>.

1.2 새 App Center SDK 추가

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

HockeyApp 모듈	App Center 모듈	설치 명령
`Crashes and Exceptions`	`Crashes`	`cordova plugin add cordova-plugin-appcenter-crashes`
`Metrics`	`Analytics`	`cordova plugin add cordova-plugin-appcenter-analytics`

명령 중 하나를 실행하여 필요한 모듈(또는 둘 다)을 설치합니다.

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 초기화 바꾸기

처리기 내에서 deviceready HockeyApp 초기화를 제거합니다.
```
hockeyapp.start(null, null, "APP_ID");
```
App Center SDK 구성

Apache Cordova 프로젝트의 config.xml 파일을 엽니다. Apache Cordova 프로젝트의 각 대상 platform 요소(현재 Android 및 iOS만 해당)에 대해 다음 형식으로 자식 preference 요소를 추가합니다.
```
<preference name="APP_SECRET" value="{App Secret from the previous step}" />
```
자세한 내용은 App Center Cordova 설명서를 참조하세요.
애플리케이션 전체에서 모든 HockeyApp API 호출을 대체합니다. 자세한 API 매핑 테이블은 아래에 제공됩니다.

3. 서비스 및 기능 비교

핵심

기능	HockeyApp	App Center
사용자 식별	hockeyapp.setUserName 또는 hockeyapp.setUserEmail	AppCenter.setUserId

분석

기능	HockeyApp	App Center
세션 자동 추적	설명서(사용하지 않도록 설정할 수 없음)	설명서(기본적으로 사용)
이벤트 추적	hockeyapp.trackEvent	Analytics.trackEvent

크래시

기능	HockeyApp	App Center
자동으로 크래시 보내기	autoSend 매개 변수(기본적으로 사용하지 않도록 설정됨)	APPCENTER_CRASHES_ALWAYS_SEND(기본적으로 사용)
추가 메타 데이터 연결	hockeyapp.addMetaData	설명서(수신기에서 첨부할 수 있음)
테스트 크래시 생성	hockeyapp.forceCrash	AppCenter.Crashes.generateTestCrash
충돌 시 대화 상자 표시	ignoreDefaultHandler(기본적으로 사용하지 않도록 설정됨, Android만 해당)	AppCenter.Crashs.process(크래시 처리 시 콜백)

버전 업데이트

App Center 배포 서비스는 App Center Cordova SDK에서 아직 지원되지 않습니다.

피드백 서비스

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

다음을 통해 공유