<uses-authorized-library>

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

تحدّد هذه السمة مكتبة أصلية مشترَكة يوفّرها المورّد يجب ربط التطبيق بها. يطلب هذا العنصر من النظام إتاحة الوصول إلى المكتبة الأصلية للحزمة.

يمكن الوصول إلى مكتبات NDK تلقائيًا، وبالتالي لا تتطلّب العلامة <uses-native-library>.

لا يمكن الوصول تلقائيًا إلى المكتبات المشترَكة المجمّعة من رموز برمجية أصلية غير التابعة لحزمة تطوير البرامج (NDK) والتي يوفّرها مورّدو شرائح السيليكون أو مصنّعو الأجهزة، وذلك إذا كان التطبيق يستهدف الإصدار 12 من نظام التشغيل Android (المستوى 31 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث. ولا يمكن الوصول إلى المكتبات إلا عند طلبها صراحةً باستخدام العلامة <uses-native-library>.

إذا كان التطبيق يستهدف الإصدار 11 من نظام التشغيل Android (المستوى 30 لواجهة برمجة التطبيقات) أو إصدارًا أقدم، لن يكون من الضروري استخدام العلامة <uses-native-library>. في هذه الحالة، يمكن الوصول إلى أي مكتبة مشتركة أصلية بغض النظر عمّا إذا كانت مكتبة NDK أم لا.

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

يتم وصف السمة android:required بالتفصيل في القسم التالي.

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

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

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