- نحو:
<uses-permission-sdk-23 android:name="string" android:maxSdkVersion="integer" />
- موجود در:
-
<manifest>
- توضیحات:
- مشخص میکند که یک برنامه مجوز خاصی میخواهد، اما فقط در صورتی که برنامه روی دستگاهی با Android 6.0 (سطح API 23) یا بالاتر نصب شده باشد. اگر دستگاه دارای API سطح 22 یا پایین تر باشد، برنامه مجوز مشخص شده را نمی خواهد.
این عنصر زمانی مفید است که برنامهای را بهروزرسانی میکنید تا ویژگی جدیدی را که به مجوز اضافی نیاز دارد، اضافه کنید. اگر کاربر برنامهای را در دستگاهی که دارای API سطح 22 یا پایینتر است، بهروزرسانی کند، سیستم در زمان نصب از کاربر میخواهد همه مجوزهای جدیدی را که در آن بهروزرسانی اعلام شده است، اعطا کند. اگر یک ویژگی جدید به اندازه کافی جزئی است، ممکن است ترجیح دهید این ویژگی را به طور کلی در آن دستگاهها غیرفعال کنید، بنابراین کاربر مجبور نیست مجوزهای اضافی را برای بهروزرسانی برنامه اعطا کند.
با استفاده از عنصر
<uses-permission-sdk-23>
به جای<uses-permission>
، فقط در صورتی میتوانید مجوز را درخواست کنید که برنامه روی پلتفرمهایی اجرا شود که از مدل مجوزهای زمان اجرا پشتیبانی میکنند، که در آن کاربر به برنامه مجوز میدهد. در حالی که در حال اجرا است.برای اطلاعات بیشتر در مورد مجوزها، به بخش مجوزها در نمای کلی مانیفست برنامه و راهنمای مجوزها در Android مراجعه کنید. لیستی از مجوزهای تعریف شده توسط پلتفرم پایه در
android.Manifest.permission
موجود است. - صفات:
-
android:name
- نام مجوز. این مجوز می تواند یکی از مجوزهای تعریف شده توسط برنامه با عنصر
<permission>
باشد، می تواند مجوزی باشد که توسط برنامه دیگری تعریف شده است، یا می تواند یکی از مجوزهای استاندارد سیستم باشد، مانند"android.permission.CAMERA"
یا"android.permission.READ_CONTACTS"
. -
android:maxSdkVersion
- بالاترین سطح API که در آن این مجوز به برنامه شما اعطا می شود. اگر برنامه روی دستگاهی با سطح API بعدی نصب شود، به برنامه اجازه داده نمیشود و نمیتواند از هیچ عملکرد مرتبطی استفاده کند.
-
- معرفی شده در:
- سطح API 23
- همچنین ببینید:
<uses-permission-sdk-23>
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و 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-permission-sdk-23\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cuses-permission-sdk-23 android:name=\"string\"\n android:maxSdkVersion=\"integer\" /\u003e\n ```\n\ncontained in:\n: [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element)\n\n\ndescription:\n\n: Specifies that an app wants a particular permission, but only if the app is installed on a device running Android 6.0 (API level 23) or higher. If the device runs API level 22 or lower, the app doesn't want the specified permission.\n This element is useful when you update an app to include a new\n feature that requires an additional permission. If a user updates an app on a\n device that is running API level 22 or lower, the system prompts the user\n at install time to grant all new permissions that are declared in that\n update. If a new feature is minor enough, you might prefer to disable\n the feature altogether on those devices, so the user doesn't have to grant\n additional permissions to update the app.\n\n By using the\n `\u003cuses-permission-sdk-23\u003e` element instead of [`\u003cuses-permission\u003e`](/guide/topics/manifest/uses-permission-element),\n you can request the permission *only* if the app is running on\n platforms that support the [runtime permissions](/training/permissions/requesting)\n model, in which the user\n grants permissions to the app while it is running.\n\n\n For more information on permissions, see the [Permissions](/guide/topics/manifest/manifest-intro#perms)\n section in the app manifest overview and the [Permissions on Android](/guide/topics/permissions)\n guide. A list of permissions defined by the base platform is available\n at [android.Manifest.permission](/reference/android/Manifest.permission).\n\nattributes:\n:\n\n `android:name`\n :\n The name of the permission. This permission can be one defined by the\n app with the [\u003cpermission\u003e](/guide/topics/manifest/permission-element)\n element, it can be a permission defined by another app, or it can be one\n of the standard system permissions, such as\n [\"android.permission.CAMERA\"](/reference/android/Manifest.permission#CAMERA)\n or [\"android.permission.READ_CONTACTS\"](/reference/android/Manifest.permission#READ_CONTACTS).\n\n `android:maxSdkVersion`\n :\n The highest API level at which this permission is granted to your\n app. If the app installs on a device with a later API level, the app\n isn't granted the permission and can't use any related functionality.\n\nintroduced in:\n: API level 23\n\nsee also:\n:\n - [\u003cpermission\u003e](/guide/topics/manifest/permission-element)\n - [`\u003cuses-permission\u003e`](/guide/topics/manifest/uses-permission-element)\n - [\u003cuses-feature\u003e](/guide/topics/manifest/uses-feature-element)"]]