- بنية الجملة:
-
<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 من واجهة برمجة التطبيقات
- راجِع أيضًا:
<uses-authorized-library>
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-13 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]