UWP/WinUI kullanmaya başlama

  • Makale

Önemli

Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.

Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.

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:

UWP projesi için:

  • Projeniz Visual Studio 2017 Güncelleştirme 15.9 veya sonraki sürümlerde ayarlanmıştır.
  • Derleme 16299 veya sonraki Windows 10 çalıştıran cihazları hedefliyorsunuz.
  • Projeniz 6.2.8 veya sonraki Evrensel Windows Platformu 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.
  • Derleme 17763 veya sonraki Windows 10 çalıştıran cihazları hedefliyorsunuz.
  • Projeniz WinUI 3 0.8.0 veya sonraki bir sürüme başvurur.

Not

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

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

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.

Not

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. Yeteneği ekleme 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 Kullanma 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 Yöntemini ekleme Start()

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

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

Uyarı

Uygulama Gizli Dizinizi kaynak koduna eklemeniz önerilmez.

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

5.3 Yer tutucuyu Uygulama Gizli Dizinizle değiştirme

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 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 Kilitlenmeleri belgelerine bakın.