Diğer WPF ve WinForms API'leri

Makale
03/17/2024

Ö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.

Günlük düzeyini ayarlama

Konsolunda App Center'dan görünen günlük iletilerinin miktarını denetleyebilirsiniz. Hata ayıklama sırasında LogLevel ek günlüğe kaydetmeyi etkinleştirmek için API'yi kullanın. Varsayılan olarak, App Store ortamları için olarak ayarlanır ASSERT ve WARN aksi halde ayarlanır.

Mümkün olduğunca çok günlük iletisine sahip olmak için kullanın LogLevel.Verbose.

AppCenter.LogLevel = LogLevel.Verbose;

Yüklemeleri tanımlama

App Center SDK'sı, uygulama yüklendikten sonra her cihaz için bir UUID oluşturur. Bu tanımlayıcı, uygulama güncelleştirildiğinde cihaz için aynı kalır ve yalnızca uygulama yeniden yüklendiğinde yeni bir tanımlayıcı oluşturulur. Aşağıdaki API hata ayıklama amacıyla yararlıdır.

System.Guid? installId = await AppCenter.GetInstallIdAsync();

Kullanıcıları tanımlama

App Center SDK'sı, kilitlenme raporlarını artırmak için kullanılan bir kullanıcı kimliği ayarlamayı destekler. Bu özelliği kullanmak için:

App Center SDK'sını, App Center SDK'sını Kullanmaya başlama kılavuzunda açıklandığı gibi çağırarak AppCenter.Start(...) yapılandırın.
Aşağıdaki kodu kullanarak SDK'da bir userID ayarlayın:

AppCenter.SetUserId("your-user-id");

Kullanıcı kimliğini ayarladıktan sonra App Center'ın arama özelliğini kullanarak kimliğin belirli kilitlenme raporlarını arayabilirsiniz. App Center'ın arama belgelerinde daha fazla bilgi edinin.

Not

Kullanıcı kimliği değeri 256 karakterle sınırlıdır. Kilitlenme raporlarınızla birlikte gösterilir, ancak toplama veya etkilenen kullanıcıların sayısı için kullanılmaz. Kullanıcı kimliğini birden çok kez ayarlarsanız, yalnızca son kullanıcı kimliği kullanılır. Bu değer başlatmalar arasında SDK tarafından depolanmadığından, her uygulama başlatılmadan önce kullanıcı kimliğini kendiniz ayarlamanız gerekir.

Çalışma zamanında tüm hizmetleri devre dışı bırakma

Tüm App Center hizmetlerini aynı anda devre dışı bırakmak istiyorsanız özelliğini kullanın Enabled . Sdk devre dışı bırakıldığında App Center'a hiçbir bilgi iletmez.

AppCenter.SetEnabledAsync(false);

Tüm hizmetleri aynı anda etkinleştirmek için aynı API'yi kullanın ancak parametre olarak geçirin true .

AppCenter.SetEnabledAsync(true);

Diğer API çağrılarını (örneğin IsEnabledAsync) tutarlı hale getirmek için bu çağrıyı beklemeniz gerekmez.

Durum, uygulama başlatmaları arasında cihazın depolama alanında kalıcı hale geldi.

Çalışma zamanında hizmetin durumunu değiştirme

Çalışma zamanında aşağıdaki kodla hizmetleri etkinleştirin veya devre dışı bırakın:

Analytics.SetEnabledAsync(false);

Ağ isteklerine izin verme

App Center SDK'sında ağ isteklerine varsayılan olarak izin verilir. App Center SDK'sının kullanıcı tarafından topladığı verileri göndermek istiyorsanız otomatik veri göndermeye izin verilmiyebilirsiniz.

AppCenter.IsNetworkRequestsAllowed = false;

Bu durumda App Center SDK'sı veri toplamaya devam eder ancak yalnızca ağ isteklerine izin verildiğinde gönderilir.

AppCenter.IsNetworkRequestsAllowed = true;

Not

Bu değer başlangıçlar arasında korunur.

İstediğiniz zaman App Center SDK'sında veri göndermeye izin verilip verilmeyeceğini de kontrol edebilirsiniz.

AppCenter.IsNetworkRequestsAllowed;

App Center'ın etkin olup olmadığını denetleyin

App Center'ın etkinleştirilip etkinleştirilmediğini de de de kontrol edebilirsiniz.

bool enabled = await AppCenter.IsEnabledAsync();

Çalışma zamanında App Center SDK sürümünü denetleme

Şu anda kullanmakta olduğunuz App Center SDK sürümünü alabilirsiniz.

AppCenter.SdkVersion;

Depolama boyutu

App Center SDK'sını kullanırken günlükler cihazda yerel olarak depolanır. Büyük günlükler çok fazla yer kaplayabilir, bu nedenle yerel veritabanının boyutunu sınırlamayı seçebilirsiniz.

API'yi SetMaxStorageSizeAsync kullanarak yerel veritabanı boyutunu ayarlayabilirsiniz. API zaman uyumsuzdur ve App Center hizmetlerini başlattığınızda geri arama çağrılır. Bu nedenle çağrısı SetMaxStorageSizeAsync yapmadan önce çağrılmalıdır AppCenter.Start(...). API'yi yalnızca bir kez çağırabilirsiniz.

// Use 20 MB for storage.
AppCenter.SetMaxStorageSizeAsync(20 * 1024 * 1024).ContinueWith((storageTask) => {
    // The storageTask.Result is false when the size cannot be honored.
});
AppCenter.Start("{Your App Secret}", typeof(Analytics));

Maksimum depolama boyutunu ayarlamazsanız SDK varsayılan en yüksek 10 MB boyutu kullanır. Ayarlamanıza izin verilen en düşük boyut 20 KB'tır.

Not

Gerçek maksimum depolama boyutu seçtiğiniz değerden daha yüksek olabilir. SQLite, boyutu sayfa boyutunun sonraki katına yuvarlar. App Center SDK'sı 4 KB sayfa boyutu kullanır.

Not

25 günden eski günlükler atılır.

Diğer API'ler

.NET NuGet paketi, daha fazla işleve sahip olan Xamarin ve UWP ile paylaşılır. Bu sayfadaki WPF ve WinForms için belgelenmemiş tüm API'ler, WPF ve WinForms üzerinde herhangi bir şey döndürecek null veya false yapmayacaktır. Diğer API'ler görünür, böylece bunları taşınabilir bir kitaplıkta kullanabilirsiniz (örneğin, SDK'yi UWP projesi içeren bir Xamarin.Forms uygulamasında kullanırken), ancak bu ek API'ler WPF ve WinForms üzerinde uygulanmaz.

Aracılığıyla paylaş