<compatible-approvals>
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
- بناء الجملة:
-
<compatible-screens>
<screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
| "280" | "360" | "420" | "480" | "560" ] />
...
</compatible-screens>
- الواردة في:
<manifest>- description:
- يحدد هذا الإعداد كل إعداد شاشة يتوافق معه التطبيق. مثيل واحد فقط
مسموح بها من العنصر
<compatible-screens> في البيان، ولكن يمكن أن
ستحتوي على عناصر <screen> متعددة. كل عنصر <screen>
مجموعة محددة لكثافة حجم الشاشة التي يتوافق معها التطبيق.
لا يقرأ نظام Android بيان <compatible-screens>.
العنصر في أي وقت. هذا العنصر إعلامي فقط ويتم استخدامه
من خلال الخدمات الخارجية، مثل Google Play، للتعرّف بشكل أفضل على توافق التطبيق
مع تهيئات شاشة محددة ولتفعيل التصفية للمستخدمين.
أي تهيئة للشاشة
لم يتم تعريفه في هذا العنصر هو شاشة غير
متوافقة. لا توفر الخدمات الخارجية، مثل Google Play، التطبيق
الأجهزة بهذه الشاشات.
تنبيه: في العادة، لا تستخدم هذا البيان.
. يمكن أن يؤدي استخدام هذا العنصر إلى تقليل قاعدة المستخدمين المحتملين بشكل كبير
عن طريق منع المستخدمين من تثبيت تطبيقك إذا كان لديهم جهاز مزود بشاشة
والتكوين الذي لا تدرجه. ويمكنك استخدامه كحلٍ أخير فقط، عندما
لا يعمل مطلقًا مع عمليات تهيئة شاشة معينة. بدلاً من استخدام هذا
يمكنك اتّباع الدليل التوافق مع شاشات متعددة
توفير دعم قابل للتوسع لشاشات متعددة باستخدام تنسيقات بديلة وصور نقطية
لمختلف أحجام الشاشات وكثافاتها.
إذا كنت تريد ضبط حدّ أدنى لحجم الشاشة في تطبيقك، استخدِم العنصر <supports-screens>. على سبيل المثال، إذا أردت أن يكون تطبيقك متاحًا
للأجهزة ذات الشاشات الكبيرة والكبيرة جدًا فقط، يتيح العنصر <supports-screens>
أنت تقرّ بأنّ تطبيقك لا يتوافق مع أحجام الشاشات الصغيرة والعادية.
وبعد ذلك، تعمل الخدمات الخارجية مثل Google Play على فلترة تطبيقك وفقًا لذلك. يمكنك أيضًا استخدام صفحة
<supports-screens> للإشارة إلى ما إذا كان النظام يمكنه تغيير حجم
تطبيقات لأحجام الشاشات المختلفة.
لمزيد من المعلومات حول طريقة فلترة Google Play للتطبيقات باستخدام هذه الميزة
عناصر البيان الأخرى، يُرجى الاطّلاع على الفلاتر على Google Play.
- العناصر الفرعية:
-
<screen>تحدِّد هذه السياسة إعدادات شاشة واحدة يتوافق معها التطبيق.
يجب وضع مثال واحد على الأقل من هذا العنصر داخل <compatible-screens>.
العنصر. يجب أن يشتمل هذا العنصر على كل من android:screenSize
android:screenDensity سمة. في حال عدم الإعلان عن الاثنين
فسيتم تجاهل العنصر.
السمات:
android:screenSize- مطلوب تُستخدَم لتحديد حجم الشاشة لإعداد الشاشة هذه.
القيم المقبولة:
smallnormallargexlarge
للحصول على معلومات حول أحجام الشاشات المختلفة، يُرجى الاطّلاع على نظرة عامة على توافق الشاشة.
android:screenDensity- مطلوب تحدِّد هذه السياسة كثافة الشاشة لإعدادات الشاشة هذه.
القيم المقبولة:
"ldpi" (120 نقطة لكل بوصة تقريبًا)"mdpi" (160 نقطة لكل بوصة تقريبًا)"hdpi" (240 نقطة لكل بوصة تقريبًا)"xhdpi" (320 نقطة لكل بوصة تقريبًا)"280""360""420""480""560"
للحصول على معلومات حول كثافات الشاشة المختلفة، يُرجى الاطّلاع على نظرة عامة على توافق الشاشة.
- على سبيل المثال
-
إذا كان تطبيقك متوافقًا مع الشاشات الصغيرة والعادية فقط، بغض النظر عن
من كثافة الشاشة، عليك تحديد 12 عنصرًا <screen>،
لأن كل حجم شاشة له ستة تكوينات مختلفة للكثافة.
يجب الإفصاح عن كل واحد من
هذه. أي مزيج من الحجم والكثافة لا تحدّده يُعتبَر شاشة.
التي لا يتوافق معها تطبيقك. إليك ما يمكن أن يحدث في البيان
يبدو إذا كان تطبيقك متوافقًا مع الشاشات الصغيرة والعادية فقط:
<manifest ... >
...
<compatible-screens>
<!-- all small size screens -->
<screen android:screenSize="small" android:screenDensity="ldpi" />
<screen android:screenSize="small" android:screenDensity="mdpi" />
<screen android:screenSize="small" android:screenDensity="hdpi" />
<screen android:screenSize="small" android:screenDensity="xhdpi" />
<screen android:screenSize="small" android:screenDensity="xxhdpi" />
<screen android:screenSize="small" android:screenDensity="xxxhdpi" />
<!-- all normal size screens -->
<screen android:screenSize="normal" android:screenDensity="ldpi" />
<screen android:screenSize="normal" android:screenDensity="mdpi" />
<screen android:screenSize="normal" android:screenDensity="hdpi" />
<screen android:screenSize="normal" android:screenDensity="xhdpi" />
<screen android:screenSize="normal" android:screenDensity="xxhdpi" />
<screen android:screenSize="normal" android:screenDensity="xxxhdpi" />
</compatible-screens>
<application ... >
...
<application>
</manifest>
- تم تقديمها في:
- المستوى 9 من واجهة برمجة التطبيقات
- راجِع أيضًا:
- نظرة عامة على توافق الشاشة
- الفلاتر على Google Play
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# <compatible-screens\u003e\n\nsyntax:\n:\n\n ```xml\n \u003ccompatible-screens\u003e\n \u003cscreen android:screenSize=[\"small\" | \"normal\" | \"large\" | \"xlarge\"]\n android:screenDensity=[\"ldpi\" | \"mdpi\" | \"hdpi\" | \"xhdpi\"\n | \"280\" | \"360\" | \"420\" | \"480\" | \"560\" ] /\u003e\n ...\n \u003c/compatible-screens\u003e\n ```\n\ncontained in:\n: [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element)\n\ndescription:\n: Specifies each screen configuration with which the application is compatible. Only one instance\n of the `\u003ccompatible-screens\u003e` element is allowed in the manifest, but it can\n contain multiple `\u003cscreen\u003e` elements. Each `\u003cscreen\u003e` element\n specifies a specific screen size-density combination with which the application is compatible.\n\n The Android system *doesn't* read the `\u003ccompatible-screens\u003e` manifest\n element at any point. This element is informational only and is used\n by external services, such as Google Play, to better understand the application's compatibility\n with specific screen configurations and to enable filtering for users.\n\n\n Any screen configuration that\n *isn't* declared in this element is a screen with which the application *isn't*\n compatible. External services, such as Google Play, don't provide the application to\n devices with such screens.\n\n\n **Caution:** Normally, *you don't use this manifest\n element* . Using this element can dramatically reduce the potential user base for your\n application by preventing users from installing your application if they have a device with a screen\n configuration that you don't list. Use it only as a last resort, when the\n application absolutely doesn't work with specific screen configurations. Instead of using this\n element, follow the guide to [supporting multiple screens](/guide/practices/screens_support) to\n provide scalable support for multiple screens using alternative layouts and bitmaps\n for different screen sizes and densities.\n\n\n If you want to set a minimum screen size for your your application, use the [`\u003csupports-screens\u003e`](/guide/topics/manifest/supports-screens-element) element. For example, if you want your application to be available\n only for large and extra-large screen devices, the `\u003csupports-screens\u003e` element lets\n you declare that your application doesn't support small and normal screen sizes.\n Then, external services like Google Play filter your application accordingly. You can also use the\n `\u003csupports-screens\u003e` element to declare whether the system can resize your\n application for different screen sizes.\n\n\n For more information about how Google Play filters applications using this and\n other manifest elements, see [Filters on Google Play](/google/play/filters).\n\n\nchild elements:\n:\n\n `\u003cscreen\u003e`\n\n : Specifies a single screen configuration with which the application is compatible.\n\n At least one instance of this element must be placed inside the `\u003ccompatible-screens\u003e`\n element. This element must include both the `android:screenSize` and\n `android:screenDensity` attributes. If you don't declare both\n attributes, then the element is ignored.\n\n Attributes:\n\n `android:screenSize`\n : **Required.** Specifies the screen size for this screen configuration.\n\n Accepted values:\n\n - `small`\n - `normal`\n - `large`\n - `xlarge`\n\n\n For information about the different screen sizes, see [Screen compatibility overview](/guide/practices/screens_support#sizes).\n\n `android:screenDensity`\n : **Required.** Specifies the screen density for this screen configuration.\n\n Accepted values:\n\n - `\"ldpi\"` (approximately 120 dpi)\n - `\"mdpi\"` (approximately 160 dpi)\n - `\"hdpi\"` (approximately 240 dpi)\n - `\"xhdpi\"` (approximately 320 dpi)\n - `\"280\"`\n - `\"360\"`\n - `\"420\"`\n - `\"480\"`\n - `\"560\"`\n\n\n For information about the different screen densities, see [Screen compatibility overview](/guide/practices/screens_support#density).\n\n\nexample\n\n: If your application is compatible with only small and normal screens, regardless\n of screen density, then you must specify 12 `\u003cscreen\u003e` elements,\n because each screen size has six different density configurations.\n\n You must declare each one of\n these. Any combination of size and density that you *don't* specify is considered a screen\n configuration with which your application *isn't* compatible. Here's what the manifest\n entry looks like if your application is compatible with only small and normal screens: \n\n ```xml\n \u003cmanifest ... \u003e\n ...\n \u003ccompatible-screens\u003e\n \u003c!-- all small size screens --\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"ldpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"mdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"hdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"xhdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"xxhdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"xxxhdpi\" /\u003e\n \u003c!-- all normal size screens --\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"ldpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"mdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"hdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"xhdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"xxhdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"xxxhdpi\" /\u003e\n \u003c/compatible-screens\u003e\n \u003capplication ... \u003e\n ...\n \u003capplication\u003e\n \u003c/manifest\u003e\n ```\n\nintroduced in:\n: API level 9\n\nsee also:\n: [Screen compatibility overview](/guide/practices/screens_support)\n: [Filters on Google Play](/google/play/filters)"]]
