<صفحه نمایش سازگار>

نحو:
<compatible-screens>
    <screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
            android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
                                   | "280" | "360" | "420" | "480" | "560" ] />
    ...
</compatible-screens>
موجود در:
<manifest>
توضیحات:
هر پیکربندی صفحه را که برنامه با آن سازگار است را مشخص می کند. فقط یک نمونه از عنصر <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 dpi)
  • "xhdpi" (تقریباً 320 dpi)
  • "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>
معرفی شده در:
API سطح 9
همچنین ببینید:
نمای کلی سازگاری با صفحه نمایش
فیلترها در گوگل پلی
،
نحو:
<compatible-screens>
    <screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
            android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
                                   | "280" | "360" | "420" | "480" | "560" ] />
    ...
</compatible-screens>
موجود در:
<manifest>
توضیحات:
هر پیکربندی صفحه را که برنامه با آن سازگار است را مشخص می کند. فقط یک نمونه از عنصر <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 dpi)
  • "xhdpi" (تقریباً 320 dpi)
  • "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>
معرفی شده در:
API سطح 9
همچنین ببینید:
نمای کلی سازگاری با صفحه نمایش
فیلترها در گوگل پلی