Flipper مع Kotlin: دليل شامل مع أمثلة تطبيقية

1. ما هو Flipper ولماذا تحتاجه؟

Flipper (المعروف سابقًا باسم Sonar) هو منصة تصحيح أخطاء لتطبيقات الهواتف المحمولة، طورها مهندسو Facebook (Meta). يوفر للمطورين واجهة موحدة لفحص وتصحيح وتحليل أداء تطبيقات Android و iOS في الوقت الفعلي. في سياق Kotlin/Android، يعمل Flipper كأداة قوية تحل محل العديد من الأدوات المنفصلة: من عرض طلبات الشبكة إلى تحليل حالة قاعدة البيانات و SharedPreferences.

المهمة الأساسية لـ Flipper هي جعل عملية تصحيح الأخطاء مرئية وتفاعلية. بدلاً من كتابة السجلات في وحدة التحكم أو استخدام أدوات التقاط حركة المرور الخارجية، تحصل على تطبيق سطح مكتب بواجهة رسومية يمكنك من خلالها رؤية هيكل تطبيقك، وإرسال الأوامر، ورؤية النتيجة فورًا. هذا مفيد بشكل خاص عند العمل مع حالات واجهة مستخدم معقدة، وتصحيح العمليات غير المتزامنة، وتحليل الأداء.

في موقع pythonlib.ru، نركز على الفائدة العملية: يتيح لك Flipper تقليل وقت البحث عن الأخطاء بنسبة 30-50% من خلال تصور البيانات المخفية عادةً عن المطور. بفضل البنية القائمة على الإضافات، يمكنك توسيع وظائف Flipper وفقًا لاحتياجاتك، وإنشاء إضافات مخصصة لتصحيح أخطاء المنطق الخاص بتطبيقك.

2. التثبيت

يتكون Flipper من جزأين: تطبيق سطح المكتب (العميل) والمكتبة المضمنة في تطبيق Android الخاص بك. يتم التثبيت في عدة خطوات.

الخطوة 1: تثبيت عميل سطح المكتب

قم بتنزيل وتثبيت Flipper من الموقع الرسمي fbflipper.com أو عبر مدير الحزم:

# macOS (Homebrew)
brew install --cask flipper

# Windows (Scoop)
scoop bucket add extras
scoop install flipper

# Linux (Snap)
sudo snap install flipper

الخطوة 2: إضافة المكتبة إلى المشروع

في ملف build.gradle.kts (على مستوى وحدة التطبيق)، أضف التبعيات:

// build.gradle.kts (Module: app)
dependencies {
    // المكتبة الأساسية لـ Flipper
    debugImplementation("com.facebook.flipper:flipper:0.182.0")
    // ربط Android (إلزامي)
    debugImplementation("com.facebook.soloader:soloader:0.10.5")
    // إضافة لطلبات الشبكة (اختياري)
    debugImplementation("com.facebook.flipper:flipper-network-plugin:0.182.0")
    // إضافة لـ SharedPreferences (اختياري)
    debugImplementation("com.facebook.flipper:flipper-sharedpreferences-plugin:0.182.0")
    // إضافة لـ Fresco (اختياري)
    debugImplementation("com.facebook.flipper:flipper-fresco-plugin:0.182.0")
}

الخطوة 3: التهيئة في Application

قم بإنشاء أو تعديل كلاس Application:

import com.facebook.flipper.android.AndroidFlipperClient
import com.facebook.flipper.plugins.inspector.DescriptorMapping
import com.facebook.flipper.plugins.inspector.InspectorFlipperPlugin
import com.facebook.flipper.plugins.network.NetworkFlipperPlugin
import com.facebook.flipper.plugins.sharedpreferences.SharedPreferencesFlipperPlugin
import com.facebook.soloader.SoLoader

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        SoLoader.init(this, false)

        if (BuildConfig.DEBUG) {
            val client = AndroidFlipperClient.getInstance(this)
            client.addPlugin(InspectorFlipperPlugin(this, DescriptorMapping.withDefaults()))
            client.addPlugin(NetworkFlipperPlugin())
            client.addPlugin(SharedPreferencesFlipperPlugin(this))
            client.start()
        }
    }
}