Aracılığıyla paylaş

UWP/WinUI kullanmaya 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:

UWP projesi için:

  • Projeniz Visual Studio 2017 Güncelleştirme 15.9 veya sonraki sürümlerde ayarlanmıştır.
  • Windows 10 sürüm 16299 veya daha yeni bir sürümü çalıştıran cihazları hedefliyorsunuz.
  • Projeniz Evrensel Windows Platformu 6.2.8 veya sonraki bir sürüme başvurur (bu pakete genellikle örtük olarak başvurulur).
  • NuGet 4.3 veya üzeri.

WinUI projesi için:

  • Projeniz Visual Studio 2019 Güncelleştirme 16.9 veya sonraki sürümlerde ayarlanmıştır.
  • Windows 10 derleme 17763 veya üzerini çalıştıran cihazları hedefliyorsunuz.
  • Projeniz WinUI 3 0.8.0 veya sonraki bir sürüme başvurur.

Uyarı

UWP için Xamarin.Forms'u kullanmak istiyorsanız, bunun yerine Xamarin Kullanmaya başlama belgelerini izleyin.

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.

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

SDK'yı uygulamanıza tümleştirdiğinize göre artık SDK'yı başlatmanın ve App Center hizmetlerinden yararlanmanın zamanı geldi.

Uyarı

App Center SDK'sını taşınabilir bir projede ( Xamarin.Forms gibi) kullanıyorsanız, paketleri projelerin her birine yüklemeniz gerekir: taşınabilir, Android ve iOS olanlar. 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. Özelliği ekleyin Internet (Client)

Visual Studio çözüm gezgininde uygulamanızın Package.appxmanifest dosyasına çift tıklayın. Özellikler sekmesine tıklayın ve İnternet (İstemci) özelliğini denetleyin.

5. SDK'yi başlatın

App Center'ı kullanmak için kullanmak istediğiniz modülleri kabul etmeniz gerekir. 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.

5.1 Kullanım yönergelerini ekleme

API'lerimizi kullanmadan önce uygun ad alanlarını ekleyin.

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

5.2 Start() yöntemini ekleyin

Uygulamanızın oluşturucusunun aşağıdaki çağrısını ekleyin:

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)); 
}

5.3 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, SDK'nın otomatik olarak topladığı portalda Analytics'i 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 Crashes belgelerine bakın.