<uses-native-library>

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

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

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

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

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

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

ویژگی android:required در بخش بعدی به تفصیل توضیح داده شده است.

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

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

معرفی شده در:
سطح API 31
همچنین ببینید: