الكونسول في Xcode: المفاهيم الأساسية، إخراج البيانات وتصحيح الأخطاء

ما هو الكونسول في Xcode

الكونسول هو جزء من Debug Area في Xcode، يقع في اللوحة السفلية للمحرر (View → Debug Area → Activate Console، الاختصار Cmd + Shift + Y). يعرض الكونسول كل المخرجات النصية من التطبيق قيد التشغيل: رسائل من NSLog و os_log و print وتحذيرات وقت التشغيل وتفريغات الاستثناءات التلقائية عند تعطل التطبيق.

الكونسول يعمل في كل من المحاكي والجهاز الفعلي. في المحاكي، تصل الرسائل فورًا عبر أنبوب محلي؛ على الجهاز، تصل عبر اتصال USB بتأخير 1–3 إطار. لتطبيقات الإنتاج، الكونسول على الجهاز غير متاح — يعتمد المطورون على Crashlytics أو Unified Logging مع التجميع عن بُعد عبر log collect.

على عكس تطبيق النظام Console.app على Mac، نافذة الكونسول في Xcode تظهر فقط سجلات التطبيق الحالي قيد التشغيل (مع إمكانية التصفية). Console.app يجمع سجلات جميع العمليات على Mac، بما في ذلك محاكيات iOS. ومع ذلك، لتصحيح أخطاء تطبيقات iOS، يستخدم المطورون الكونسول المدمج في Xcode بسبب تكامله مع مصحح LLDB.

API التسجيل: NSLog و os_log و print

ثلاثة API رئيسية متاحة لمطور iOS للإخراج في الكونسول: NSLog (قديم)، os_log (موصى به)، و print (Swift فقط). لكل منها خصائصها من حيث الأداء والتنسيق والتوافق مع Unified Logging System.

NSLog — التسجيل الكلاسيكي

NSLog هي دالة من Foundation، متاحة في Objective-C و Swift. NSLog تخرج رسالة مع طابع زمني واسم العملية و PID. العيوب: NSLog يكتب في مخزن النظام بشكل متزامن، مما يحجب الخيط الحالي أثناء الكتابة. مع الاستدعاءات المتكررة (مثلًا في حلقة)، يُحدث NSLog تأخيرًا ملحوظًا. Apple لا توصي باستخدام NSLog للمشاريع الجديدة، لكنه يبقى متوافقًا مع الكود القديم والمكتبات الخارجية.

os_log — المعيار الحديث

os_log هي API من os.framework، تم تقديمها في iOS 10. os_log غير متزامن: يتم وضع الرسالة في قائمة انتظار وكتابتها في المخزن دون حجب الخيط المستدعي. وفقًا لـ WWDC 2016، os_log أسرع 50 مرة من NSLog في سيناريوهات الحمل العالي. os_log يدعم أيضًا التحكم الديناميكي: رسائل مستوى DEBUG تُجمع فقط في بنية Debug، وفي Release يتم تجاهلها دون أي عبء.

print() — إخراج Swift فقط

print() هي أبسط طريقة إخراج في Swift. print يكتب في stdout (الإخراج القياسي)، الذي يعيد Xcode توجيهه إلى الكونسول. print لا يضيف بيانات وصفية (وقت، مستوى)، لكنه يدعم التخزين المؤقت لـ stdout. للتصحيح السريع، print أداة مريحة، لكن للتسجيل الدائم فهو يقصر أمام os_log من حيث الوظائف والتحكم.

import os.log

// NSLog — قديم، حاظر
NSLog("Application started")

// os_log — موصى به، غير متزامن
let log = OSLog(
    subsystem: "com.myapp",
    category: "lifecycle"
)
os_log("Application started", log: log)

// print — إخراج Swift سريع
print("Application started")

Unified Logging: الفئات والمستويات والأنظمة الفرعية

Unified Logging System (ULS) هي البنية التحتية الشاملة للتسجيل من Apple، تم تقديمها في iOS 10 و macOS Sierra. ULS يجمع الرسائل من جميع عمليات النظام في مخزن واحد مع إمكانية الوصول عن بُعد عبر أداة سطر الأوامر log على Mac. يستخدم المطورون os_log للكتابة في ULS والكونسول للقراءة.

الأنظمة الفرعية والفئات

كل OSLog يتم تعريفه بواسطة زوج subsystem (مثلًا com.myapp.network) و category (مثلًا http، websocket). النظام الفرعي هو مجال التطبيق (يمكن لتطبيق واحد أن يحتوي على عدة أنظمة فرعية لوحدات مختلفة). الفئة هي مكون داخل النظام الفرعي. مجموعة subsystem + category تسمح بتصفية مرنة للسجلات في الكونسول و log collect.

مستويات تسجيل OSLog

log collect — التجميع البعيد للسجلات

أمر log collect على Mac يجمع السجلات المؤرشفة من جهاز iOS متصل في ملف .logarchive. يمكن فتح هذا الملف في Console.app على Mac لتحليل مفصل، بما في ذلك رسائل os_log وسجلات الأعطال والتشخيصات النظامية. لتفعيل التجميع على الجهاز، يجب تفعيل وضع المطور وتوصيل الجهاز عبر USB.

العمل مع الكونسول: تصحيح الأخطاء خطوة بخطوة وتحليل سجلات الأعطال

العمل العملي مع الكونسول يتضمن ثلاثة سيناريوهات رئيسية: التسجيل النشط أثناء التطوير، تحليل سجلات الأعطال بعد التعطل، والتشخيص عن بُعد عبر .logarchive. لكل سيناريو مجموعة مثلى من الأدوات والإعدادات.

إعداد الكونسول للتطوير

يوصى بإنشاء OSLog منفصل لكل وحدة من التطبيق مع مستويات: debug (تصحيح مفصل)، info (انتقالات الحالة الرئيسية)، error (الاستثناءات والأعطال). في كونسول Xcode، فعّل التصفية حسب النظام الفرعي لتطبيقك لاستبعاد رسائل النظام التي تخلق ضوضاء وتشتت عن منطق التطبيق.

تحليل سجلات الأعطال

عند تعطل التطبيق، Xcode يوقف التنفيذ تلقائيًا ويظهر الخيط الذي حدث فيه العطل، مع stack trace كامل في الكونسول. السطر الأول من سجل العطل يحتوي على نوع الاستثناء (NSException، EXC_BAD_ACCESS) والسبب. ادرس stack trace من الأسفل إلى الأعلى: آخر دالة تم استدعاؤها هي موقع العطل. للعناوين المشفرة (في Release)، يتطلب الأمر symbolication عبر dSYM.

// مثال على التكوين المعياري لـ OSLog
extension OSLog {
    static let uiLifecycle = OSLog(
        subsystem: "com.myapp.ui",
        category: "lifecycle"
    )
    static let network = OSLog(
        subsystem: "com.myapp.network",
        category: "http"
    )
    static let database = OSLog(
        subsystem: "com.myapp.data",
        category: "core-data"
    )
}

// الاستخدام مع المستويات
os_log("View did load", log: .uiLifecycle, type: .debug)
os_log("HTTP 200 received", log: .network, type: .info)
os_log("Failed to save: \(error.localizedDescription)",
    log: .database, type: .error)

الميزات المتقدمة: سجلات نقاط الإيقاف والتنسيقات المخصصة

كونسول Xcode يدعم العديد من الميزات المتقدمة التي تتجاوز التسجيل البسيط. سجلات نقاط الإيقاف تسمح بإخراج رسائل إلى الكونسول دون إيقاف التنفيذ، وأوامر LLDB في Debugger Command تعطي تحكمًا كاملاً في تنسيق الإخراج.

سجلات نقاط الإيقاف دون توقف

يمكنك تكوين نقطة إيقاف لإخراج رسالة إلى الكونسول ومواصلة التنفيذ تلقائيًا. ضع نقطة إيقاف على السطر المطلوب، انقر بزر الماوس الأيمن → Edit Breakpoint → أضف Debugger Command: «po self» أو «expr @import UIKit» + Debugger Command: «po self.view». حدد Automatically continue after evaluating. بعد التشغيل، ستخرج نقطة الإيقاف نتيجة الأمر إلى الكونسول في كل مرة يتم الوصول إلى السطر، دون مقاطعة الخيط.

أوامر LLDB في الكونسول

كونسول Xcode يدعم تنفيذ أوامر LLDB عشوائية أثناء التوقف عند نقطة إيقاف. po (print object) يخرج وصف الكائن، p (print) يخرج القيم البدائية، و expr ينفذ تعبيرات Swift/ObjC. للإخراج المنسق، استخدم p/CGRectGetWidth. يظهر إخراج LLDB في الكونسول فور الوصول إلى نقطة الإيقاف.

func processUserData(user: User) {
    // نقطة الإيقاف هنا مع Debugger Command:
    // po "User name: \(user.name)"
    // expr user.age = 30
    print("Processing user: \(user.name)")
}

// مثال على تسجيل مخصص مع تسلسل
func trackMethodCall(
    file: String = #file,
    function: String = #function
) {
    os_log("[\(function)] called",
        log: .uiLifecycle, type: .debug)
}

التكامل مع Instruments

كونسول Xcode مدمج بشكل وثيق مع Instruments — أداة التنميط في Xcode. عند تشغيل التطبيق عبر Product → Profile مع قالب Logging، يتم تسجيل جميع رسائل os_log في مسار Instruments مع طوابع زمنية. هذا يسمح برؤية السجلات والأداء وأحداث النظام في آن واحد على خط زمني واحد، وهو أمر بالغ الأهمية لتشخيص حالات السباق والتراجعات في الأداء.