نقل البيانات من مواد Kotlin الاصطناعية إلى ربط طريقة العرض في Jetpack

تم إيقاف إضافات Kotlin لنظام التشغيل Android نهائيًا، ما يعني أنّ استخدام المواد الاصطناعية بلغة Kotlin لربط الملفات الشخصية لم يعُد متاحًا. إذا كان تطبيقك يستخدم تركيبات Kotlin لربط طريقة العرض، يمكنك استخدام هذا الدليل لنقل البيانات إلى ربط عرض Jetpack.

إذا لم يكن تطبيقك يستخدم المواد الاصطناعية بلغة Kotlin لربط العرض، يُرجى الاطّلاع على ربط العرض للحصول على معلومات الاستخدام الأساسية.

تعديل ملف Gradle

على غرار إضافات Android، يتم تفعيل ربط عرض Jetpack على أساس كل وحدة على حدة. في كل وحدة تستخدم ربط العرض، عليك ضبط خيار إصدار viewBinding على true في ملف build.gradle على مستوى الوحدة:

android {
    ...
    buildFeatures {
        viewBinding true
    }
}

android {
    ...
    buildFeatures {
        viewBinding = true
    }
}

إذا لم يكن تطبيقك يستخدم ميزات Parcelable، يُرجى إزالة السطر الذي يتيح إضافات Kotlin لنظام التشغيل Android:

plugins {
  id 'kotlin-android-extensions'
}

plugins {
    kotlin("android.extensions")
}

للحصول على مزيد من المعلومات حول تفعيل ربط العرض في إحدى الوحدات، اطّلِع على تعليمات الإعداد.

تعديل الأنشطة وفئات الأجزاء

باستخدام ربط عرض Jetpack، يتم إنشاء فئة ربط لكل ملف تنسيق XML تحتوي عليه الوحدة. يكون اسم فئة الربط هذه هو اسم ملف XML في حالة Pascal مع إضافة كلمة الربط في نهايته. على سبيل المثال، إذا كان اسم ملف التنسيق هو result_profile.xml، يكون اسم فئة الربط التي تم إنشاؤها هو ResultProfileBinding.

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

1. عليك إزالة جميع عمليات الاستيراد من kotlinx.android.synthetic.

2. يمكنك تضخيم مثيل من فئة الربط التي تم إنشاؤها من أجل استخدام النشاط أو الجزء.

   • بالنسبة إلى الأنشطة، اتّبِع التعليمات الواردة في استخدام ربط العرض في الأنشطة لمضخّمة مثيل في طريقة onCreate() لنشاطك.
   • بالنسبة إلى الأجزاء، اتّبِع التعليمات الواردة في استخدام ربط طريقة العرض في الأجزاء لتضخيم مثيل في طريقة onCreateView() للجزء.

3. غيِّر جميع مراجع الملف الشخصي لاستخدام مثيل فئة الربط بدلاً من السمات الاصطناعية:

// Reference to "name" TextView using synthetic properties.
name.text = viewModel.nameString

// Reference to "name" TextView using the binding class instance.
binding.name.text = viewModel.nameString

لمزيد من المعلومات، راجِع قسم الاستخدام في دليل ربط طريقة العرض.