<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" است.
معرفی شده در: سطح API 7.
- معرفی شده در:
- API سطح 1
- همچنین ببینید:
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# <uses-library\u003e\n\n**Note:** Google Play uses the `\u003cuses-library\u003e` elements declared\nin your app manifest to filter your app from devices that don't meet its\nlibrary requirements. For more information about filtering, see\n[Filters on Google Play](/google/play/filters).\n\nsyntax:\n:\n\n ```xml\n \u003cuses-library\n android:name=\"string\"\n android:required=[\"true\" | \"false\"] /\u003e\n ```\n\ncontained in:\n:\n `\n `[\u003capplication\u003e](/guide/topics/manifest/application-element)`\n `\n\ndescription:\n\n:\n Specifies a shared library that the application must be linked against.\n This element tells the system to include the library's code in the class\n loader for the package.\n\n\n All the `android` packages, such as [android.app](/reference/android/app/package-summary),\n [android.content](/reference/android/content/package-summary), [android.view](/reference/android/view/package-summary), and [android.widget](/reference/android/widget/package-summary),\n are in the default library that all applications are automatically linked\n against. However, some packages, such as `maps`, are\n in separate libraries that aren't automatically linked. Consult the\n documentation for the packages you're using to determine which library\n contains the package code.\n\n\n The order of `\u003cuses-library\u003e` tags is significant. It affects class lookup\n and resolution order when the application loads. Some of the libraries might have\n duplicate classes, and in that case the library that comes first takes priority.\n\n\n This element also affects the installation of the application on a particular device and\n the availability of the application on Google Play. If this element is present and its\n `android:required` attribute is set to `\"true\"`, the\n [PackageManager](/reference/android/content/pm/PackageManager)\n framework won't let a user install the application unless the library is present on the\n user's device.\n\n\n The `android:required` attribute is described in detail in the following section.\n\nattributes:\n:\n\n `android:name`\n :\n The name of the library. The name is provided by the\n documentation for the package you are using. An example of this is\n `\"android.test.runner\"`, a package that contains Android test\n classes.\n\n `android:required`\n :\n Boolean value that indicates whether the application requires the\n library specified by `android:name`.\n\n - `\"true\"`: the application doesn't function without this library. The system doesn't let the application install on a device that doesn't have the library.\n - `\"false\"`: the application uses the library if present, but is designed to function without it if necessary. The system lets the application install, even if the library isn't present. If you use `\"false\"`, you are responsible for checking at runtime that the library is available.\n\n\n To check for a library, you can use reflection to determine\n whether a particular class is available.\n\n\n The default is `\"true\"`.\n\n Introduced in: API level 7.\n\n\nintroduced in:\n: API Level 1\n\nsee also:\n:\n - [PackageManager](/reference/android/content/pm/PackageManager)"]]
