ربط الملفات الشخصية جزء من Android Jetpack
ربط العرض هي ميزة تسهّل كتابة الرموز البرمجية التي تتفاعل مع طرق العرض. بعد تفعيل ميزة "ربط الملفات الشخصية" في وحدة معيّنة، يتم إنشاء فئة ربط لكل ملف تنسيق XML في تلك الوحدة. يحتوي مثيل فئة الربط على مراجع مباشرة لجميع طرق العرض التي لها معرّف في التنسيق المقابل.
في معظم الحالات، تحلّ ميزة "ربط العرض" محلّ findViewById.
الإعداد
يتم تفعيل ربط العرض على أساس كل وحدة على حدة. لتفعيل ميزة "ربط الملفات الشخصية" في وحدة معيّنة، اضبط خيار الإصدار viewBinding على true في ملف build.gradle على مستوى الوحدة، كما هو موضّح في المثال التالي:
أنيق
android { ... buildFeatures { viewBinding true } }
Kotlin
android { ... buildFeatures { viewBinding = true } }
إذا أردت تجاهل ملف تنسيق أثناء إنشاء فئات الربط، أضِف السمة tools:viewBindingIgnore="true" إلى طريقة العرض الجذر لملف التنسيق هذا:
<LinearLayout
...
tools:viewBindingIgnore="true" >
...
</LinearLayout>
الاستخدام
إذا تم تفعيل ميزة "ربط الملفات الشخصية" لوحدة معيّنة، يتم إنشاء فئة ربط لكل ملف تنسيق XML تحتوي عليه الوحدة. تحتوي كل فئة ربط على مراجع للعرض الجذر وجميع العروض التي لها معرّف. يتم إنشاء اسم فئة الربط عن طريق تحويل اسم ملف XML إلى حالة باسكال وإضافة كلمة "ربط" إلى النهاية.
على سبيل المثال، لنفترض أنّ لدينا ملف تنسيق باسم result_profile.xml يحتوي على ما يلي:
<LinearLayout ... >
<TextView android:id="@+id/name" />
<ImageView android:cropToPadding="true" />
<Button android:id="@+id/button"
android:background="@drawable/rounded_button" />
</LinearLayout>
يُطلق على فئة الربط التي تم إنشاؤها اسم ResultProfileBinding. تحتوي هذه الفئة على حقلَين: TextView باسم name وButton باسم button. لا يحتوي ImageView في التنسيق على معرّف، لذا لا توجد إشارة إليه في فئة الربط.
تتضمّن كل فئة ربط أيضًا طريقة getRoot()، ما يوفّر مرجعًا مباشرًا لطريقة العرض الجذر لملف التنسيق المقابل. في هذا المثال، تُرجع طريقة getRoot() في فئة ResultProfileBinding طريقة عرض الجذر LinearLayout.
توضّح الأقسام التالية استخدام فئات الربط التي تم إنشاؤها في الأنشطة والأجزاء.
استخدام ميزة "عرض الروابط" في الأنشطة
لإعداد مثيل لفئة الربط لاستخدامه مع نشاط، نفِّذ الخطوات التالية في الإجراء onCreate() الخاص بالنشاط:
- استدعِ طريقة
inflate()الثابتة المضمّنة في فئة الربط التي تم إنشاؤها. يؤدي هذا إلى إنشاء مثيل لفئة الربط ليستخدمه النشاط. - احصل على مرجع للعرض الجذر إما من خلال استدعاء طريقة
getRoot()أو باستخدام بنية سمة Kotlin. - مرِّر العرض الجذر إلى
setContentView()لجعله العرض النشط على الشاشة.
تظهر هذه الخطوات في المثال التالي:
Kotlin
private lateinit var binding: ResultProfileBinding
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
binding = ResultProfileBinding.inflate(layoutInflater)
val view = binding.root
setContentView(view)
}
Java
private ResultProfileBinding binding;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
binding = ResultProfileBinding.inflate(getLayoutInflater());
View view = binding.getRoot();
setContentView(view);
}
يمكنك الآن استخدام مثيل فئة الربط للإشارة إلى أي من طرق العرض:
Kotlin
binding.name.text = viewModel.name
binding.button.setOnClickListener { viewModel.userClicked() }
Java
binding.name.setText(viewModel.getName());
binding.button.setOnClickListener(new View.OnClickListener() {
viewModel.userClicked()
});
استخدام ميزة "ربط الملفات الشخصية" في الأجزاء
لإعداد مثيل لفئة الربط لاستخدامه مع جزء، نفِّذ الخطوات التالية في طريقة onCreateView() الخاصة بالجزء:
- استدعِ طريقة
inflate()الثابتة المضمّنة في فئة الربط التي تم إنشاؤها. يؤدي هذا إلى إنشاء مثيل لفئة الربط ليستخدمه الجزء. - احصل على مرجع للعرض الجذر إما من خلال استدعاء طريقة
getRoot()أو باستخدام بنية سمة Kotlin. - يجب عرض طريقة العرض الجذر من طريقة
onCreateView()لجعلها طريقة العرض النشطة على الشاشة.
Kotlin
private var _binding: ResultProfileBinding? = null
// This property is only valid between onCreateView and
// onDestroyView.
private val binding get() = _binding!!
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?
): View? {
_binding = ResultProfileBinding.inflate(inflater, container, false)
val view = binding.root
return view
}
override fun onDestroyView() {
super.onDestroyView()
_binding = null
}
Java
private ResultProfileBinding binding;
@Override
public View onCreateView (LayoutInflater inflater,
ViewGroup container,
Bundle savedInstanceState) {
binding = ResultProfileBinding.inflate(inflater, container, false);
View view = binding.getRoot();
return view;
}
@Override
public void onDestroyView() {
super.onDestroyView();
binding = null;
}
يمكنك الآن استخدام مثيل فئة الربط للإشارة إلى أي من طرق العرض:
Kotlin
binding.name.text = viewModel.name
binding.button.setOnClickListener { viewModel.userClicked() }
Java
binding.name.setText(viewModel.getName());
binding.button.setOnClickListener(new View.OnClickListener() {
viewModel.userClicked()
});
تقديم تلميحات حول الإعدادات المختلفة
عند تحديد طرق العرض في إعدادات متعددة، يكون من المنطقي أحيانًا استخدام نوع عرض مختلف بناءً على التنسيق المحدد. يعرض مقتطف الرمز التالي مثالاً على ذلك:
# in res/layout/example.xml
<TextView android:id="@+id/user_bio" />
# in res/layout-land/example.xml
<EditText android:id="@+id/user_bio" />
في هذه الحالة، قد تتوقّع أن يعرض الصنف الذي تم إنشاؤه حقلاً userBio
من النوع TextView، لأنّ TextView هو الصنف الأساسي المشترك. بسبب القيود الفنية، لا يمكن لمنشئ رمز ربط العرض تحديد ذلك، وينشئ حقل View بدلاً من ذلك. يتطلب ذلك تحويل الحقل لاحقًا باستخدام
binding.userBio as TextView.
للتغلب على هذا القيد، تتيح ميزة "ربط العرض" استخدام السمة tools:viewBindingType، ما يتيح لك إخبار برنامج التجميع بالنوع الذي يجب استخدامه في الرمز الذي تم إنشاؤه.
في المثال السابق، يمكنك استخدام هذه السمة لجعل برنامج التجميع
ينشئ الحقل كـ TextView:
# in res/layout/example.xml (unchanged)
<TextView android:id="@+id/user_bio" />
# in res/layout-land/example.xml
<EditText android:id="@+id/user_bio" tools:viewBindingType="TextView" />
في مثال آخر، لنفترض أنّ لديك تنسيقَين، أحدهما يحتوي على
BottomNavigationView والآخر يحتوي على NavigationRailView. توسّع كلتا الفئتين NavigationBarView، التي تحتوي على معظم تفاصيل التنفيذ. إذا لم يكن الرمز بحاجة إلى معرفة الفئة الفرعية المحددة الموجودة في
التنسيق الحالي، يمكنك استخدام tools:viewBindingType لضبط النوع الذي تم إنشاؤه
على NavigationBarView في كلا التنسيقين:
# in res/layout/navigation_example.xml
<BottomNavigationView android:id="@+id/navigation" tools:viewBindingType="NavigationBarView" />
# in res/layout-w720/navigation_example.xml
<NavigationRailView android:id="@+id/navigation" tools:viewBindingType="NavigationBarView" />
لا يمكن لربط العرض التحقّق من صحة قيمة هذه السمة عند إنشاء الرمز. لتجنُّب الأخطاء أثناء التجميع والتشغيل، يجب أن تستوفي القيمة الشروط التالية:
- يجب أن تكون القيمة فئة تكتسب من
android.view.View. يجب أن تكون القيمة فئة فائقة للعلامة التي تم وضعها عليها. على سبيل المثال، لا يمكن استخدام القيم التالية:
<TextView tools:viewBindingType="ImageView" /> <!-- ImageView is not related to TextView. --> <TextView tools:viewBindingType="Button" /> <!-- Button is not a superclass of TextView. -->يجب أن يتم حلّ النوع النهائي بشكل متّسق في جميع الإعدادات.
الاختلافات عن findViewById
توفّر ميزة "عرض الروابط" مزايا مهمة مقارنةً باستخدام findViewById:
- أمان القيم الفارغة: بما أنّ ربط الملفات الشخصية ينشئ مراجع مباشرة للملفات الشخصية،
فلا يوجد خطر من حدوث استثناء المؤشر الفارغ بسبب رقم تعريف ملف شخصي غير صالح.
بالإضافة إلى ذلك، عندما يكون العرض موجودًا فقط في بعض إعدادات
التنسيق، يتم وضع علامة
@Nullableعلى الحقل الذي يحتوي على مرجعه في فئة الربط. - منع أخطاء الكتابة: تحتوي الحقول في كل فئة ربط على أنواع تطابق طرق العرض التي تشير إليها في ملف XML. وهذا يعني أنّه ما مِن خطر لحدوث استثناء في تحويل الفئات
تعني هذه الاختلافات أن حالات عدم التوافق بين التخطيط والرمز تؤدي إلى فشل الإنشاء في وقت التجميع بدلاً من وقت التشغيل.
المقارنة مع ربط البيانات
تُنشئ كل من ميزة "ربط العرض" وربط البيانات فئات ربط يمكنك استخدامها للإشارة إلى العروض مباشرةً. ومع ذلك، تهدف ميزة "ربط العرض" إلى التعامل مع حالات الاستخدام الأبسط وتوفّر المزايا التالية مقارنةً بميزة "ربط البيانات":
- تجميع أسرع: لا تتطلّب ميزة "ربط الملفات الشخصية" معالجة التعليقات التوضيحية، لذا تكون أوقات التجميع أسرع.
- سهولة الاستخدام: لا تتطلّب ميزة "ربط العرض" ملفات تنسيق XML تحمل علامات خاصة، لذا يمكن استخدامها بشكل أسرع في تطبيقاتك. بعد تفعيل ربط الملفات الشخصية في وحدة معيّنة، يتم تطبيقه على جميع تنسيقات هذه الوحدة تلقائيًا.
من ناحية أخرى، فإن ربط العرض له القيود التالية مقارنة بربط البيانات:
- لا تتيح ميزة "ربط العرض" استخدام متغيرات التنسيق أو تعبيرات التنسيق، لذا لا يمكن استخدامها للإعلان عن محتوى واجهة المستخدم الديناميكي مباشرةً من ملفات تنسيق XML.
- لا تتيح ميزة "ربط العرض" ربط البيانات الثنائي الاتجاه.
لهذه الأسباب، من الأفضل في بعض الحالات استخدام كل من ربط العرض وربط البيانات في المشروع. يمكنك استخدام ربط البيانات في التخطيطات التي تتطلب ميزات متقدمة واستخدام ربط العرض في التخطيطات التي لا تتطلب ذلك.
مراجع إضافية
لمزيد من المعلومات حول ربط الملفات الشخصية، يُرجى الاطّلاع على المراجع الإضافية التالية:
المدوّنات
الفيديوهات
التطبيقات المقترَحة لك
- ملاحظة: يتم عرض نص الرابط عندما يكون JavaScript غير مفعَّل
- Migrate from Kotlin synthetics to Jetpack view binding
- التصاميم وتعبيرات الربط
- بنية التطبيق: طبقة واجهة المستخدم - البدء - مطوّرو تطبيقات Android