다음을 통해 공유

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

  • 아티클

중요

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

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

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

1. 라이브러리 업데이트

1.1 이전 HockeySDK 제거

설명서

SDK를 수동으로 추가한 경우 다음 단계를 수행합니다.

  1. XCode 프로젝트에서 참조를 제거 HockeySDK.framework 합니다. 참조 제거 단추를 클릭하고 휴지통으로 이동 단추를 클릭하지 마세요.

  2. 프로젝트 설정을 열고 헤더 검색 경로프레임워크 검색 경로 / 섹션의 빌드 설정 탭에서 HockeySDK와 관련된 헤더 파일의 위치를 제거합니다.

  3. 프로젝트 설정을 열고 라이브러리와 이진 연결 섹션의 빌드 단계 탭에서 HockeySDK와 관련된 종속성 항목을 제거합니다.

  4. 파일 시스템에서 삭제 HockeySDK.framework 합니다.

Podfile

CocoaPods를 사용하여 SDK를 추가한 경우 Podfile에서 줄을 제거 pod "HockeySDK-tvOS" 한 다음 를 실행pod install합니다.

Carthage

  1. 에서 CartfileHockeySDK 참조를 제거합니다. 파일 시스템에서 삭제 Cartfile.Resolved 합니다.

  2. XCode 프로젝트에서 및 HockeySDK.framework.dSYM 를 삭제 HockeySDK.framework 하고 휴지통으로 이동 단추를 클릭합니다.

  3. 빌드 단계 탭을 열고 스크립트 실행 섹션을 찾습니다. 및 output.xcfilelist에서 HockeyApp을 input.xcfilelist 제거합니다.

1.2 새 App Center SDK 추가

App Center SDK는 Cocoapods, Carthage, Swift 패키지 관리자 및 Xcode 프로젝트의 프레임워크를 사용하여 통합을 지원합니다. App Center SDK 설명서에서 App Center SDK를 통합하는 방법에 대한 자세한 지침을 읽어보세요.

참고

App Center SDK는 모든 서비스를 사용할 수 있도록 모듈식 접근 방식으로 설계되었습니다. 다음 표의 동등성을 참조하세요.

HockeyApp 클래스 App Center 모듈
MetricsManager Analytics
CrashManager Crashes

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

  1. AppDelegate 클래스에서 다음 가져오기를 바꿉니다.

    이전:

    @import HockeySDK;

    import HockeySDK

    이후:

    @import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. 등록 코드 바꾸기

    메서드를 didFinishLaunchingWithOptions 찾고 HockeyApp 코드 발생을 바꿉니다.

    이전:

    [[BITHockeyManager sharedHockeyManager] configureWithIdentifier:@"APP_IDENTIFIER"];
[[BITHockeyManager sharedHockeyManager] startManager];

    BITHockeyManager.shared().configure(withIdentifier: "APP_IDENTIFIER")
BITHockeyManager.shared().start()

    이후:

    [MSACAppCenter start:@"{Your app secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

    AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

  3. 애플리케이션 전체에서 HockeyApp API 호출을 대체합니다. 자세한 API 매핑 테이블은 아래에 제공됩니다.

3. 서비스 및 기능 비교

핵심

기능 HockeyApp App Center
로그 수준 조정 [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

분석

HockeySDK는 기본적으로 메트릭을 수집합니다. App Center SDK는 기본적으로 (분석) 메트릭을 수집하지 않습니다. App Center SDK를 사용하여 메트릭을 수집하려면 메서드에 전달 MSACAnalytics 합니다 start: .

기능 HockeyApp App Center
세션 자동 추적 기본적으로 사용하도록 설정됨 설명서(기본적으로 사용)
속성을 사용하여 사용자 지정 이벤트 Yes [MSACAnalytics trackEvent:withProperties:]
런타임 시 서비스 사용 안 함 [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled:NO]

크래시

HockeySDK는 기본적으로 크래시를 보고합니다. 다음에 앱을 시작할 때 크래시가 즉시 서버로 전송됩니다. App Center SDK는 기본적으로 충돌을 보고하지 않습니다. App Center SDK를 사용하여 크래시를 수집하려면 메서드에 전달 MSACCrashes 합니다 start: .

기능 HockeyApp App Center
자동으로 크래시 보내기 기본적으로 사용하도록 설정됨 설명서(기본적으로 사용)
테스트 크래시 생성 [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
이전 크래시 정보 [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
추가 메타 데이터 연결 Yes 설명서(대리자에서 첨부할 수 있습니다)
사용자 사용자 지정 대화 상자 setCrashReportUIHandler 설명서(기본적으로 제공되지 않음)
런타임 시 서비스 사용 안 함 [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]