Aracılığıyla paylaş

WPF/WinForms ile Çalışmaya Başlama

Önemli

Visual Studio App Center, 30 Haziran 2026'ya kadar desteklenmeye devam edecek Analiz ve Tanılama özellikleri dışında 31 Mart 2025'te kullanımdan kaldırılmıştır. Daha fazla bilgi edinin.

App Center SDK'sı modüler bir mimari kullanır, böylece hizmetlerin herhangi birini veya tümünü kullanabilirsiniz.

Uygulamanızda App Center Analytics ve App Center Çökmelerini kullanmak için App Center SDK'sını ayarlamaya başlayalım.

1. Önkoşullar

Başlamadan önce aşağıdaki önkoşulların karşılandığından emin olun:

  • Projeniz .NET Framework 4.6.2 (veya üzeri) veya .NET Core 3.1 (veya üzeri) hedefleniyor.
  • .NET Core yalnızca WPF/WinForms uygulaması Windows üzerinde çalıştığında desteklenir.
  • SDK'yı taşınabilir bir kitaplıktan kullanıyorsanız , .NET standard 2.0 veya üstünü hedeflemelidir (PCL desteklenmez).
  • PackageReference proje türü. Bu gereksinim, SQLitePCL.raw kütüphanesinden gelir. adresinde daha fazla bilgi bulabilirsiniz https://github.com/ericsink/SQLitePCL.raw/issues/537.
  • SDK'nın VSTO projelerine tümleştirilmesiyle ilgili bilinen bir sorun vardır. Daha fazla ayrıntı için adresini ziyaret edin https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Uygulama Sırrını almak için Uygulamanızı App Center Portalı'nda oluşturmak için

Uygulamanızı App Center portalında zaten oluşturduysanız bu adımı atlayabilirsiniz.

  1. Kaydolun veya oturum açın ve portalın sağ üst köşesindeki Yeni ekle yazan mavi düğmeye basın ve açılan menüden Yeni uygulama ekle'yi seçin.
  2. Uygulamanız için bir ad ve isteğe bağlı bir açıklama girin.
  3. Yukarıda açıklandığı gibi projenize bağlı olarak uygun işletim sistemini ve platformu seçin.
  4. Sağ alttaki Yeni uygulama ekle yazan düğmeye basın.

Bir uygulama oluşturduktan sonra Uygulama Gizli Dizisini App Center Portalı'nın Ayarlar sayfasından edinebilirsiniz. Ayarlar sayfasının sağ üst köşesinde üç dikey noktalı simgeye tıklayın ve seçerek Uygulama Gizli Kodunuzu alın.

3. App Center SDK modüllerini ekleme

App Center SDK'sı Visual Studio veya Paket Yöneticisi Konsolu kullanılarak tümleştirilebilir.

Uyarı

App Center SDK, güçlü adlandırılmış imzayı kullanan uygulamalarla uyumluluk için güçlü adlandırılmış derlemeler kullanır.

Visual Studio

  • Visual Studio'yu açın.
  • Dosya>Aç'a tıklayın ve çözümünüzü seçin.
  • Çözüm gezgininde Başvurular'a sağ tıklayın ve NuGet Paketlerini Yönet'i seçin.
  • Gözat sekmesindeApp Center'ı arayın ve Microsoft.AppCenter.Analytics ve Microsoft.AppCenter.Crashes paketlerini yükleyin.

Paket Yöneticisi Konsolu

  • Konsolunu Visual Studio'da açın. Bunu yapmak için Araçlar>NuGet Paket Yöneticisi Paket Yöneticisi>Konsolu'nu seçin.
  • Aşağıdaki komutları yazın:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Uyarı

App Center SDK'sını taşınabilir bir projede kullanıyorsanız, paketleri projelerin her birine yüklemeniz gerekir: taşınabilir ve WPF/WinForms uygulamasını çalıştıran proje. Bunu yapmak için her alt projeyi açmanız ve Visual Studio bölümünde açıklanan ilgili adımları izlemeniz gerekir.

4. SDK'yi başlatın

App Center'ı kullanmak için kullanmak istediğiniz modülleri kabul edin. Varsayılan olarak hiçbir modül başlatılmaz ve SDK'yı başlatırken bunların her birini açıkça çağırmanız gerekir.

4.1 Yöntemini ekleme Start()

WPF (Windows Presentation Foundation)

WPF uygulamanız için App.xaml.cs öğesini değiştirin ve aşağıdaki using deyimlerini ekleyin:

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

Ardından aynı dosyada, OnStartup yöntemine aşağıdaki kodu ekleyin:

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

Dosyada App.xaml.csOnStartup yöntemi yoksa Application.OnStartup(StartupEventArgs) yöntemini ekleyebilirsiniz. Dosyanız App.xaml.cs şuna benzer olmalıdır:

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

Uyarı

Uygulama Sırrınızı kaynak koduna yerleştirmek önerilmez.

App Center hizmetlerini ayrı olarak başlatmanız gerekiyorsa şunları yapmanız gerekir:

  1. Uygulama Gizli Anahtarı ile yapılandırın veya başlatın.
  2. Kod birden çok kez çağrılabiliyorsa App Center'ın zaten yapılandırılmış olup olmadığını denetleyin.
  3. Uygulama Gizli Anahtarı olmadan gerekli hizmetleri başlatın.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

WinForms

WinForms uygulamanız için Program.cs dosyasını değiştirmeniz ve aşağıdaki using ifadelerini eklemeniz:

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

Ardından aynı dosyada, Main yöntemine, Application.Run deyiminden önce aşağıdaki kodu ekleyin.

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

App Center hizmetlerini ayrı olarak başlatmanız gerekiyorsa şunları yapmanız gerekir:

  1. Uygulama Gizli Anahtarı ile yapılandırın veya başlatın.
  2. Kod birden çok kez çağrılabiliyorsa App Center'ın zaten yapılandırılmış olup olmadığını denetleyin.
  3. Uygulama Gizli Anahtarı olmadan gerekli hizmetleri başlatın.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

Uyarı

Uygulama Sırrınızı kaynak koduna yerleştirmek önerilmez.

4.2 Yer tutucuyu Uygulama Gizli Anahtarınızla değiştirin

{Your App Secret} metnini uygulamanız için gerçek değerle değiştirdiğinizden emin olun. Uygulama Gizli Anahtarı, App Center portalında Başlarken veya Ayarlar sayfasında bulunabilir.

Başlarken sayfasında, uygulama gizli anahtarınızı içeren yukarıdaki kod örneği bulunmaktadır. Kodun tamamını kopyalayıp yapıştırabilirsiniz.

Yukarıdaki örnekte yönteminin Start() nasıl kullanılacağı gösterilmektedir ve App Center Analytics'i içerir.

Her hizmeti açıkça başlangıç yönteminde parametre olarak belirtmediğiniz sürece, bu App Center hizmetini kullanamazsınız. Buna ek olarak, API uygulamanızın Start() yaşam döngüsünde yalnızca bir kez kullanılabilir; diğer tüm çağrılar konsola bir uyarı kaydeder ve yalnızca ilk çağrıya dahil edilen hizmetler kullanılabilir.

Harika, artık SDK'nın otomatik olarak topladığı verileri portalda görüntülemeye hazırsınız.

Her iki hizmetin de daha gelişmiş işlevlerini özelleştirmeyi ve kullanmayı öğrenmek için App Center Analytics ve App Center Crashes belgelerine bakın.