جهت، نسبت ابعادی، و قابلیت تغییر اندازه برنامه

برنامه‌های Android در انواع دستگاه‌ها اجرا می‌شوند: تلفن، رایانه لوحی، دستگاه تاشو، دستگاه ChromeOS، خودرو، تلویزیون، و حتی XR. برای سازگاری با این محیط متنوع، برنامه‌تان باید از همه اندازه‌های نمایش و ضریب‌های شکل دستگاه پشتیبانی کند.

‫Android 16 (سطح API‏ ۳۶) به برنامه‌ها امکان می‌دهد با لغو محدودیت‌های برنامه برای جهت صفحه، نسبت ابعادی، و قابلیت تغییر اندازه، با اندازه‌های نمایشگر و ابعاد مختلف سازگار شوند. لغو کردن‌ها برای دستگاه‌هایی با کمترین عرض >= ۶۰۰ پیکسل مستقل از تراکم اعمال می‌شود که موارد زیر را تعریف می‌کند:

  • رایانه لوحی
  • نمایشگرهای داخلی دستگاه‌های تاشو با صفحه‌نمایش بزرگ
  • پنجره‌بندی رایانه‌ای (در همه ضریب‌های شکل)

برنامه‌هایی که سطح میانای برنامه‌سازی کاربردی ۳۶ را هدف قرار می‌دهند، اگر کمترین عرض نمایشگر >= ۶۰۰ پیکسل مستقل از تراکم باشد، قابل‌تغییر اندازه هستند و می‌توانند وارد حالت چندپنجره‌ای (معادل resizeableActivity="true") شوند.

برنامه در دستگاه دارای صفحه‌نمایش بزرگ بازشده قبل‌از Android 16 به‌صورت جعبه‌ای نمایش داده می‌شود، اما وقتی Android 16 را هدف قرار می‌دهد، تمام‌صفحه است. برنامه در حالت تمام‌صفحه نسبت‌به حالت جعبه‌ای، موارد خبری بیشتری نشان می‌دهد.
شکل ۱. فید اخبار توسعه‌دهنده که قبلاً در دستگاه‌های با صفحه‌نمایش بزرگ به‌صورت جعبه‌ای نمایش داده می‌شد (سمت راست) وقتی Android 16 را هدف قرار می‌دهد به‌صورت تمام‌صفحه اجرا می‌شود (سمت چپ).

‫Android 16 مدل یکپارچه‌ای از طراحی برنامه تطبیقی را اعمال می‌کند که با احترام به اولویت‌های کاربر برای جهت دستگاه، نسبت ابعادی، و اندازه نمایشگر، تجربه کاربری را بهینه‌سازی می‌کند.

تغییرات

ویژگی‌های مانیفست و میاناهای برنامه‌سازی کاربردی زیر برای برنامه‌هایی که Android 16 (سطح میانای برنامه‌سازی کاربردی ۳۶) را در صفحه‌نمایش‌های بزرگ هدف قرار می‌دهند نادیده گرفته می‌شوند:

مشخصه یا میانای برنامه‌سازی کاربردی مقادیر نادیده‌گرفته‌شده
screenOrientation portrait،‏ landscape،‏ reversePortrait،‏ reverseLandscape،‏ sensorPortrait، sensorLandscape،‏ userPortrait،‏ userLandscape
resizeableActivity همه
minAspectRatio همه
maxAspectRatio همه
setRequestedOrientation()

getRequestedOrientation()
portrait،‏ landscape،‏ reversePortrait،‏ reverseLandscape،‏ sensorPortrait، sensorLandscape،‏ userPortrait،‏ userLandscape

استثناها

