<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
مطلوبة. يحدِّد حجم الشاشة لإعدادات الشاشة هذه.

القيم المقبولة:

  • small
  • normal
  • large
  • xlarge

وللحصول على معلومات حول أحجام الشاشات المختلفة، يمكنك الاطّلاع على نظرة عامة على توافق الشاشة.

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