Dukungan Windows

Penting

Visual Studio App Center dihentikan pada 31 Maret 2025, kecuali untuk fitur Analitik dan Diagnostik, yang akan terus didukung hingga 30 Juni 2026. Pelajari lebih lanjut.

App Center saat ini mendukung diagnostik untuk aplikasi UWP, WPF, dan WinForms. Bagian ini menjelaskan pengalaman baru untuk aplikasi UWP sebagai bagian dari rilis SDK 2.5.0. Untuk informasi selengkapnya tentang aplikasi WPF dan WinForms, lihat fitur diagnostik dan WPF/WinForms SDK.

Platform Windows Universal

App Center mendukung set fitur diagnostik lengkap untuk aplikasi UWP Sideloaded dan Windows Store menggunakan SDK 2.5.0 atau versi yang lebih baru. Untuk mengaktifkan diagnostik App Center untuk aplikasi UWP Anda, ikuti dokumentasi UWP SDK App Center untuk mengintegrasikan App Center SDK. Anda dapat mempelajari selengkapnya tentang kumpulan fitur lengkap dalam dokumentasi fitur diagnostik.

Pengalaman diagnostik baru

Dengan rilis SDK 2.5.0 pada Oktober 2019, App Center merilis pengalaman diagnostik baru. Bagian ini merinci peningkatan dan pengalaman transisi dengan rilis baru.

Perbaikan apa yang dilakukan?

Pengalaman diagnostik baru dan yang ditingkatkan mencakup penambahan berikut:

  • Pengalaman simbolisasi penuh yang memungkinkan Anda mengunggah simbol di App Center. Lihat bagian simbolisasi di bawah ini untuk detail selengkapnya.
  • Dukungan untuk penanganan pengecualian
  • Jumlah pengguna yang terpengaruh per grup crash atau kesalahan
  • Kemampuan menambahkan anotasi untuk setiap kerusakan sistem atau grup kesalahan
  • Kemampuan untuk menandai grup crash dan kesalahan sebagai terbuka, tertutup, atau diabaikan
  • Kemampuan untuk mengunduh laporan crash dan kesalahan
  • Kemampuan untuk melampirkan, melihat, dan mengunduh satu lampiran biner dan satu lampiran teks ke laporan kerusakan Anda
  • Detail laporan crash dan kesalahan untuk setiap instans crash, termasuk saat aplikasi diluncurkan, saat aplikasi mengalami crash, dan negara/wilayah di mana perangkat berada dan bahasa yang digunakan.

Anda dapat mempelajari selengkapnya tentang setiap fitur dalam dokumentasi diagnostik App Center.

Apa pengalaman transisinya?

Setelah memperbarui ke App Center UWP SDK Versi 2.5.0, Anda akan melihat data crash dan kesalahan yang masuk ke portal Diagnostik App Center di antarmuka yang baru dan lebih baik. Untuk data crash dan kesalahan yang ditampilkan di UI Diagnostik baru, Anda perlu menggunakan API yang tercantum di bawah bagian kesalahan. Pelajari selengkapnya tentang bagaimana API gangguan lama dikonversi menjadi API kesalahan baru dalam dokumentasi transisi API.

Simbolikasi

Laporan crash UWP menunjukkan trace stack untuk thread yang menyebabkan crash. Ketika aplikasi menggunakan .NET Native (biasanya dalam build rilis), pelacakan tumpukan mungkin berisi alamat memori alih-alih nama kelas, metode, nama file, dan nomor baris yang diperlukan untuk membaca dan memahami kerusakan.

Kerusakan yang belum disimbolkan.

Crash yang belum disimbolikasi ditampilkan di bagian Diagnostik App Center sehingga Anda dapat melihat beberapa detail bahkan sebelum mengunggah simbol. Simbol yang hilang dari crash ini akan ditampilkan di tab "tidak bersimbol". Jika simbol yang hilang tersebut diunggah, grup crash yang tidak bersimbol akan digantikan oleh grup crash bersimbol.

Mengunggah simbol

Untuk mendapatkan alamat memori yang diterjemahkan, Anda perlu mengunggah .appxsym file ke App Center, yang berisi semua informasi yang diperlukan untuk simbolikasi.

Hasilkan simbol secara lokal

Untuk mendapatkan .appxsym file, Anda harus membuat bundel aplikasi seperti yang dijelaskan di sini. Setelah membuat bundel, Anda akan menemukan file simbol sebagai .appxsym file di dalam folder bundel aplikasi.

Simbol untuk aplikasi yang dibangun di App Center Build

