<uses-library>

ملاحظة: يستخدم Google Play عناصر <uses-library> المعلَن عنها في بيان التطبيق لفلترة تطبيقك من الأجهزة التي لا تستوفي متطلبات المكتبة. لمزيد من المعلومات حول الفلترة، اطّلِع على مقالة الفلاتر على Google Play.

بناء الجملة:
<uses-library
  android:name="string"
  android:required=["true" | "false"] />
المضمَّنة في:
<application>
description:

يحدِّد هذا الإعداد مكتبة مشتركة يجب ربط التطبيق بها. يطلب هذا العنصر من النظام تضمين رمز المكتبة في أداة تحميل الفئة للحزمة.

تتوفّر جميع حِزم android، مثل android.app وandroid.content وandroid.view وandroid.widget، في المكتبة التلقائية التي يتم ربط جميع التطبيقات بها تلقائيًا. وتتوفّر بعض الحِزم، مثل maps، في مكتبات منفصلة غير مرتبطة تلقائيًا. يمكنك الرجوع إلى مستندات الحِزم التي تستخدمها لتحديد المكتبة التي تحتوي على رمز الحزمة.

إنّ ترتيب علامات <uses-library> مهم. ويؤثر ذلك في البحث عن الفئة وترتيب الحلّ عند تحميل التطبيق. قد تتضمّن بعض المكتبات فئات مكرّرة، وفي هذه الحالة تكون للمكتبة التي تأتي أولاً بالأولوية.

ويؤثر هذا العنصر أيضًا في تثبيت التطبيق على جهاز معيّن ومدى توفّر التطبيق على Google Play. في حال توفّر هذا العنصر وضبط سمة android:required الخاصة به على "true"، لن يسمح إطار العمل PackageManager للمستخدم بتثبيت التطبيق ما لم تكن المكتبة متاحة على جهاز المستخدم.

يمكنك الاطّلاع على تفاصيل السمة android:required في القسم التالي.

السمات:
android:name
تمثّل هذه السمة اسم المكتبة. يتوفر الاسم في مستندات الحزمة التي تستخدمها. مثال على ذلك "android.test.runner"، وهي حزمة تحتوي على صفوف اختبار Android.
android:required
قيمة منطقية تحدّد ما إذا كان التطبيق يتطلب المكتبة المحدّدة في android:name.
  • "true": لا يعمل التطبيق بدون هذه المكتبة. لا يسمح النظام بتثبيت التطبيق على جهاز لا يحتوي على المكتبة.
  • "false": يستخدم التطبيق المكتبة إن توفّرت، ولكنّه مصمّم ليعمل بدونها إذا لزم الأمر. يسمح النظام بتثبيت التطبيق، حتى إذا لم تكن المكتبة متوفرة فيه. في حال استخدام "false"، تقع على عاتقك مسؤولية التحقق في وقت التشغيل من مدى توفّر المكتبة.

    للبحث عن مكتبة، يمكنك استخدام الانعكاس لتحديد ما إذا كان صف معيّن متاحًا أم لا.

والقيمة التلقائية هي "true".

تم إدخالها في: المستوى 7 لواجهة برمجة التطبيقات.

تم تقديمه في:
المستوى 1 من واجهة برمجة التطبيقات
راجِع أيضًا: