<uses-permission>

ملاحظة: في بعض الحالات، يمكن أن تؤثر الأذونات التي تطلبها من خلال <uses-permission> في كيفية فلترة Google Play لتطبيقك. إذا طلبت إذنًا متعلّقًا بالأجهزة، مثل CAMERA، يفترض Google Play أنّ تطبيقك يتطلّب ميزة الأجهزة الأساسية ويفلتر التطبيق من الأجهزة التي لا توفِّره.

للتحكّم في الفلترة، يجب دائمًا الإفصاح بشكل واضح عن ميزات الأجهزة في عناصر <uses-feature> بدلاً من الاعتماد على Google Play "لاكتشاف" المتطلبات في عناصر <uses-permission>. وإذا أردت إيقاف الفلترة لميزة معيّنة، يمكنك إضافة سمة android:required="false" إلى بيان <uses-feature>.

للحصول على قائمة بالأذونات التي تشير إلى ميزات الأجهزة، راجِع مستندات العنصر <uses-feature>.

بناء الجملة:
<uses-permission android:name="string"
        android:maxSdkVersion="integer" />
المضمَّنة في:
<manifest>
description:
يحدد إذن النظام الذي يجب أن يمنحه المستخدم لكي يعمل التطبيق بشكل صحيح. يمنح المستخدم الأذونات عند تثبيت التطبيق، على الأجهزة التي تعمل بالإصدار 5.1 من نظام التشغيل Android والإصدارات الأقدم، أو أثناء تشغيل التطبيق على أجهزة تعمل بالإصدار 6.0 من نظام التشغيل Android والإصدارات الأحدث.

لمزيد من المعلومات حول الأذونات، يُرجى الاطّلاع على قسم الأذونات في نظرة عامة على بيان التطبيق ودليل الأذونات على Android. وتتوفّر قائمة بالأذونات التي تحدّدها المنصّة الأساسية على android.Manifest.permission.

السمات:
android:name
اسم الإذن يمكن أن يكون إذنًا يتم تحديده من خلال التطبيق الذي يتضمّن العنصر <permission> أو إذنًا يتم تحديده من قِبل تطبيق آخر أو أحد أذونات النظام العادية، مثل "android.permission.CAMERA" أو "android.permission.READ_CONTACTS". كما توضح هذه الأمثلة، يتضمن اسم الإذن عادةً اسم الحزمة كبادئة.
android:maxSdkVersion
أعلى مستوى لواجهة برمجة التطبيقات يتم فيه منح هذا الإذن لتطبيقك. يكون ضبط هذه السمة مفيدًا إذا لم يعد الإذن الذي يتطلبه تطبيقك مطلوبًا بدءًا من مستوى معيّن لواجهة برمجة التطبيقات.

على سبيل المثال، بدءًا من الإصدار Android 4.4 (المستوى 19 من واجهة برمجة التطبيقات)، لن يكون من الضروري لتطبيقك أن يطلب إذن WRITE_EXTERNAL_STORAGE للكتابة في أدلة التطبيق الخاصة به على وحدة التخزين الخارجية، والتي يتم توفيرها من قِبل getExternalFilesDir().

ومع ذلك، يجب منح الإذن للمستوى 18 من واجهة برمجة التطبيقات والمستويات الأدنى. لذلك يمكنك توضيح أنّ هذا الإذن مطلوب فقط حتى المستوى 18 من واجهة برمجة التطبيقات من خلال بيان كما يلي:

<uses-permission
     android:name="android.permission.WRITE_EXTERNAL_STORAGE"
     android:maxSdkVersion="18" />

وبهذه الطريقة، بدايةً من المستوى 19 لواجهة برمجة التطبيقات، لن يمنح النظام تطبيقك إذن WRITE_EXTERNAL_STORAGE بعد الآن.

تمّت الإضافة في المستوى 19 من واجهة برمجة التطبيقات.

تم تقديمه في:
المستوى 1 من واجهة برمجة التطبيقات
راجِع أيضًا: