Aracılığıyla paylaş

Windows Desteği

Ö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 şu anda UWP, WPF ve WinForms uygulamaları için tanılamayı desteklemektedir. Bu bölümde, 2.5.0 SDK sürümünün bir parçası olarak UWP uygulamalarına yönelik yeni deneyim açıklanmaktadır. WPF ve WinForms uygulamaları hakkında daha fazla bilgi için bkz. tanılama özellikleri ve WPF/WinForms SDK'sı.

Evrensel Windows Platformu

App Center, 2.5.0 SDK veya sonraki sürümleri kullanan hem dışarıdan yüklenen hem de Windows Mağazası UWP uygulamaları için tam tanılama özelliği kümesini destekler. UWP uygulamanızda App Center tanılamasını etkinleştirmek için App Center'ın UWP SDK belgelerini izleyerek App Center SDK'sını entegre edin. Tanılama özellikleri belgelerinde özellik kümesinin tamamı hakkında daha fazla bilgi edinebilirsiniz.

Yeni tanılama deneyimi

Ekim 2019'daki 2.5.0 SDK sürümüyle App Center yeni bir tanılama deneyimi yayımladı. Bu bölümde, yeni sürümle ilgili iyileştirmeler ve geçiş deneyimi ayrıntılı olarak açıklanmıştır.

Hangi geliştirmeler yapıldı?

Yeni ve geliştirilmiş tanılama deneyimi aşağıdaki eklemeleri içerir:

  • App Center'da sembolleri yüklemenize olanak tanıyan eksiksiz bir sembollama deneyimi. Daha fazla ayrıntı için aşağıdaki sembolikleştirme bölümüne bakın.
  • İşlenen özel durumlar için destek
  • Kilitlenme veya hata grubu başına etkilenen kullanıcı sayısı
  • Kilitlenme veya hata grubu başına ek açıklama ekleme olanağı
  • Kilitlenme ve hata gruplarını açık, kapalı veya göz ardı edildi olarak işaretleme olanağı
  • Kilitlenme ve hata raporlarını indirme yeteneği
  • Çökme raporlarınıza bir bineer dosya ve bir metin ek dosyası ekleme, görüntüleme ve indirme yeteneği
  • Uygulamanın ne zaman başlatıldığı, ne zaman kilitlendiği ve cihazın kullandığı ülke/bölge ve dil de dahil olmak üzere kilitlenme örneği başına kilitlenme ve hata raporu ayrıntıları

App Center tanılama belgelerinde her özellik hakkında daha fazla bilgi edinebilirsiniz.

Geçiş deneyimi nedir?

App Center UWP SDK Sürüm 2.5.0'a güncelleştirdikten sonra, yeni ve geliştirilmiş bir kullanıcı arabiriminde App Center Tanılama portalına gelen kilitlenme ve hata verilerini görürsünüz. Yeni Tanılama kullanıcı arabiriminde görüntülenen kilitlenme ve hata verileri için hatalar bölümünde listelenen API'leri kullanmanız gerekir. Eski kilitlenme API'lerinin yeni hata API'lerine nasıl eş olduğu hakkında daha fazla bilgi için API geçişi belgelerinden bilgi edinin.

Simgeselleştirme

UWP çökme raporları, çökmeye neden olan iş parçacığı için yığın izlemesini gösterir. Uygulama .NET Native (genellikle yayın derlemelerinde) kullanırken yığın izlemesi, kilitlenmeleri okumak ve anlamak için gereken sınıf adları, yöntemler, dosya adları ve satır numaraları yerine bellek adresleri içerebilir.

Sembolsüz kilitlenmeler

Simgesiz kilitlenmeler, simgeleri yüklemeden önce bile bazı ayrıntıları görüntüleyebilmeniz için App Center Diagnostics bölümünde görüntülenir. Bu kilitlenmelerin eksik simgeleri "simgelenmemiş" sekmesinde gösterilir. Eksik simgeler karşıya yüklenirse, simgelenmemiş kilitlenme grubu simgeleştirilmiş kilitlenme grubuyla değiştirilir.

Simgeler yükleniyor

Bellek adreslerinin çevrilmesi için, simgeselleştirme için gereken tüm bilgileri içeren bir .appxsym dosyayı App Center'a yüklemeniz gerekir.

Simgeleri yerel olarak oluşturma

Dosya .appxsym edinmek için burada açıklandığı gibi bir uygulama paketi oluşturmanız gerekir. Paketi oluşturduktan sonra semboller dosyasını uygulama paketi klasörünün içinde bir .appxsym dosya olarak bulabilirsiniz.

App Center Yapı'da oluşturulan uygulamalar için simgeler

App Center Derleme ve Dağıtım hizmetleri otomatik olarak geçerli bir sembol dosyası oluşturabilir ve Tanılama hizmetine yükleyebilir. Uygulamanızı derlemek ve son kullanıcılarınıza otomatik olarak dağıtmak için App Center kullanıyorsanız, sembol dosyalarını el ile edinmeniz ve App Center'a yüklemeniz gerekmez.

Microsoft Store'da yayımlanan uygulamalar için simgeler

