ردپای کاربر (Breadcrumbs) در اندروید

ثبت وقایع متنی پیش از رخ دادن خطا برای بازسازی مسیر کاربر قبل از کرش.

ردپاها (Breadcrumbs) وقایع و اقدامات کلیدی هستند که کاربر قبل از رخ دادن کرش انجام داده است؛ مانند ورود به صفحه، کلیک روی یک دکمه یا تغییر در وضعیت برنامه.

ثبت ردپای جدید

با استفاده از متد Didban.addBreadcrumb می‌توانید در هر نقطه از برنامه ردپای جدیدی ثبت کنید:

CheckoutActivity.ktkotlin
// Add breadcrumbs at key workflow steps
Didban.addBreadcrumb(
    category = "checkout",
    message = "User opened checkout sheet"
)

Didban.addBreadcrumb(
    category = "payment",
    message = "Selected credit card payment method"
)

Didban.addBreadcrumb(
    category = "action",
    message = "User tapped Place Order button"
)

بافر حافظه محدود (۵۰ مورد اخیر)

دیدبان ردپاها را در یک بافر چرخشی درون حافظه (In-Memory Ring Buffer) با ظرفیت حداکثر ۵۰ مورد نگهداری می‌کند:

  • بدون افت کارایی: فراخوانی addBreadcrumb هیچ‌گونه دسترسی به دیسک یا شبکه انجام نمی‌دهد و با کمترین تاخیر در حافظه رم ثبت می‌شود.
  • ضمیمه به کرش: در صورت وقوع خطای مهلک، تصویری از این ۵۰ مورد اخیر به فایل کرش ضمیمه شده و در پنل نمایش داده می‌شود.

حریم خصوصی و امنیت داده‌ها

هشدار امنیتی

هرگز داده‌های حساس یا اطلاعات هویتی را در ردپاها قرار ندهید! از ثبت گذرواژه‌ها، توکن‌های دسترسی (JWT یا Auth Token)، شماره‌های کارت بانکی یا اطلاعات شخصی قابل شناسایی کاربر (PII) در پارامتر message خودداری کنید. ردپاها باید صرفاً برای توصیف جریان کاری اپلیکیشن استفاده شوند.