البدء

الإعلانات

البدء

تعرف على كيفية إعداد بيئة التطوير الخاصة بك للعمل مع مكتبة ربط البيانات، بما في ذلك دعم كود ربط البيانات في أندرويد ستوديو.

توفر مكتبة ربط البيانات مرونة وتوافق واسع – فهي مكتبة دعم، لذا يمكنك إستخدامها مع الأجهزة التي تعمل بنظام أندرويد 4.0 (المستوى 14) أو أعلى.

يوصى بإستخدام أحدث إصدار من إضافات الأندرويد لـ Gradle في مشروعك. ومع ذلك، تم دعم ربط البيانات في الإصدار 1.5.0 والإصدارات الأحدث.

لمزيد من المعلومات، راجع كيفية تحديث إضافات الأندرويد لـ Gradle.

 

بيئة البناء


للبدء مع ربط البيانات، قم بتنزيل المكتبة من مستودع الدعم في مدير أندرويد SDK. لمزيد من المعلومات، راجع تحديث أدوات IDE و SDK.

لتهيئة تطبيقك لإستخدام ربط البيانات، قم بإضافة عنصر ربط البيانات dataBinding إلى ملف البناء build.gradle الخاص بك في وحدة التطبيق، كما هو موضح في المثال التالي:

android {
    ...
    dataBinding {
        enabled = true
    }
}

 

ملاحظة: يجب عليك تهيئة ربط البيانات للوحدة النمطية للتطبيق التي تعتمد على المكتبات التي تستخدم ربط البيانات..

حتى لو كانت وحدة التطبيق النمطية لا تستخدم ربط البيانات مباشرة.

 

 

دعم أندرويد ستوديو لربط البيانات


يدعم أندرويد ستوديو العديد من ميزات التعديل لكود ربط البيانات. على سبيل المثال، يدعم الميزات التالية لعبارات ربط البيانات:

– تسليط الضوء على تركيب الجملة.
– وضع علامات على الأخطاء اللغوية في لغة التعبير.
– إكمال كود XML.
– المراجع، بما في ذلك الملاحة (مثل الإنتقال إلى تصريح) والوثائق السريعة.

 

تنبيه: المصفوفات والنوع العام، مثل فئة Observable، قد تعرضان الأخطاء بشكلٍ غير صحيح.

 

يعرض جزء المعاينة في محرر المخطط، القيمة الإفتراضية لتعبيرات ربط البيانات، إن توفرت.

مثال، يعرض جزء المعاينة قيمة my_default في ودجت النص TextView المعلن عنه في المثال التالي:

 

إذا كنت بحاجة إلى عرض قيمة إفتراضية فقط أثناء مرحلة تصميم المشروع، فيمكنك إستخدام سمات الأدوات tools..

بدلاً من قيم التعبير الإفتراضية، كما هو موضح في مرجع سمات الأدوات.

 

 

مترجم ربط بيانات جديدة بفئات الربط


الإصدار الأولي  من إضافة Gradle للأندرويد، يتضمن مترجم جديد لربط البيانات  يقوم بإنشاء فئات الربط.

ينشئ المترجم الجديد فئات الربط، بشكلٍ تدريجي، والذي في معظم الحالات، يؤدي إلى تسريع عملية الإنشاء.

لمعرفة المزيد حول فئات الربط، راجع فئات الربط المُنشأة. البدء

الإصدارات السابقة من مترجم ربط البيانات، تقوم بإنشاء فئات الربط، في نفس المرحلة التي تقوم فيها بتجميع الكود المُنجز.

إذا أخفق الكود المنجز في التحويل البرمجي، فقد تحصل على أخطاء متعددة، تبلغ عن عدم العثور على فئات الربط.

مترجم ربط البيانات الجديد، يمنع هذه الأخطاء، عن طريق إنشاء فئات الربط، قبل قيام المترجم المُدار ببناء تطبيقك.

لتمكين مترجم ربط البيانات الجديد، قم بإضافة الخيار التالي إلى ملف gradle.properties الخاص بك: البدء

يمكنك أيضاً تمكين المترجم الجديد في موجه أوامر gradle الخاص بك عن طريق إضافة المعامل “باراميتر” التالي:

 

ملاحظة: مترجم ربط البيانات الجديد في الإصدار 3.1 من إضافات الأندرويد لا يعتبر متوافقاً مع الإصدارات الأقدم.

تحتاج إلى إنشاء كافة فئات الربط الخاصة بك مع تمكين هذه الميزة للإستفادة من التجميع التدريجي.

ومع ذلك، فإن المترجم الجديد في إصدار 3.2 من إضافات الأندرويد متوافق مع فئات الربط التي تم إنشاؤها بإستخدام الإصدارات السابقة.

يتم تمكين المترجم الجديد في الإصدار 3.2 بشكلٍ إفتراضي.

تنطبق تغييرات السلوك التالية عندما تقوم بتمكين مترجم ربط البيانات الجديد: البدء

  •  ينشئ المكون الإضافي Gradle للأندرويد، فئات ربط لمخططاتك قبل تجميع الكود الخاص بك.

 

  •  إذا تم تضمين المخطط، في أكثر من تهيئة واحدة لمصدر مستهدف، تستخدم مكتبة ربط البيانات android.view.View

كنوع العرض الإفتراضي، لكافة طرق العرض، التي تتشارك نفس معرف المصدر وليس نوع العرض.

  •  يتم تجميع فئات الربط لوحدات المكتبات وحزمها، في ملف أرشيف الأندرويد (AAR) المتوافق. لم تعد الوحدات النمطية للتطبيق..

التي تعتمد على وحدات المكتبة هذه، بحاجة إلى إعادة إنشاء فئات الربط. لمزيد من المعلومات حول ملفات أرشيف الأندرويد، راجع إنشاء مكتبة الأندرويد.

  •  لم يعد بإمكان محولات وحدة الربط، تغيير سلوك محولات إعتمادات الوحدة. لا تؤثر محولات الربط، إلا على الكود الموجود، في الوحدة الخاصة بها والمستهلكين للوحدة.

 


للإطلاع على المقال باللغة الإنجليزية أضغط هنا.

الإعلانات

اترك رد