ردپای کاربر (Breadcrumbs) در iOS

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

ردپاها (Breadcrumbs) وقایع و اقدامات مهمی هستند که پیش از وقوع خطا در اپلیکیشن رخ داده‌اند و به توسعه‌دهنده امکان می‌دهند بداند کاربر قبل از کرش در کدام بخش برنامه حضور داشته است.

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

با متد استاتیک Didban.addBreadcrumb می‌توانید در هر بخش از کدهای Swift ردپا اضافه کنید:

CartView.swiftswift
import SwiftUI
import Didban

struct CartView: View {
    func onCheckoutTapped() {
        // Record navigation breadcrumb
        Didban.addBreadcrumb(
            category: "checkout",
            message: "User opened Checkout sheet"
        )
        
        // Record payment selection
        Didban.addBreadcrumb(
            category: "payment",
            message: "User selected Apple Pay"
        )
    }
    
    var body: some View {
        Button("Place Order", action: onCheckoutTapped)
    }
}

ذخیره‌سازی بافر سریع و ایمن در حافظه C

دیدبان ردپاها را در یک بافر چرخشی سریع در سطح C با ظرفیت ۵۰ مورد نگهداری می‌کند:

  • محدودیت طول متن: دسته‌بندی (category) حداکثر ۶۳ بایت و پیام (message) حداکثر ۲۵۵ بایت بر اساس کدهای معتبر UTF-8 مجاز است.
  • ایمنی هنگام سیگنال: به دلیل ذخیره‌سازی در ساختار پیش‌تخصیص‌یافته C، هندلر سیگنال در لحظه کرش می‌تواند بدون فراخوانی ران‌تایم Swift یا تخصیص حافظه، ردپاها را روی دیسک بنویسد.

حریم خصوصی و امنیت

هشدار امنیتی

هرگز اطلاعات حساس یا محرمانه کاربر را در ردپاها ثبت نکنید! از قرار دادن رمزهای عبور، توکن‌های احراز هویت، کلیدهای دسترسی، شماره کارت‌های اعتباری یا داده‌های شخصی کاربران در ردپاها اکیداً خودداری کنید. ردپاها فقط باید توصیف‌کننده رویدادهای عمومی برنامه باشند.