Kapan dan bagaimana saya harus mengajukan laporan bug?

Tip

Gunakan item menu Laporkan masalah di Visual Studio - ini akan mengirim informasi diagnostik bersama dengan laporan bug Anda untuk membantu mengatasi masalah.

Ada instruksi terperinci untuk Visual Studio 2019 atau Visual Studio 2017 dan Visual Studio untuk Mac.

Anda dapat mencari laporan yang sudah ada di situs web Komunitas Pengembang Visual Studio.

Ajukan bug jika...

Anda memiliki serangkaian langkah yang menurut Anda dapat digunakan teknisi untuk mereproduksi masalah.

ATAU

Anda dapat dengan hati-hati menggambarkan gejala masalah yang terlihat, terutama jika Anda juga dapat menjelaskan beberapa keadaan tepat yang terkait dengan masalah tersebut.^[1]

Praktik terbaik untuk membantu mengatasi bug dengan cepat dan efisien

1. Cari Komunitas Pengembang Visual Studio dan web untuk laporan bug atau saran penggunaan yang ada yang mungkin mengatasi masalah secara langsung.^[2][3]

2. Jelaskan masalah sejelas mungkin dan sesingkat mungkin, termasuk deskripsi tentang apa yang terjadi dan diharapkan terjadi.

3. Sertakan jejak tumpukan yang relevan, teks pesan kesalahan, atau log crash (jika Anda menggunakan fitur Laporkan masalah , ini dapat disertakan secara otomatis). ^[4]

4. Tuliskan pesan kesalahan penting apa pun yang muncul di lampiran cuplikan layar sebagai teks biasa juga.

5. Sertakan kasus pengujian kecil yang mandiri yang mereproduksi bug dengan kode sesedikitan mungkin. Jika Anda tidak dapat mereproduksi masalah dengan proyek baru (dibuat menggunakan salah satu templat bawaan), silakan zip proyek yang menunjukkan masalah dan melampirkannya ke laporan bug. Buat contoh proyek sesingkat mungkin sebelum melampirkannya.^[5][6]

6. Jelaskan lingkungan tempat bug ditemui, termasuk sistem operasi dan versi Xamarin dan dependensi apa pun.

Detail tambahan

1. ^ Idealnya deskripsi "gejala yang terlihat" harus mencakup detail yang cukup sehingga pelanggan lain dapat mengonfirmasi apakah mereka melihat masalah yang sama (pesan kesalahan yang sama, penurunan performa yang sama, jejak tumpukan yang sama dari crash, dll.). Untuk "keadaan yang tepat", salah satu contoh yang baik adalah jika Anda dapat mengatakan sesuatu seperti: "Saya biasanya mengalami masalah 75% dari waktu, tetapi jika saya mengubah satu hal ini maka saya dapat menghindari masalah sepenuhnya." Contoh serupa lain dari "keadaan yang tepat" adalah jika menurunkan ke versi Xamarin sebelumnya menghentikan masalah.

2. ^ Seperti yang Anda harapkan, cuplikan teks kesalahan (atau teks deskriptif unik lainnya) biasanya merupakan istilah pencarian terbaik. Jika laporan bug yang ada tidak lengkap, maka Anda dipersilakan untuk menambahkan detail atau mengajukan laporan bug baru yang lebih baik.

3. ^ Pertanyaan bagus lainnya adalah apakah masalah yang sama telah dilaporkan untuk aplikasi Java, Objective-C, atau Swift apa pun. Jika demikian, maka masalahnya sangat mungkin menjadi bagian dari Android atau iOS itu sendiri daripada bagian dari Xamarin.

4. ^ Beberapa contoh informasi untuk disertakan:

   1. Untuk kesalahan yang terjadi saat membangun proyek, harap sertakan output build diagnostik lengkap pada laporan bug.

   2. Untuk kesalahan yang terjadi saat membangun atau men-debug proyek iOS dari Visual Studio, jalankan Bantuan > Xamarin > Zip Log setelah mengalami kesalahan dan sertakan file .zip yang dihasilkan pada laporan bug.

   3. Untuk pengecualian atau crash di aplikasi Android atau iOS, sertakan log Debug yang relevan untuk aplikasi Xamarin.Android dan Xamarin.iOS.

5. ^ Jika memungkinkan untuk masalah khusus Anda, salah satu opsinya adalah membuat ulang masalah dengan menambahkan sejumlah kecil file dari solusi asli Anda ke dalam solusi baru. Tim Xamarin akan sering dapat menyelidiki masalah bahkan pada kasus pengujian yang lebih besar (dengan asumsi langkah-langkah untuk mereproduksi dijelaskan dengan jelas), tetapi kasus pengujian yang lebih sederhana memberikan kemungkinan terbaik bahwa bug akan diselesaikan dengan cepat.

6. ^Jika tidak memungkinkan untuk mereproduksi masalah dengan menambahkan sejumlah kecil file ke solusi baru, maka Anda dapat melakukan zip dan melampirkan seluruh folder solusi untuk aplikasi lengkap Anda. binHapus folder , obj, Components, dan packages untuk membuat file zip lebih kecil. (IDE dan proses build biasanya akan memulihkan atau membuat ulang konten folder ini sesuai kebutuhan.) Anda juga dapat menghapus file kode dan sumber daya sebanyak yang Anda inginkan, selama solusi yang dihasilkan masih menunjukkan masalah aslinya.