استثناهای تغییرات Android 16 شامل موارد زیر است:

  • نمایشگرهای کوچک‌تر از sw600dp (اکثر تلفن‌ها، تاشوها، و نمایشگرهای بیرونی دستگاه‌های تاشو با صفحه‌نمایش بزرگ)

  • بازی‌ها، براساس پرچم android:appCategory

    بازی‌تان را بااستفاده از «بسته‌های ترکیبی برنامه Android» و «امضای برنامه» Play منتشر کنید تا Google Play بتواند پرچم را مدیریت کند و مزایای بسته‌های ترکیبی برنامه را به‌طور خودکار ارائه دهد. همچنین به نمای کلی مانیفست برنامه مراجعه کنید.

  • موافقت کاربر با رفتار پیش‌فرض برنامه در تنظیمات نسبت ابعادی

انصراف

برای انصراف از رفتار سطح میانای برنامه‌سازی کاربردی ۳۶، ویژگی مانیفست PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY را اعلام کنید.

برای انصراف از فعالیتی خاص، ویژگی را در عنصر <activity> تنظیم کنید:

<activity ...>
    <property
        android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY"
        android:value="true" />
    ...
</activity>

برای انصراف دادن برای کل برنامه، ویژگی را در عنصر <application> تنظیم کنید:

<application ...>
    <property
        android:name="android.window.PROPERTY_COMPAT_ALLOW_RESTRICTED_RESIZABILITY"
        android:value="true" />
    ...
</application>

اگر برنامه شما Android 16 (سطح میانای برنامه‌سازی کاربردی ۳۶) یا بالاتر را هدف قرار دهد، این ویژگی جهت نمایش را قفل نمی‌کند یا از چرخش صفحه‌نمایش جلوگیری نمی‌کند در نمایشگرهای بزرگ.

آزمایش‌ها

برای آزمایش اینکه آیا برنامه‌تان تحت‌تأثیر تغییرات Android 16 قرار می‌گیرد یا نه، از شبیه‌سازهای سری Pixel Tablet و Pixel Fold در Android Studio استفاده کنید و targetSdkPreview = "Baklava" را در فایل واحد build.gradle برنامه‌تان تنظیم کنید.

یا با فعال کردن پرچم UNIVERSAL_RESIZABLE_BY_DEFAULT (به ابزارهای چارچوب سازگاری مراجعه کنید)، از چارچوب سازگاری برنامه در دستگاه‌های آزمایشی‌تان استفاده کنید.

می‌توانید آزمایش را با چارچوب آزمایشی Espresso و میاناهای برنامه‌سازی کاربردی آزمایشی Jetpack Compose خودکار کنید.

راهنمای پیاده‌سازی

برنامه‌هایی که جهت دستگاه، نسبت ابعادی، یا قابلیت تغییر اندازه برنامه را محدود می‌کنند ممکن است در Android 16 مشکلات نمایشی داشته باشند، مثلاً چیدمان‌های هم‌پوشان. برای ارائه تجربه کاربری بهینه در تلفن‌ها، دستگاه‌های تاشو، رایانه‌های لوحی، دستگاه‌های ChromeOS، و غیره، برنامه‌تان را به‌گونه‌ای بسازید که واکنش‌گرا و سازگار باشد.

بازبینه آمادگی

