<uses-native-library>

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

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

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

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

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

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

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

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

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

معرفی شده در:
سطح API 31
همچنین ببینید:
،
نحو: 
<uses-native-library
  android:name="string"
  android:required=["true" | "false"] />
موجود در:
<application>
توضیحات:

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

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

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

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

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

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

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

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

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