MetricsKit: مراقبة تطبيقات Swift (iOS/macOS)

MetricsKit هي مكتبة خفيفة الوزن لمراقبة الأداء وجمع المقاييس في تطبيقات Swift لنظامي iOS وmacOS. وهي مصممة للمطورين الذين يحتاجون إلى طريقة بسيطة وفعالة لتتبع وقت تنفيذ العمليات، وعدد مرات استدعاء الدوال، واستخدام الذاكرة، والمؤشرات الرئيسية الأخرى دون دمج خدمات خارجية ثقيلة.

لماذا تحتاج MetricsKit؟

أثناء تطوير تطبيقات الأجهزة المحمولة وسطح المكتب بلغة Swift، من المهم فهم كيفية تصرف الكود في الظروف الحقيقية. تتيح لك MetricsKit:

• قياس وقت تنفيذ أجزاء الكود الحرجة (مثل تحميل البيانات، عرض واجهة المستخدم).
• جمع إحصائيات حول تكرار استدعاءات الدوال.
• تتبع استخدام الذاكرة والتحذير من تسرب الذاكرة.
• تسجيل الأخطاء والاستثناءات مع سياق الأداء.
• تصدير المقاييس للتحليل (JSON, CSV).

هذا مفيد بشكل خاص عند تحسين واجهة المستخدم، أو العمل مع طلبات الشبكة، أو عند تطوير الألعاب باستخدام SpriteKit/SceneKit.

التثبيت

MetricsKit متاحة عبر Swift Package Manager (SPM). أضف التبعية إلى ملف Package.swift الخاص بك:

dependencies: [    .package(url: "https://github.com/yourname/MetricsKit.git", from: "1.0.0")]

أو في Xcode: File → Add Packages → الصق رابط المستودع.

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

• Timer — قياس وقت تنفيذ كتل الكود.
• Counter — عد عدد الأحداث.
• Gauge — تتبع القيم الحالية (مثل حجم ذاكرة التخزين المؤقت).
• MemoryMonitor — جمع تلقائي لبيانات ذاكرة التطبيق.
• Exporter — حفظ المقاييس في ملف أو إرسالها إلى خادم.

مثال كود بلغة Swift (iOS/macOS)

مثال بسيط لاستخدام MetricsKit لقياس وقت تحميل صورة:

import MetricsKit

class ImageLoader {    let metrics = MetricsKit.shared        func loadImage(from url: URL) async throws -> UIImage {        let timer = metrics.startTimer(name: "image_load")        defer { timer.stop() }                let (data, _) = try await URLSession.shared.data(from: url)        guard let image = UIImage(data: data) else {            throw URLError(.badServerResponse)        }                metrics.incrementCounter(name: "images_loaded")        metrics.recordGauge(name: "cache_size", value: Double(data.count))                return image    }}

بعد التنفيذ، يمكنك تصدير جميع المقاييس:

let report = metrics.export()print(report) // سلسلة JSON تحتوي على جميع البيانات

متى تستخدم MetricsKit؟

المكتبة مثالية لـ:

• تحسين الأداء قبل الإصدار.
• إنشاء أدوات مراقبة داخلية لضمان الجودة (QA).
• جمع إحصائيات مجهولة عن استخدام الوظائف.
• تعليم المبتدئين — تمثيل مرئي لكيفية عمل الكود.

لا تتطلب MetricsKit جزءًا خادمًا وتعمل محليًا بالكامل، مما يضمن خصوصية البيانات.

جرب MetricsKit في مشروعك القادم بلغة Swift واحصل على تحكم كامل في أداء التطبيق!