Migrasi dari HockeySDK ke App Center WPF/Winforms

  • 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, bukan HockeySDK.

1. Perbarui pustaka

Ganti paket HockeySDK.WPF 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.WPF .
  • Cari App Center, dan instal paket Microsoft.AppCenter.Analytics, dan Microsoft.AppCenter.Crashes .

Konsol Manajer Paket

  • Buka konsol di Visual Studio. Untuk melakukan ini, 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.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

App Center SDK menggunakan pendekatan modular – Anda dapat memilih layanan mana yang ingin Anda integrasikan. Anda harus menambahkan setiap modul SDK sebagai dependensi terpisah di bagian ini.

2. Memperbarui 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 (App Center): 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. Layanan dan perbandingan 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 Menambahkan Lampiran
Melacak pengecualian yang ditangani HockeyClient.Current.TrackException Kesalahan yang Ditangani

Distribusi

App Center SDK belum mendukung distribusi untuk aplikasi WPF/Winforms.

Layanan Umpan Balik

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