تسجيل السجلات لـ Swift: مكتبة SwiftyBeaver

ما هو SwiftyBeaver ولماذا هو مطلوب؟

SwiftyBeaver هي مكتبة قوية ومرنة لتسجيل السجلات (logging) في تطبيقات Swift (iOS, macOS, tvOS, watchOS). على عكس print() القياسي، الذي يكون غير منظم وغير مناسب للتحليل، توفر SwiftyBeaver إخراجًا ملونًا إلى وحدة التحكم، والتسجيل في الملفات، والمزامنة السحابية، والتكامل مع خدمات التحليل الشائعة. الهدف الرئيسي هو جعل تصحيح الأخطاء ومراقبة التطبيقات أكثر شفافية وفعالية قدر الإمكان.

كيفية التثبيت

التثبيت عبر Swift Package Manager (SPM) هو أسهل طريقة:

1. في Xcode، اختر File → Add Packages.
2. أدخل الرابط: https://github.com/SwiftyBeaver/SwiftyBeaver.git.
3. اختر الإصدار (يُوصى باستخدام أحدث إصدار مستقر).
4. أضف الحزمة إلى target الخاص بك.

يتوفر التثبيت أيضًا عبر CocoaPods أو Carthage.

الوظائف الأساسية

• إخراج وحدة تحكم ملون — يتم تمييز مستويات التسجيل المختلفة (debug, info, warning, error) بالألوان لتصفية بصرية سريعة.
• التسجيل في الملفات — حفظ تلقائي للسجلات على الجهاز مع التدوير حسب الحجم/التاريخ.
• التسجيل السحابي — إرسال السجلات إلى خادم SwiftyBeaver Cloud للمراقبة عن بُعد.
• التنسيق — تخصيص التاريخ والوقت واسم الملف ورقم السطر في الكود.
• التصفية — تشغيل/إيقاف تشغيل السجلات بناءً على الحد الأدنى للمستوى أو اسم الوحدة (module).

مثال على كود Swift

import SwiftyBeaver

let log = SwiftyBeaver.self

// الإعداداتlet console = ConsoleDestination()  // الإخراج إلى وحدة التحكمlet file = FileDestination()        // التسجيل في ملف

// إعداد التنسيقconsole.format = "$DHH:mm:ss$d $L: $M"file.format = "$DHH:mm:ss$d $L: $M"

// إضافة الوجهات (destinations)log.addDestination(console)log.addDestination(file)

// الاستخدامlog.debug("تم تشغيل التطبيق")      // رسالة تصحيحlog.info("تم تسجيل دخول المستخدم")  // رسالة معلوماتيةlog.warning("شحن البطارية منخفض")   // تحذيرlog.error("خطأ في الشبكة")          // خطأ

متى يتم الاستخدام

SwiftyBeaver مثالي للمشاريع من أي حجم — من التطبيقات الصغيرة إلى حلول المؤسسات. يكون مفيدًا بشكل خاص في:

• تصحيح أخطاء العمليات التجارية المعقدة.
• مراقبة إصدارات الإنتاج (production) عبر المنصة السحابية.
• التطوير الجماعي حيث تكون هناك حاجة إلى تخزين مركزي للسجلات.
• إنشاء تقارير مخصصة عن الأخطاء.

المكتبة مدعومة بنشاط، ولها كود مفتوح المصدر ومجتمع كبير. إذا كنت بحاجة إلى أكثر من 10,000 سطر من السجلات يوميًا — فكر في التعرفة المدفوعة لـ SwiftyBeaver Cloud.