Uygulamanızı mağazaya yüklediğinizde, .NET Native derlemesi sunucu tarafında gerçekleşir. Bu nedenle, sembolleri İş Ortağı Merkezi'nden indirmeniz gerekir.

  1. Listede uygulamanızı bulun ve üzerine tıklayın.
  2. Sol panelden Ürün yönetimi menüsünü genişletin.
  3. Paketleri yönet'e tıklayın.
  4. Simgelerin gösterilmesini istediğiniz Gönderim (sürüm) için sağ üst köşedeki Paketleri göster'e tıklayın.
  5. Sembollere ihtiyacınız olan sürümün paketini bulun ve tüm simgeleri indirmek için desteklenen tüm mimarilerin bağlantılarına tıklayın (Windows 10 sembol dosyasını indir (x64) bağlantısı gibi).

Uyarı

Uygulamanızın hata ayıklama simgeleri oluşturmak için herhangi bir .NET Native sürümüne bağımlılık bildirmesi gerekir. Bu bildirim, <Dependencies> kısmının AppxManifest.xml bölümüne eklenmelidir. Örnek:

<PackageDependency Name="Microsoft.NET.Native.Framework.2.2" MinVersion="2.2.29512.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>
<PackageDependency Name="Microsoft.NET.Native.Runtime.2.2" MinVersion="2 2.28604.0" Publisher="CN=Microsoft Corporation, 0=Microsoft Corporation, L=Redmond, S=Washington, C=US"/>

App Center Portalı

  1. App Center'da oturum açın ve uygulamanızı seçin.
  2. Soldaki menüde Tanılama bölümüne gidin ve Simgeler'i seçin.
  3. Sağ üst köşede Sembolleri karşıya yükle'ye tıklayın ve dosyayı karşıya yükleyin.
  4. Simgeler App Center tarafından dizine alındıktan sonra kilitlenmeler sizin için sembolik hale gelir.

App Center API'si

API aracılığıyla sembolleri karşıya yükleme işlemi üç API çağrısı serisini içerir: biri arka ucumuzda yer ayırmak, biri dosyayı karşıya yüklemek için ve biri de karşıya yüklemenin durumunu güncelleştirmek için. İlk API çağrısının gövdesi, `symbol_type` öğesini `UWP` olarak ayarlamalıdır.

  1. POST isteğini symbol_uploads API'sine tetikle. Bu çağrı, dosyanız için arka uçta yer ayırır ve bir symbol_upload_id ve upload_url özelliği döndürür.
curl -X POST 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{JSON BODY}'
  1. İlk adımda döndürülen upload_url özelliğini kullanarak, PUT başlıklı üst bilgi ile bir "x-ms-blob-type: BlockBlob" isteği yapın ve dosyanızın disk üzerindeki konumunu belirtin. Bu çağrı, dosyayı arka uç depolama hesaplarımıza yükler. PUT Blob isteği üst bilgileri hakkında daha fazla bilgi edinin.
curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'
  1. İlk adımda döndürülen PATCH özelliğini kullanarak symbol_uploads API'sine bir symbol_upload_id isteği gönderin. İsteğin gövdesinde, yükleme işleminin durumunu ayarlamak isteyip istemediğinizi belirtin: committed (başarıyla tamamlandı) veya aborted (başarısız oldu).
curl -X PATCH 'https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/symbol_uploads/{symbol_upload_id}' \
    -H 'accept: application/json' \
    -H 'X-API-Token: {API TOKEN}' \
    -H 'Content-Type: application/json' \
    -d '{ "status": "committed" }'

Uyarı

Sembol yükleme API'si 256 MB'tan büyük dosyalar için çalışmaz. Bu dosyaları karşıya yüklemek için App Center CLI'sini kullanın. App Center CLI depomuzdaki yönergeleri izleyerek App Center CLI'yi yükleyebilirsiniz.

App Center CLI

Sembol dosyalarını karşıya yüklemek için CLI'yi de kullanabilirsiniz:

appcenter crashes upload-symbols --appxsym {symbol file}

Sembolleri görmezden gelmek

App Center tüm simge dosyalarına sahip olmadığında kilitlenme raporlarını tam olarak simgelemez ve Kilitlenmeler, Simgelenmemiş sekmesinde listelenir. Erişiminiz varsa, bu sayfadan gerekli sembolleri yükleyebilirsiniz.

Simgeleri karşıya yükleyemiyorsanız, tabloda satırları seçip Sürümleri yoksay düğmesine tıklayarak bunları Yoksayıldı olarak işaretleyebilirsiniz. Bu düğme, App Center'a çökmeleri işlemesini ve mevcut simgeleri kullanarak mümkün olduğunca eksiksiz bir şekilde simgeleştirmesini söyler. İşleme alındıktan sonra, Kilitlenmeler sekmesinde kısmen sembolize edilmiş olarak görünürler. Yoksayıldı olarak işaretlenen aynı sembol kimliklerine de bağlı olan yeni çökmeler, sistemden geçen Simgelenmemiş sekmesini atlar.

WinRT, Silverlight ve Diğer Platformlar

App Center, UWP, WPF ve WinForms dışında diğer Windows platformlarını desteklemez. Yerel C++ kilitlenmeleri olan bir Windows uygulamanız varsa, bu kilitlenmeleri App Center'a kilitlenmeleri yükleme API'si aracılığıyla yükleyebilirsiniz.

  • Last updated on