از بازبینه زیر استفاده کنید تا مطمئن شوید برنامه‌تان برای تغییرات Android 16 آماده است:

  • از مؤلفه‌های میانای کاربر کشیده‌شده اجتناب کنید: چیدمان‌های طراحی‌شده برای صفحه‌نمایش‌های استاندارد و عمودی تلفن ممکن است نتوانند با نسبت‌های ابعادی دیگر سازگار شوند. برای مثال، عناصر میانای کاربر که کل عرض نمایشگر را پر می‌کنند ممکن است در جهت افقی کشیده به‌نظر برسند. حداکثر پهنا را به مؤلفه‌ها اضافه کنید تا از کشیدگی جلوگیری شود.
  • فعال کردن پیمایش چیدمان‌ها: اگر چیدمان‌ها پیمایش نشوند، ممکن است کاربران نتوانند به دکمه‌ها یا دیگر عناصر میانای کاربر که در جهت افقی خارج از صفحه هستند دسترسی پیدا کنند. چیدمان‌های برنامه را برای پیمایش فعال کنید تا مطمئن شوید همه محتوا صرف‌نظر از ارتفاع نمایشگر قابل‌دسترسی است.
  • سازگاری دوربین را در حالت عمودی و افقی تأیید کنید: پیش‌نمایش‌های نمایاب دوربین که نسبت ابعادی و جهت خاصی را نسبت به حسگر دوربین فرض می‌کنند، می‌توانند منجر به پیش‌نمایش‌های کشیده یا وارونه در نمایشگرهای ناسازگار شوند. بررسی کنید که نمایاب‌ها با تغییر جهت به‌درستی بچرخند. به نمایاب‌ها امکان می‌دهد تا با نسبت‌های ابعادی میانای کاربر که با نسبت ابعادی حسگر متفاوت است سازگار شوند.
  • حفظ وضعیت درطول تغییر اندازه پنجره: برداشتن محدودیت‌های جهت و نسبت ابعادی می‌تواند منجر به تغییرات مکرر اندازه پنجره برنامه در پاسخ به نحوه ترجیح کاربران برای استفاده از برنامه شود، برای مثال، با چرخاندن، تا کردن، یا باز کردن دستگاه یا با تغییر اندازه برنامه در حالت چندپنجره‌ای یا پنجره‌بندی رایانه‌ای. تغییرات پیکربندی مانند تغییر جهت و تغییر اندازه پنجره باعث بازآفرینی فعالیت می‌شود (به‌طور پیش‌فرض). برای کمک به ارائه تجربه کاربری بهینه، وضعیت برنامه را حفظ کنید تا برنامه‌تان داده‌ها (مانند ورودی فرم) را نگه دارد و کاربران بتوانند بافت را حفظ کنند.
  • استفاده از کلاس‌های اندازه پنجره: پشتیبانی از اندازه‌های مختلف پنجره و نسبت‌های ابعادی بدون سفارشی‌سازی‌های خاص دستگاه. فرض کنید اندازه پنجره‌ها مرتباً تغییر خواهد کرد. از کلاس‌های اندازه پنجره برای مشخص کردن ابعاد پنجره استفاده کنید و سپس چیدمان تطبیقی مناسب را اعمال کنید.
  • ساختن چیدمان‌های واکنش‌گرا: در کلاس‌های اندازه پنجره، چیدمان‌های واکنش‌گرا با تغییرات ابعاد نمایشگر سازگار می‌شوند تا همیشه ارائه بهینه برنامه را ایجاد کنند.

برای راهنمای عملی ساختن چیدمان‌های تطبیقی در Compose، codelab ساختن برنامه‌های تطبیقی با Jetpack Compose را ببینید. اگر درحال انتقال برنامه‌ای هستید که از نماها استفاده می‌کند، استراتژی پذیرش Compose را ببینید.

خط زمان

  • ‫Android 16‏ (۲۰۲۵): پشتیبانی از همه جهت‌ها و نسبت‌های ابعادی و قابلیت تغییر اندازه برنامه، تجربه پایه برای دستگاه‌های با صفحه‌نمایش بزرگ (کمترین عرض صفحه‌نمایش >= ۶۰۰ پیکسل مستقل از تراکم) برای برنامه‌هایی است که سطح میانای برنامه‌سازی کاربردی ۳۶ را هدف قرار می‌دهند. بااین‌حال، توسعه‌دهندگان می‌توانند انصراف دهند.
سطح میانای برنامه‌سازی کاربردی هدف‌ دستگاه‌های ذی‌ربط انصراف توسعه‌دهنده مجاز است
‫۳۶ (Android 16) دستگاه‌های دارای صفحه‌نمایش بزرگ (کمترین عرض صفحه‌نمایش >= ۶۰۰ پیکسل مستقل از تراکم) بله

مهلت‌های هدف‌یابی سطوح میانای برنامه‌سازی کاربردی خاص مختص فروشگاه برنامه‌ها است. ‫Google Play از اوت ۲۰۲۶ از برنامه‌ها می‌خواهد سطح میانای برنامه‌سازی کاربردی ۳۶ را هدف قرار دهند.

منابع بیشتر