تم إيقاف إضافات Kotlin لنظام التشغيل Android نهائيًا، ما يعني أنّ استخدام المواد الاصطناعية بلغة Kotlin لربط الملفات الشخصية لم يعُد متاحًا. إذا كان تطبيقك يستخدم تركيبات Kotlin لربط طريقة العرض، يمكنك استخدام هذا الدليل لنقل البيانات إلى ربط عرض Jetpack.
إذا لم يكن تطبيقك يستخدم المواد الاصطناعية بلغة Kotlin لربط العرض، يُرجى الاطّلاع على ربط العرض للحصول على معلومات الاستخدام الأساسية.
تعديل ملف Gradle
على غرار إضافات Android، يتم تفعيل ربط عرض Jetpack على أساس كل وحدة على حدة. في كل وحدة تستخدم ربط العرض، عليك ضبط خيار إصدار viewBinding
على true
في ملف build.gradle
على مستوى الوحدة:
رائع
android { ... buildFeatures { viewBinding true } }
Kotlin
android { ... buildFeatures { viewBinding = true } }
إذا لم يكن تطبيقك يستخدم ميزات Parcelable
،
يُرجى إزالة السطر الذي يتيح إضافات Kotlin لنظام التشغيل Android:
رائع
plugins { id 'kotlin-android-extensions' }
Kotlin
plugins { kotlin("android.extensions") }
للحصول على مزيد من المعلومات حول تفعيل ربط العرض في إحدى الوحدات، اطّلِع على تعليمات الإعداد.
تعديل الأنشطة وفئات الأجزاء
باستخدام ربط عرض Jetpack، يتم إنشاء فئة ربط لكل ملف تنسيق XML تحتوي عليه الوحدة. يكون اسم فئة الربط هذه هو اسم ملف XML في حالة Pascal مع إضافة كلمة الربط في نهايته. على سبيل المثال، إذا كان
اسم ملف التنسيق هو result_profile.xml
، يكون اسم فئة الربط
التي تم إنشاؤها هو ResultProfileBinding
.
لاستخدام فئات الربط التي تم إنشاؤها بدلاً من الخصائص الاصطناعية للإشارة إلى طرق العرض، يمكنك تغيير النشاط وفئات الأجزاء من خلال تنفيذ ما يلي:
عليك إزالة جميع عمليات الاستيراد من
kotlinx.android.synthetic
.يمكنك تضخيم مثيل من فئة الربط التي تم إنشاؤها من أجل استخدام النشاط أو الجزء.
- بالنسبة إلى الأنشطة، اتّبِع التعليمات الواردة في استخدام ربط العرض
في الأنشطة لمضخّمة
مثيل في طريقة
onCreate()
لنشاطك. - بالنسبة إلى الأجزاء، اتّبِع التعليمات الواردة في استخدام ربط طريقة العرض في الأجزاء لتضخيم مثيل في طريقة
onCreateView()
للجزء.
- بالنسبة إلى الأنشطة، اتّبِع التعليمات الواردة في استخدام ربط العرض
في الأنشطة لمضخّمة
مثيل في طريقة
غيِّر جميع مراجع الملف الشخصي لاستخدام مثيل فئة الربط بدلاً من السمات الاصطناعية:
// 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
لمزيد من المعلومات، راجِع قسم الاستخدام في دليل ربط طريقة العرض.
أفلام مُقترَحة لك
- ملاحظة: يتم عرض نص الرابط عند إيقاف JavaScript.
- عرض الربط
- نظرة عامة على مكتبة نقل الصفحات
- اختبار تنفيذ عملية الترحيل