Pelatihan
Jalur pembelajaran
Men-debug aplikasi konsol C# (Mulai menggunakan C#, Bagian 6) - Training
Men-debug aplikasi konsol C# (Mulai menggunakan C#, Bagian 6)
Browser ini sudah tidak didukung.
Mutakhirkan ke Microsoft Edge untuk memanfaatkan fitur, pembaruan keamanan, dan dukungan teknis terkini.
Penting
Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.
Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.
App Center Crash secara otomatis menghasilkan log crash setiap kali aplikasi Anda crash, dengan log ke penyimpanan perangkat. Saat pengguna memulai aplikasi lagi, SDK mengirimkan laporan crash ke App Center. Mengumpulkan crash berfungsi untuk aplikasi beta dan live, yaitu crash yang dikirimkan ke Google Play. Log crash berisi informasi berharga bagi Anda untuk membantu memperbaiki crash.
Ikuti instruksi di bagian Memulai Unity jika Anda belum menyiapkan SDK di aplikasi Anda.
Log crash di iOS memerlukan Simbolikasi. Untuk mengaktifkan simbolikasi, lihat dokumentasi Diagnostik App Center, yang menjelaskan cara menyediakan simbol untuk aplikasi Anda.
Penting
Crashes SDK untuk Unity tidak mendukung UWP. Instruksi di halaman ini hanya mencakup Android dan iOS.
Catatan
SDK tidak akan meneruskan log crash jika Anda telah melampirkan debugger. Pastikan debugger tidak terpasang saat Anda crash aplikasi.
Catatan
Jika Anda telah Enable CrashReport API
mengaktifkan di PlayerSettings, SDK tidak akan mengumpulkan log crash.
App Center Crashes memberi Anda API untuk menghasilkan crash pengujian untuk pengujian SDK yang mudah. API ini memeriksa konfigurasi debug vs rilis. Jadi Anda hanya dapat menggunakannya saat penelusuran kesalahan karena tidak akan berfungsi untuk aplikasi rilis.
Crashes.GenerateTestCrash();
Catatan
Metode ini hanya akan berfungsi dengan pengaturan Build Pengembangan diaktifkan.
App Center Crashes memiliki dua API yang memberi Anda informasi lebih lanjut jika aplikasi Anda mengalami crash.
Kapan saja setelah memulai SDK, Anda dapat memeriksa apakah aplikasi menerima peringatan memori di sesi sebelumnya:
bool hadLowMemoryWarning = Crashes.HasReceivedMemoryWarningInLastSessionAsync().Result;
Catatan
Metode ini tidak akan berfungsi di Awake()
.
Catatan
Dalam beberapa kasus, perangkat dengan memori rendah tidak dapat mengirim peristiwa.
Kapan saja setelah memulai SDK, Anda dapat memeriksa apakah aplikasi mengalami crash di peluncuran sebelumnya:
bool didAppCrash = await Crashes.HasCrashedInLastSessionAsync();
HasCrashedInLastSessionAsync
Panggilan berguna jika Anda ingin menyesuaikan perilaku atau UI aplikasi Anda setelah crash terjadi. Beberapa pengembang menunjukkan UI tambahan untuk meminta maaf kepada pengguna mereka, atau ingin menghubungi setelah crash terjadi.
Jika aplikasi Anda mengalami crash sebelumnya, Anda bisa mendapatkan detail tentang crash terakhir.
ErrorReport crashReport = await Crashes.GetLastSessionCrashReportAsync();
Kasus penggunaan yang paling umum untuk API ini adalah ketika pengguna mengimplementasikan delegasi crash atau listener kustom mereka.
Crash App Center menyediakan panggilan balik bagi pengembang untuk mengambil tindakan tambahan sebelum dan saat mereka mengirim log crash ke App Center.
Catatan
Atur panggilan balik sebelum App Center dimulai, Misalnya dalam Awake
metode, karena App Center mulai memproses crash segera setelah awal.
Atur panggilan balik berikut jika Anda ingin memutuskan apakah crash tertentu perlu diproses atau tidak. Misalnya, mungkin ada crash tingkat sistem yang ingin Anda abaikan dan tidak dikirim ke App Center.
Crashes.ShouldProcessErrorReport = (ErrorReport report) =>
{
// Check the report in here and return true or false depending on the ErrorReport.
return true;
};
Jika privasi pengguna penting bagi Anda, Anda mungkin ingin mendapatkan konfirmasi pengguna sebelum mengirim laporan crash ke App Center. SDK mengekspos panggilan balik yang memberi tahu App Center Crash untuk menunggu konfirmasi pengguna sebelum mengirim laporan crash.
Jika kode Anda menggunakan panggilan balik ini, Anda bertanggung jawab untuk mendapatkan konfirmasi pengguna. Salah satu opsinya adalah melalui perintah dialog dengan salah satu opsi berikut: Selalu Kirim, Kirim, dan Jangan kirim. Berdasarkan input, Anda akan memberi tahu App Center Crash apa yang harus dilakukan dan crash kemudian akan ditangani.
Catatan
SDK tidak menampilkan dialog untuk ini, aplikasi harus menyediakan UI sendiri untuk meminta persetujuan pengguna.
Panggilan balik berikut menunjukkan cara memberi tahu SDK untuk menunggu konfirmasi pengguna sebelum mengirim crash:
Crashes.ShouldAwaitUserConfirmation = () =>
{
// Build your own UI to ask for user consent here. SDK doesn't provide one by default.
// Return true if you built a UI for user consent and are waiting for user input on that custom UI, otherwise false.
return true;
};
Jika panggilan balik kembali true
, Anda harus mendapatkan izin pengguna dan mengirim pesan ke SDK dengan hasilnya menggunakan API berikut:
// Depending on the user's choice, call Crashes.NotifyUserConfirmation() with the right value.
Crashes.NotifyUserConfirmation(UserConfirmation.DontSend);
Crashes.NotifyUserConfirmation(UserConfirmation.Send);
Crashes.NotifyUserConfirmation(UserConfirmation.AlwaysSend);
Sebagai contoh, Anda dapat merujuk ke contoh dialog kustom kami.
Terkadang, Anda ingin mengetahui status crash aplikasi Anda. Kasus penggunaan umum menampilkan UI yang memberi tahu pengguna bahwa aplikasi mengirimkan laporan crash. Skenario lain adalah ketika Anda ingin menyesuaikan perilaku aplikasi untuk memastikan log crash dapat dikirimkan segera setelah diluncurkan kembali. Crash App Center menyediakan tiga panggilan balik berbeda yang dapat Anda buat untuk diberi tahu tentang apa yang terjadi:
Crashes.SendingErrorReport += (errorReport) =>
{
// Your code, e.g. to present a custom UI.
};
Jika kami mengalami masalah jaringan atau pemadaman pada titik akhir, dan Anda memulai ulang aplikasi, SendingErrorReport
dipicu lagi setelah proses dimulai ulang.
Crashes.SentErrorReport += (errorReport) =>
{
// Your code, e.g. to hide the custom UI.
};
Crashes.FailedToSendErrorReport += (errorReport, exception) =>
{
// Your code goes here.
};
Penerimaan FailedToSendErrorReport
berarti terjadi kesalahan yang tidak dapat dipulihkan seperti kode 4xx . Misalnya, 401 berarti appSecret
salah.
Panggilan balik ini tidak dipicu jika masalah jaringan. Dalam hal ini, SDK terus mencoba kembali (dan juga menjeda percobaan kembali saat koneksi jaringan tidak berfungsi).
Anda juga dapat menambahkan lampiran biner dan teks secara opsional ke crash atau laporan pengecualian yang tidak tertangani . SDK akan mengirimkannya bersama dengan laporan sehingga Anda dapat melihatnya di portal App Center. Panggilan balik berikut akan dipanggil tepat sebelum mengirim laporan tersimpan. Untuk crash, itu terjadi pada peluncuran aplikasi berikutnya. Untuk pengecualian yang tidak tertangani, Anda harus ikut serta untuk mengirim lampiran. Pastikan file lampiran tidak dinamai minidump.dmp
sebagai nama tersebut dicadangkan untuk file minidump. Berikut adalah contoh cara melampirkan teks dan gambar ke laporan:
Crashes.GetErrorAttachments = (ErrorReport report) =>
{
// Your code goes here.
return new ErrorAttachmentLog[]
{
ErrorAttachmentLog.AttachmentWithText("Hello world!", "hello.txt"),
ErrorAttachmentLog.AttachmentWithBinary(Encoding.UTF8.GetBytes("Fake image"), "fake_image.jpeg", "image/jpeg")
};
};
Crash dibingkai dari pengecualian yang tidak tertangani dalam laporan dengan IsCrash
properti . Properti akan berlaku untuk crash dan false jika tidak.
Catatan
Batas ukuran untuk lampiran saat ini 7 MB. Mencoba mengirim lampiran yang lebih besar akan memicu kesalahan.
Catatan
GetErrorAttachments
dipanggil pada utas utama dan tidak memisahkan pekerjaan di atas bingkai. Untuk menghindari pemblokiran perulangan game, jangan lakukan tugas yang berjalan lama dalam panggilan balik ini.
Anda dapat mengaktifkan dan menonaktifkan App Center Crash saat runtime. Jika Anda menonaktifkannya, SDK tidak akan melakukan pelaporan crash untuk aplikasi.
Crashes.SetEnabledAsync(false);
Untuk mengaktifkan App Center Crash lagi, gunakan API yang sama tetapi lewati true
sebagai parameter.
Crashes.SetEnabledAsync(true);
Anda tidak perlu menunggu panggilan ini untuk melakukan panggilan API lain (seperti IsEnabledAsync
) konsisten.
Status ini bertahan di penyimpanan perangkat di seluruh peluncuran aplikasi.
Anda juga dapat memeriksa apakah App Center Crash diaktifkan:
bool isEnabled = await Crashes.IsEnabledAsync();
App Center juga memungkinkan Anda melacak kesalahan menggunakan pengecualian yang ditangani di Unity. Untuk melakukannya, gunakan TrackError
metode :
try {
// your code goes here.
} catch (Exception exception) {
Crashes.TrackError(exception);
}
Untuk konteks lebih lanjut tentang kesalahan Anda, Anda juga dapat melampirkan properti ke dalamnya. Teruskan properti sebagai kamus string. Langkah ini bersifat opsional.
try {
// your code goes here.
} catch (Exception exception) {
var properties = new Dictionary<string, string>
{
{ "Category", "Music" },
{ "Wifi", "On" }
};
Crashes.TrackError(exception, properties);
}
Anda juga dapat menambahkan lampiran biner dan teks secara opsional ke laporan kesalahan yang ditangani. Teruskan lampiran sebagai array ErrorAttachmentLog
objek seperti yang ditunjukkan pada contoh di bawah ini.
try {
// your code goes here.
} catch (Exception exception) {
var attachments = new ErrorAttachmentLog[]
{
ErrorAttachmentLog.AttachmentWithText("Hello world!", "hello.txt"),
ErrorAttachmentLog.AttachmentWithBinary(Encoding.UTF8.GetBytes("Fake image"), "fake_image.jpeg", "image/jpeg")
};
Crashes.TrackError(exception, attachments: attachments);
}
Secara default, App Center SDK tidak melaporkan pengecualian yang tidak tertangani yang dilemparkan di aplikasi Anda yang tidak menyebabkan crash fatal. Untuk mengaktifkan fungsionalitas ini, panggil metode berikut:
Crashes.ReportUnhandledExceptions(true);
Setelah memanggil API ini, App Center mencatat semua pengecualian yang tidak tertangani sebagai Masalah di portal App Center, mirip dengan pengecualian yang ditangani yang disebutkan sebelumnya. Untuk menonaktifkan fungsionalitas ini, panggil API yang sama dengan false
parameter .
Crashes.ReportUnhandledExceptions(false);
Catatan
Beberapa pengecualian yang tidak tertangani yang terdeteksi oleh App Center SDK akan muncul sebagai kesalahan di UI App Center. Ini karena Unity menangkap pengecualian yang tidak tertangani secara default, yang berarti aplikasi tidak keluar dan tidak dianggap sebagai crash.
Secara default, App Center SDK tidak mengaktifkan lampiran pada pengecualian yang tidak tertangani. Untuk mengaktifkan fungsionalitas ini, atur enableAttachmentsCallback
parameter boolean metode ReportUnhandledExceptions
ke true
:
Crashes.ReportUnhandledExceptions(true, true);
Kemudian Anda dapat secara opsional menambahkan lampiran ke laporan pengecualian yang tidak tertangani dengan menerapkan panggilan balik GetErrorAttachments .
Untuk menerima laporan crash yang tepat di App Center, pertama-tama pastikan Anda menyiapkan App Center Crashes SDK dengan mengikuti instruksi yang tercantum di atas.
Selanjutnya, Anda harus menyertakan dan mengkompilasi Google Breakpad dengan mengikuti petunjuk yang tercantum dalam README Resmi Google Breakpad untuk Android. Untuk menggunakannya di Unity, sertakan biner dengan aplikasi Anda.
Catatan
App Center SDK tidak menggabungkan Google Breakpad secara default.
Setelah Menyertakan Google Breakpad, lampirkan NDK Crash Handler:
/* Attach NDK Crash Handler. */
var minidumpDir = Crashes.GetMinidumpDirectoryAsync();
setupNativeCrashesListener(minidumpDir.Result);
...
[DllImport("YourLib")]
private static extern void setupNativeCrashesListener(string path);
Metode setupNativeCrashesListener
ini adalah metode asli yang harus Anda terapkan di C/C++:
#include <android/log.h>
#include "google-breakpad/src/client/linux/handler/exception_handler.h"
#include "google-breakpad/src/client/linux/handler/minidump_descriptor.h"
static google_breakpad::ExceptionHandler exception_handler(google_breakpad::MinidumpDescriptor(), NULL, dumpCallback, NULL, true, -1);
/**
* Registers breakpad as the exception handler for NDK code.
* @param path minidump directory path returned from Crashes.GetMinidumpDirectoryAsync()
*/
extern "C" void setupNativeCrashesListener(const char *path) {
google_breakpad::MinidumpDescriptor descriptor(path);
exception_handler.set_minidump_descriptor(descriptor);
}
Di mana dumpCallback
digunakan untuk pemecahan masalah:
/*
* Triggered automatically after an attempt to write a minidump file to the breakpad folder.
*/
static bool dumpCallback(const google_breakpad::MinidumpDescriptor &descriptor,
void *context,
bool succeeded) {
/* Allow system to log the native stack trace. */
__android_log_print(ANDROID_LOG_INFO, "YourLogTag",
"Wrote breakpad minidump at %s succeeded=%d\n", descriptor.path(),
succeeded);
return false;
}
Setelah metode ini disiapkan dengan benar, aplikasi mengirimkan minidump ke App Center secara otomatis setelah dimulai ulang. Untuk memecahkan masalah, Anda dapat menggunakan log verbose untuk memeriksa apakah minidump dikirim setelah aplikasi dimulai ulang.
Catatan
App Center menggunakan nama minidump.dmp
yang dipesan untuk lampiran minidump. Pastikan untuk memberi lampiran Anda nama yang berbeda kecuali itu adalah file minidump sehingga kami dapat menanganinya dengan benar.
Peringatan
Ada bug yang diketahui di breakpad yang membuatnya tidak mungkin untuk menangkap crash pada emulator x86.
Lihat dokumentasi Diagnostik untuk informasi selengkapnya mengenai pemrosesan crash.
Pelatihan
Jalur pembelajaran
Men-debug aplikasi konsol C# (Mulai menggunakan C#, Bagian 6) - Training
Men-debug aplikasi konsol C# (Mulai menggunakan C#, Bagian 6)