Migrasi dari HockeySDK ke UWP App Center

  • Artikel

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

Ikuti dokumentasi ini jika Anda ingin memperbarui aplikasi untuk menggunakan App Center SDK alih-alih HockeySDK.

1. Perbarui pustaka

Catatan

Platform seperti WinRT, Windows Phone 8.0 dan 8.1, WPF dan PCL tidak didukung di App Center SDK. Anda dapat terus menggunakan HockeySDK dengan mereka.

Ganti paket HockeySDK.UWP NuGet dengan paket App Center di semua proyek dalam solusi Anda.

Visual Studio untuk Windows

  • Buka Visual Studio untuk Windows.
  • Klik Buka File> dan pilih solusi Anda.
  • Di navigator solusi, klik kanan Referensi dan pilih Kelola Paket NuGet.
  • Hapus paket HockeySDK.UWP .
  • Cari App Center, dan instal paket Microsoft.AppCenter.Analytics, dan Microsoft.AppCenter.Crashes .

Konsol Manajer Paket

  • Buka konsol di Visual Studio. Untuk melakukannya, pilih Alat>NuGet Package Manager>Package Manager Console.
  • Jika Anda bekerja di Visual Studio untuk Mac, pastikan Anda telah menginstal Ekstensi Manajemen Paket NuGet. Untuk ini, pilihEkstensiVisual Studio>, cari NuGet dan instal, jika perlu.
  • Ketik perintah berikut di konsol:
Uninstall-Package HockeySDK.UWP
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

App Center SDK menggunakan pendekatan modular – Anda hanya dapat mengintegrasikan layanan yang Anda minati. Anda harus menambahkan setiap modul SDK sebagai dependensi terpisah di bagian ini.

2. Perbarui kode penyiapan SDK

2.1 Mengonversi pengidentifikasi aplikasi

App Center SDK menggunakan pengidentifikasi aplikasi dalam format pengidentifikasi unik global (GUID). ID Aplikasi HockeyApp Anda dapat digunakan oleh App Center tetapi Anda perlu mengonversinya ke format yang berbeda. Untuk mengonversi pengidentifikasi, Anda harus menambahkan empat tanda hubung untuk mendapatkan 8-4-4-4-12 representasi.

Sebelum (HockeyApp):

00112233445566778899aabbccddeeff

Setelah (Pusat Aplikasi):

00112233-4455-6677-8899-aabbccddeeff

2.2 Mengganti inisialisasi SDK dalam kode aplikasi

  1. Hapus kode pendaftaran HockeyApp lama.

    using Dalam deklarasi pernyataan, hapus baris berikut:

    using Microsoft.HockeyApp;

    Di awal konstruktor kelas Aplikasi, hapus baris berikut:

    HockeyClient.Current.Configure("Your_App_ID");

  2. Mulai SDK App Center.

    Tambahkan namespace yang sesuai sebelum Anda menggunakan API kami.

    using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

    Tambahkan panggilan berikut ke konstruktor aplikasi Anda:

    AppCenter.Start("{Your App Secret}",  typeof(Analytics), typeof(Crashes));

3. Perbandingan layanan dan fitur

Core

Fitur HockeyApp Pusat Aplikasi
Menyesuaikan tingkat log Ya AppCenter.LogLevel

Analitik

Fitur HockeyApp Pusat Aplikasi
Melacak sesi secara otomatis Ya Informasi Sesi dan Perangkat
Peristiwa kustom dengan properti HockeyClient.TrackEvent Analytics.TrackEvent

Crash

Fitur HockeyApp Pusat Aplikasi
Mengirim crash secara otomatis Diaktifkan secara default Pelaporan Gangguan
Melampirkan data meta tambahan Ya Tidak didukung
Melacak pengecualian yang ditangani HockeyClient.Current.TrackException Tidak didukung

Distribusi

App Center SDK belum mendukung distribusi untuk aplikasi UWP.

Layanan Umpan Balik

Layanan umpan balik tidak akan didukung di App Center. Lihat Umpan balik HockeyApp.