<uses-native-library>

نحو:
<uses-native-library
  android:name="string"
  android:required=["true" | "false"] />
موجود در:
<application>
description:

کتابخانه بومی مشترک ارائه‌شده توسط فروشنده را که برنامه باید به آن پیوند داده شود مشخص می‌کند. این عنصر به سیستم می‌گوید کتابخانه بومی را برای بسته دردسترس قرار دهد.

کتابخانه‌های NDK به‌طور پیش‌فرض دردسترس هستند و بنابراین به برچسب <uses-native-library> نیاز ندارند.

اگر برنامه Android 12 (سطح API‏ ۳۱) یا بالاتر را هدف قرار دهد، کتابخانه‌های مشترک بومی غیرNDK که توسط فروشندگان سیلیکون یا سازندگان دستگاه ارائه می‌شوند به‌طور پیش‌فرض دردسترس نیستند. کتابخانه‌ها فقط زمانی قابل‌دسترسی هستند که صریحاً بااستفاده از برچسب <uses-native-library> درخواست شده باشند.

اگر برنامه Android 11 (سطح میانای برنامه‌سازی کاربردی 30) یا پایین‌تر را هدف قرار دهد، برچسب <uses-native-library> لازم نیست. در این صورت، هر کتابخانه مشترک بومی صرف‌نظر از اینکه کتابخانه NDK باشد یا نه، قابل‌دسترسی است.

این عنصر بر نصب برنامه در دستگاهی خاص نیز تأثیر می‌گذارد. اگر این عنصر وجود داشته باشد و مشخصه android:required آن روی true تنظیم شده باشد، چارچوب PackageManager به کاربر اجازه نمی‌دهد برنامه را نصب کند، مگراینکه کتابخانه در دستگاه کاربر وجود داشته باشد.

مشخصه android:required به‌طور مفصل در بخش زیر شرح داده شده است.

مشخصه‌ها:
android:name
نام فایل کتابخانه.
android:required
مقدار بولی که نشان می‌دهد آیا برنامه به کتابخانه مشخص‌شده توسط android:name نیاز دارد یا نه.
  • "true": برنامه بدون این کتابخانه کار نمی‌کند. سیستم به برنامه اجازه نمی‌دهد در دستگاهی که کتابخانه را ندارد نصب شود.
  • "false": برنامه درصورت وجود از کتابخانه استفاده می‌کند، اما به‌گونه‌ای طراحی شده است که درصورت لزوم بدون آن نیز کار کند. سیستم به برنامه اجازه می‌دهد نصب شود، حتی اگر کتابخانه وجود نداشته باشد. اگر از "false" استفاده می‌کنید، مسئولیت مدیریت صحیح عدم وجود کتابخانه برعهده شما است.

پیش‌فرض "true" است.

معرفی‌شده در:
سطح میانای برنامه‌سازی کاربردی ۳۱
همچنین ببینید: