WPF/WinForms kullanmaya başlama

App Center SDK'sı modüler bir mimari kullanarak hizmetlerin herhangi birini veya tümünü kullanabilirsiniz.

Uygulamanızda App Center Analytics ve App Center Kilitlenmelerini 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) ya da .NET Core 3.1 'i (veya üzerini) hedefliyor.
• .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 üzerini hedeflemelidir (PCL desteklenmez).
• PackageReference proje türü. Bu gereksinim kitaplıktan SQLitePCL.raw gelir. adresinde daha fazla bilgi bulabilirsiniz https://github.com/ericsink/SQLitePCL.raw/issues/537.
• SDK'nın VSTO projelerine tümleştirilmesinde bilinen bir sorun vardır. Diğer ayrıntılar için lütfen https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/ adresini ziyaret edin.

2. Uygulama Gizli Dizisini almak için uygulamanızı App Center Portalı'nda oluşturun

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 Dizisi'ni App Center Portalı'nın Ayarlar sayfasından edinebilirsiniz. Ayarlar sayfasının sağ üst köşesindeki üç dikey noktaya tıklayın ve Uygulama Gizli Dizinizi almak için öğesini seçinCopy app secret.

3. App Center SDK modüllerini ekleme

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

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 ile Microsoft.AppCenter.Crashes paketlerini yükleyin.

Paket Yöneticisi Konsolu

• Visual Studio'da konsolunu 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

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

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

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

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

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

Dosyada App.xaml.csOnStartup yöntemi yoksa yöntemini ekleyebilirsiniz Application.OnStartup(StartupEventArgs) . 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));
    }
  }
}

App Center hizmetlerini ayrı olarak başlatmanız gerekiyorsa şunları yapmalısınız:

1. Uygulama Gizli Dizisi'ni 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 dosyayı değiştirin Program.cs ve aşağıdaki using deyimlerini ekleyin:

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

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

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

App Center hizmetlerini ayrı olarak başlatmanız gerekiyorsa şunları yapmalısınız:

1. Uygulama Gizli Dizisi'ni 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)); 
}

4.2 Yer tutucuyu Uygulama Gizli Dizinizle değiştirin

Metni uygulamanızın gerçek değeriyle değiştirdiğinden {Your App Secret} emin olun. Uygulama Gizli Dizisi, App Center portalındaki Başlarken sayfasında veya Ayarlar sayfasında bulunabilir.

Başlarken sayfası, uygulama gizli dizinizin bulunduğu yukarıdaki kod örneğini içerir; örneğin 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 start yönteminde parametre olarak açıkça 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, SDK'nın otomatik olarak topladığı portalda kilitlenmeleri görselleştirmeye 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 Kilitlenmeleri belgelerine bakın.