<uses-library>

توجه: Google Play از عناصر <uses-library> اعلام شده در مانیفست برنامه شما استفاده می‌کند تا برنامه شما را از دستگاه‌هایی که الزامات کتابخانه آن را برآورده نمی‌کنند فیلتر کند. برای اطلاعات بیشتر درباره فیلتر کردن، به فیلترها در Google Play مراجعه کنید.

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

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

همه بسته‌های android ، مانند android.app ، android.content ، android.view و android.widget در کتابخانه پیش‌فرض هستند که همه برنامه‌ها به طور خودکار با آن پیوند می‌شوند. با این حال، برخی از بسته‌ها، مانند maps ، در کتابخانه‌های جداگانه‌ای هستند که به‌طور خودکار پیوند داده نمی‌شوند. برای تعیین اینکه کدام کتابخانه حاوی کد بسته است، با مستندات بسته هایی که استفاده می کنید، مشورت کنید.

ترتیب تگ های <uses-library> قابل توجه است. هنگامی که برنامه بارگذاری می شود، جستجوی کلاس و ترتیب وضوح را تحت تأثیر قرار می دهد. برخی از کتابخانه‌ها ممکن است کلاس‌های تکراری داشته باشند، و در این صورت کتابخانه‌ای که اول می‌شود اولویت دارد.

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

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

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

    برای بررسی وجود یک کتابخانه، می توانید از بازتاب برای تعیین اینکه آیا یک کلاس خاص در دسترس است یا خیر استفاده کنید.

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

معرفی شده در: سطح API 7.

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