Mulai menggunakan WPF/WinForms

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.

• Android
• iOS
• Ekstensi iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• Ekstensi macOS
• tvOS
• Cordova

App Center SDK menggunakan arsitektur modular sehingga Anda dapat menggunakan salah satu atau semua layanan.

Mari kita mulai menyiapkan App Center SDK di aplikasi Anda untuk menggunakan App Center Analytics dan App Center Crash.

1. Prasyarat

Sebelum memulai, pastikan prasyarat berikut terpenuhi:

• Proyek Anda menargetkan .NET Framework 4.6.2 (atau lebih tinggi) atau .NET Core 3.1 (atau lebih tinggi).
• .NET Core hanya didukung ketika aplikasi WPF/WinForms berjalan di Windows.
• Jika Anda menggunakan SDK dari pustaka portabel, SDK harus menargetkan .NET standar 2.0 atau yang lebih tinggi (PCL tidak didukung).
• Jenis proyek PackageReference. Persyaratan ini berasal dari SQLitePCL.raw pustaka. Informasi selengkapnya di https://github.com/ericsink/SQLitePCL.raw/issues/537.
• Ada masalah yang diketahui saat mengintegrasikan SDK ke dalam proyek VSTO. Untuk detail selengkapnya, silakan kunjungi https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Buat aplikasi Anda di Portal App Center untuk mendapatkan Rahasia Aplikasi

Jika Anda telah membuat aplikasi di portal App Center, Anda dapat melewati langkah ini.

1. Daftar atau masuk dan tekan tombol biru di sudut kanan atas portal yang bertuliskan Tambahkan baru dan pilih Tambahkan aplikasi baru dari menu dropdown.
2. Masukkan nama dan deskripsi opsional untuk aplikasi Anda.
3. Pilih OS dan platform yang sesuai tergantung pada proyek Anda seperti yang dijelaskan di atas.
4. Tekan tombol di kanan bawah yang bertuliskan Tambahkan aplikasi baru.

Setelah membuat aplikasi, Anda dapat memperoleh Rahasia Aplikasi di halaman Pengaturan di Portal App Center. Di sudut kanan atas halaman Pengaturan , klik tiga titik vertikal dan pilih Copy app secret untuk mendapatkan Rahasia Aplikasi Anda.

3. Tambahkan modul App Center SDK

App Center SDK dapat diintegrasikan menggunakan Visual Studio, atau Package Manager Console.

Catatan

App Center SDK menggunakan rakitan bernama kuat untuk kompatibilitas dengan aplikasi yang menggunakan tanda bernama kuat.

Visual Studio

• Buka Visual Studio.
• Klik Buka File> dan pilih solusi Anda.
• Di navigator solusi, klik kanan Referensi dan pilih Kelola Paket NuGet.
• Di tab Telusuri, Cari Pusat Aplikasi, 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.
• Ketikkan perintah berikut:

Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Catatan

Jika Anda menggunakan App Center SDK dalam proyek portabel, Anda harus menginstal paket di setiap proyek: portabel, dan proyek yang menjalankan aplikasi WPF/WinForms. Untuk melakukannya, Anda harus membuka setiap sub-proyek dan mengikuti langkah-langkah terkait yang dijelaskan di bagian Visual Studio .

4. Mulai SDK

Untuk menggunakan App Center, pilih modul yang ingin Anda gunakan. Secara default tidak ada modul yang dimulai dan Anda harus secara eksplisit memanggil masing-masing modul saat memulai SDK.

4.1 Tambahkan Start() metode

WPF

Untuk aplikasi WPF Anda, ubah App.xaml.cs dan tambahkan pernyataan berikut:

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

Kemudian dalam file yang sama, tambahkan kode berikut dalam OnStartup metode :

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

App.xaml.cs Jika file tidak memiliki OnStartup metode , Anda dapat menambahkan Application.OnStartup(StartupEventArgs) metode . File Anda App.xaml.cs akan terlihat seperti:

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
    }
  }
}

Peringatan

Tidak disarankan untuk menyematkan Rahasia Aplikasi Anda dalam kode sumber.

Jika Anda perlu memulai layanan App Center secara terpisah, Anda harus:

1. Mengonfigurasi atau memulainya dengan Rahasia Aplikasi.
2. Jika kode dapat dipanggil beberapa kali, periksa apakah App Center sudah dikonfigurasi.
3. Mulai layanan yang diperlukan tanpa Rahasia Aplikasi.

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

WinForms

Untuk aplikasi WinForms Anda, ubah Program.cs file dan tambahkan pernyataan berikut:

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

Kemudian dalam file yang sama, tambahkan kode berikut dalam Main metode , sebelum Application.Run pernyataan .

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

Jika Anda perlu memulai layanan App Center secara terpisah, Anda harus:

1. Mengonfigurasi atau memulainya dengan Rahasia Aplikasi.
2. Jika kode dapat dipanggil beberapa kali, periksa apakah App Center sudah dikonfigurasi.
3. Mulai layanan yang diperlukan tanpa Rahasia Aplikasi.

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

Peringatan

Tidak disarankan untuk menyematkan Rahasia Aplikasi Anda dalam kode sumber.

4.2 Ganti tempat penampung dengan Rahasia Aplikasi Anda

Pastikan untuk mengganti {Your App Secret} teks dengan nilai aktual untuk aplikasi Anda. Rahasia Aplikasi dapat ditemukan di halaman Memulai atau halaman Pengaturan di portal Pusat Aplikasi.

Halaman Memulai berisi sampel kode di atas dengan Rahasia Aplikasi Anda di dalamnya, Anda dapat menyalin-menempelkan seluruh sampel.

Contoh di atas menunjukkan cara menggunakan Start() metode dan menyertakan App Center Analytics.

Kecuali Anda secara eksplisit menentukan setiap layanan sebagai parameter dalam metode mulai, Anda tidak dapat menggunakan layanan App Center tersebut. Selain itu, Start() API hanya dapat digunakan sekali dalam siklus hidup aplikasi Anda - semua panggilan lain akan mencatat peringatan ke konsol dan hanya layanan yang disertakan dalam panggilan pertama yang akan tersedia.

Bagus, Anda siap untuk memvisualisasikan crash di portal yang dikumpulkan SDK secara otomatis.

Lihat dokumentasi untuk App Center Analytics dan App Center Crash untuk mempelajari cara menyesuaikan dan menggunakan fungsionalitas yang lebih canggih dari kedua layanan.