Udostępnij za pośrednictwem

Migrowanie z zestawu HockeySDK do zestawu SDK usługi App Center dla oprogramowania Cordova

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Postępuj zgodnie z tą dokumentacją, jeśli chcesz zaktualizować aplikację do używania zestawu SDK centrum aplikacji zamiast zestawu HockeySDK.

1. Aktualizowanie bibliotek

1.1 Usuń stare HockeySDK

  1. Otwórz okno terminalu, przejdź do folderu projektu Cordova i wykonaj następujące polecenie:

    cordova plugin add cordova-plugin-appcenter-analytics

  2. Przejdź do folderu Twoje platformy > aplikacji > android > platform_www > plugins i usuń z niego plik cordova-plugin-hockeyapp.

1.2. Dodawanie nowego zestawu SDK centrum aplikacji

Zestaw SDK centrum aplikacji został zaprojektowany z modułowym podejściem — możesz zintegrować tylko te usługi, które cię interesują. Zobacz równoważności w następnej tabeli:

Moduł HockeyApp Moduł usługi App Center Zainstaluj polecenie
Crashes and Exceptions Crashes cordova plugin add cordova-plugin-appcenter-crashes
Metrics Analytics cordova plugin add cordova-plugin-appcenter-analytics

Uruchom jedno z poleceń, aby zainstalować potrzebny moduł (lub oba te polecenia).

2. Aktualizowanie kodu konfiguracji zestawu SDK

2.1 Konwertowanie identyfikatora aplikacji

Zestaw SDK centrum aplikacji używa identyfikatorów aplikacji w formacie globalnie unikatowego identyfikatora (GUID). Identyfikator aplikacji HockeyApp może być używany przez usługę App Center, ale musisz przekonwertować go na inny format. Aby przekonwertować identyfikator, należy dodać cztery łączniki, aby uzyskać reprezentację 8-4-4-4-12.

Przed (HockeyApp): 00112233445566778899aabbccddeeff

Po (App Center): 00112233-4455-6677-8899-aabbccddeeff

2.2 Zastępowanie inicjowania zestawu SDK w kodzie aplikacji

  1. Usuń inicjowanie usługi HockeyApp wewnątrz deviceready procedury obsługi:

    hockeyapp.start(null, null, "APP_ID");

  2. Konfigurowanie zestawu SDK centrum aplikacji

    Otwórz plik config.xml projektu Apache Cordova; dla każdego elementu docelowego platform projektu Apache Cordova (tylko systemy Android i iOS dzisiaj) dodaj element podrzędny preference w następującym formacie:

    <preference name="APP_SECRET" value="{App Secret from the previous step}" />

    Aby uzyskać więcej informacji, zapoznaj się z dokumentacją aplikacji App Center Cordova.

  3. Zastąp wszystkie wywołania interfejsu API hockeyApp w całej aplikacji. Szczegółowe tabele mapowania interfejsu API podano poniżej.

3. Porównanie usług i funkcji

Core

Cecha HockeyApp App Center
Identyfikowanie użytkowników hockeyapp.setUserName lub hockeyapp.setUserEmail AppCenter.setUserId

Analiza

Cecha HockeyApp App Center
Automatyczne śledzenie sesji Dokumentacja (nie można jej wyłączyć) Dokumentacja (domyślnie włączona)
Śledzenie zdarzeń hockeyapp.trackEvent Analytics.trackEvent

Ulega awarii

Cecha HockeyApp App Center
Automatyczne wysyłanie awarii AutoSend parametr (domyślnie wyłączony) APPCENTER_CRASHES_ALWAYS_SEND (domyślnie włączone)
Dołączanie dodatkowych metadanych hockeyapp.addMetaData Dokumentacja (można dołączyć z odbiornika)
Generowanie awarii testu hockeyapp.forceCrash AppCenter.Crash.generateTestCrash
Wyświetlanie okna dialogowego w przypadku awarii ignoreDefaultHandler (domyślnie wyłączone, tylko system Android) AppCenter.Crash.process (wywołanie zwrotne podczas przetwarzania awarii)

Aktualizacje wersji

Usługa dystrybucji usługi App Center nie jest jeszcze obsługiwana w zestawie SDK Cordova centrum aplikacji.

Usługa opinii

Usługa opinii nie będzie obsługiwana w Centrum aplikacji. Zobacz opinie HockeyApp.