Baca dalam bahasa Inggris

Bagikan melalui


Crash Pusat Aplikasi (Unity)

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.

Membuat crash pengujian

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.

Mendapatkan informasi selengkapnya tentang crash sebelumnya

App Center Crashes memiliki dua API yang memberi Anda informasi lebih lanjut jika aplikasi Anda mengalami crash.

Apakah aplikasi menerima peringatan memori rendah di sesi sebelumnya?

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.

Apakah aplikasi mengalami crash di sesi sebelumnya?

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.

Detail tentang crash terakhir

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.

Menyesuaikan penggunaan Crash App Center Anda

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.

Haruskah crash diproses?

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.

Mendapatkan informasi tentang status pengiriman untuk log crash

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:

Panggilan balik berikut akan dipanggil sebelum SDK mengirim log crash

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.

Panggilan balik berikut akan dipanggil setelah SDK berhasil mengirim log crash

Crashes.SentErrorReport += (errorReport) =>
{
    // Your code, e.g. to hide the custom UI.
};

Panggilan balik berikut akan dipanggil jika SDK gagal mengirim log crash

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).

Menambahkan lampiran ke crash atau laporan pengecualian yang tidak tertangani

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.

Mengaktifkan atau menonaktifkan Crash App Center saat runtime

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.

Periksa apakah Crash App Center diaktifkan

Anda juga dapat memeriksa apakah App Center Crash diaktifkan:

bool isEnabled = await Crashes.IsEnabledAsync();

Pengecualian Yang Ditangani di Unity

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);
}

Pengecualian Tidak Tertangani di Unity

Melaporkan pengecualian yang tidak tertangani

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.

Menambahkan lampiran ke laporan pengecualian yang tidak tertangani

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 .

Melaporkan crash NDK

Pelaporan crash

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.

Membangun pustaka breakpad

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.

Melampirkan handler pengecualian

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.

Simbolikasi

Lihat dokumentasi Diagnostik untuk informasi selengkapnya mengenai pemrosesan crash.