Layanan Build dan Distribusi App Center dapat secara otomatis menghasilkan file simbol yang valid dan mengunggah ke layanan Diagnostik. Jika Anda menggunakan App Center untuk membangun dan mendistribusikan aplikasi secara otomatis ke pengguna akhir, Anda tidak perlu mendapatkan dan mengunggah file simbol secara manual ke App Center.

Simbol untuk aplikasi yang diterbitkan ke Microsoft Store

Saat Anda menerbitkan aplikasi Anda ke toko, kompilasi .NET Native terjadi di sisi server. Jadi, Anda perlu mengunduh simbol dari Pusat Mitra.

  1. Temukan aplikasi Anda dalam daftar dan klik aplikasi tersebut.
  2. Perluas menu Manajemen produk dari panel kiri.
  3. Klik pada Kelola paket.
  4. Klik Tampilkan paket di sudut kanan atas untuk simbol Kiriman (versi) yang Anda inginkan.
  5. Temukan paket untuk versi yang Anda perlukan simbolnya, dan klik tautan untuk semua arsitektur yang didukung untuk mengunduh semua simbol (seperti tautan Unduh file simbol Windows 10 (x64 ).

Nota

Aplikasi Anda harus mendeklarasikan dependensi pada versi .NET Native apa pun untuk menghasilkan simbol debug. Deklarasi ini harus disertakan dalam bagian <Dependencies> Anda AppxManifest.xml. Contoh:

<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"/>

Portal Pusat Aplikasi

  1. Masuk ke App Center dan pilih aplikasi Anda.
  2. Di menu sebelah kiri, navigasikan ke bagian Diagnostik dan pilih Simbol.
  3. Di sudut kanan atas, klik Unggah simbol dan unggah file.
  4. Setelah simbol diindeks oleh App Center, crash akan dilambangkan untuk Anda.

App Center API

Proses untuk mengunggah simbol melalui API melibatkan serangkaian tiga panggilan API: satu untuk mengalokasikan ruang di backend kami, satu untuk mengunggah file, dan satu untuk memperbarui status unggahan. Isi panggilan API pertama harus diatur symbol_type ke UWP.

  1. POST Memicu permintaan ke API symbol_uploads. Panggilan ini mengalokasikan ruang di backend kami untuk file Anda dan mengembalikan properti symbol_upload_id dan upload_url .
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. Menggunakan properti upload_url yang dikembalikan dari langkah pertama, buat permintaan PUT dengan header: "x-ms-blob-type: BlockBlob" dan berikan lokasi file Anda di disk. Panggilan ini mengunggah file ke akun penyimpanan backend kami. Pelajari selengkapnya tentang header permintaan PUT Blob .
curl -X PUT '{upload_url}' \
    -H 'x-ms-blob-type: BlockBlob' \
    --upload-file '{path to file}'
  1. Buat PATCH permintaan ke API symbol_uploads menggunakan properti yang telah symbol_upload_id dikembalikan dari langkah pertama. Dalam isi permintaan, tentukan apakah Anda ingin mengatur status unggahan ke committed (berhasil menyelesaikan) proses pengunggahan, atau aborted (tidak berhasil diselesaikan).
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" }'

Nota

API pengunggahan simbol tidak berfungsi untuk file yang lebih besar dari 256MB. Gunakan CLI App Center untuk mengunggah file-file ini. Anda dapat menginstal CLI App Center dengan mengikuti instruksi di repositori CLI App Center kami.

App Center CLI

Anda juga dapat menggunakan CLI untuk mengunggah file simbol:

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

Mengabaikan simbol

Ketika App Center tidak memiliki semua file simbol untuk mensimbolikasi laporan crash semuanya, crash akan tercantum di tab Belum Terangkai Simbol. Simbol yang diperlukan dapat diunggah dari halaman ini, jika Anda memiliki akses ke simbol tersebut.

Jika Anda tidak dapat mengunggah simbol, Anda dapat menandainya sebagai Diabaikan dengan memilih baris dalam tabel dan mengklik tombol Abaikan versi . Tombol ini memberi tahu App Center untuk memproses kerusakan dan menyimbolkannya sepenuhnya dengan simbol yang tersedia di berkas. Setelah selesai diproses, mereka akan muncul di tab Kecelakaan yang sebagian telah disimbolkan. Crash baru yang juga bergantung pada ID simbol yang sama yang ditandai sebagai diabaikan akan melewati tab Tidak Simbolikasi saat masuk dan mengalir melalui sistem.

WinRT, Silverlight, dan Platform Lainnya

App Center tidak mendukung platform Windows lainnya selain UWP, WPF, dan WinForms. Jika Anda memiliki aplikasi Windows dengan crash yang terjadi pada C++ native, Anda dapat mengunggah crash ini ke App Center melalui API pengunggahan crash.

  • Last updated on