Windows Desteği

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ız için App Center tanılamasını etkinleştirmek için App Center SDK'sını tümleştirmek için App Center'ın UWP SDK'sı belgelerini izleyin. 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 karşıya yüklemenizi sağlayan tam simgesellik 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 yoksayıldı olarak işaretleme olanağı
• Kilitlenme ve hata raporlarını indirme olanağı
• Kilitlenme raporlarınıza bir ikili ve bir metin eki ekleme, görüntüleme ve indirme olanağı
• 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 kilitlenme raporları, kilitlenmeye 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.

Tam olmayan kilitlenmeler

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

Simgeleri karşıya yükleme

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 Derlemesi'nde yerleşik 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ı depoda yayımladığınızda, .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).

<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 olarak UWPayarlanmalıdırsymbol_type.

1. symbol_uploads API'sine bir POST istek tetikleme. 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}'

2. upload_url İlk adımda döndürülen özelliğini kullanarak üst bilgiyle bir PUT istekte bulunun: "x-ms-blob-type: BlockBlob" ve dosyanızın disk üzerindeki konumunu sağlayın. 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}'

3. İlk adımda döndürülen özelliğini kullanarak symbol_upload_id symbol_uploads API'sine istekte PATCHbulunın. İsteğin gövdesinde karşıya yükleme committed işleminin durumunu (başarıyla tamamlandı) veya aborted (başarısız bir şekilde tamamlandı) olarak ayarlamak isteyip istemediğinizi belirtin.

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" }'

App Center CLI

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

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

Sembolleri yoksayma

App Center kilitlenme raporlarını tamamen simgeleyen tüm sembol dosyalarına sahip olmadığında kilitlenmeler, Simgelenmemiş sekmesinde listelenir. Gerekli semboller, erişiminiz varsa bu sayfadan karşıya yüklenir.

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 kilitlenmeleri işlemesini ve dosyadaki simgelerle bunları mümkün olduğunca tamamen sembolleştirmesini söyler. İşlem tamamlandıktan sonra Kilitlenmeler sekmesinde kısmen sembolik olarak görünürler. Yoksayıldı olarak işaretlenen aynı sembol kimliklerine de bağlı olan yeni kilitlenmeler, sistem içinde gelen ve sistemde akan 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 karşıya yükleme kilitlenmeleri API'si aracılığıyla App Center'a yükleyebilirsiniz.