تغییرات رفتار: برنامه هایی که اندروید 15 یا بالاتر را هدف قرار می دهند

مانند نسخه‌های قبلی، اندروید ۱۵ شامل تغییرات رفتاری است که ممکن است بر برنامه شما تأثیر بگذارد. تغییرات رفتاری زیر منحصراً برای برنامه‌هایی اعمال می‌شود که اندروید ۱۵ یا بالاتر را هدف قرار می‌دهند. اگر برنامه شما اندروید ۱۵ یا بالاتر را هدف قرار می‌دهد، باید برنامه خود را اصلاح کنید تا در صورت لزوم، از این رفتارها به درستی پشتیبانی کند.

حتماً فهرست تغییرات رفتاری که صرف نظر از targetSdkVersion برنامه شما، بر همه برنامه‌های در حال اجرا در اندروید ۱۵ تأثیر می‌گذارند را نیز بررسی کنید.

عملکرد اصلی

اندروید ۱۵ قابلیت‌های اصلی مختلف سیستم اندروید را تغییر داده یا گسترش می‌دهد.

تغییرات در سرویس‌های پیش‌زمینه

ما در حال انجام تغییرات زیر در سرویس های پیش زمینه با اندروید 15 هستیم.

رفتار درنگ سرویس پیش زمینه همگام سازی داده ها

Android 15 برای برنامه‌هایی که Android 15 (سطح API 35) یا بالاتر را هدف قرار می‌دهند، رفتار مهلت زمانی جدیدی را برای dataSync معرفی می‌کند. این رفتار همچنین برای نوع جدید سرویس پیش‌زمینه mediaProcessing اعمال می‌شود.

این سیستم به سرویس‌های dataSync یک برنامه اجازه می‌دهد در یک دوره 24 ساعته در مجموع 6 ساعت اجرا شوند، پس از آن سیستم سرویس سرویس در حال اجرا را متد Service.onTimeout(int, int) (معرفی شده در اندروید 15) فراخوانی می‌کند. در این زمان، سرویس چند ثانیه فرصت دارد تا Service.stopSelf() فراخوانی کند. هنگامی که Service.onTimeout() فراخوانی می شود، سرویس دیگر یک سرویس پیش زمینه در نظر گرفته نمی شود. اگر سرویس Service.stopSelf() را فراخوانی نکند، سیستم یک استثنا داخلی ایجاد می کند. استثنا با پیام زیر در Logcat وارد شده است:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"

برای جلوگیری از مشکلات ناشی از این تغییر رفتار، می توانید یک یا چند مورد از موارد زیر را انجام دهید:

  1. از سرویس خود بخواهید روش جدید Service.onTimeout(int, int) را پیاده سازی کند. وقتی برنامه شما پاسخ تماس را دریافت کرد، مطمئن شوید که در عرض چند ثانیه stopSelf() تماس بگیرید. (اگر برنامه را فورا متوقف نکنید، سیستم خراب می شود.)
  2. مطمئن شوید که سرویس‌های dataSync برنامه شما در هر دوره 24 ساعته در مجموع بیش از 6 ساعت اجرا نمی‌شوند (مگر اینکه کاربر با برنامه تعامل داشته باشد و تایمر را بازنشانی کند).
  3. خدمات پیش زمینه dataSync فقط در نتیجه تعامل مستقیم کاربر شروع کنید. از آنجایی که برنامه شما هنگام شروع سرویس در پیش زمینه است، سرویس شما شش ساعت کامل پس از رفتن برنامه به پس‌زمینه است.
  4. به جای استفاده از سرویس پیش زمینه dataSync ، از یک API جایگزین استفاده کنید.

اگر سرویس‌های پیش‌زمینه dataSync برنامه شما در 24 ساعت گذشته به مدت 6 ساعت اجرا شده است، نمی‌توانید سرویس پیش‌زمینه dataSync دیگری را راه‌اندازی کنید مگر اینکه کاربر برنامه شما را به پیش‌زمینه آورده باشد (که تایمر را بازنشانی می‌کند). اگر می‌خواهید سرویس پیش‌زمینه dataSync دیگری را راه‌اندازی کنید، سیستم ForegroundServiceStartNotAllowedException را با یک پیام خطایی مانند «محدودیت زمانی برای نوع سرویس پیش‌زمینه dataSync تمام شده است» پرتاب می‌کند.

تست کردن

برای آزمایش رفتار برنامه‌تان، می‌توانید وقفه‌های همگام‌سازی داده‌ها را فعال کنید، حتی اگر برنامه شما Android 15 را هدف قرار ندهد (تا زمانی که برنامه روی دستگاه Android 15 اجرا شود). برای فعال کردن بازه زمانی، دستور adb زیر را اجرا کنید:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

همچنین می‌توانید دوره وقفه را تنظیم کنید تا آزمایش نحوه عملکرد برنامه‌تان در زمان رسیدن به محدودیت آسان‌تر شود. برای تنظیم یک بازه زمانی جدید، دستور adb زیر را اجرا کنید:

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

نوع سرویس پیش زمینه پردازش رسانه جدید

Android 15 introduces a new foreground service type, mediaProcessing. This service type is appropriate for operations like transcoding media files. For example, a media app might download an audio file and need to convert it to a different format before playing it. You can use a mediaProcessing foreground service to make sure the conversion continues even while the app is in the background.

The system permits an app's mediaProcessing services to run for a total of 6 hours in a 24-hour period, after which the system calls the running service's Service.onTimeout(int, int) method (introduced in Android 15). At this time, the service has a few seconds to call Service.stopSelf(). If the service does not call Service.stopSelf(), the system throws an internal exception. The exception is logged in Logcat with the following message:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"

To avoid having the exception, you can do one of the following:

  1. Have your service implement the new Service.onTimeout(int, int) method. When your app receives the callback, make sure to call stopSelf() within a few seconds. (If you don't stop the app right away, the system generates a failure.)
  2. Make sure your app's mediaProcessing services don't run for more than a total of 6 hours in any 24-hour period (unless the user interacts with the app, resetting the timer).
  3. Only start mediaProcessing foreground services as a result of direct user interaction; since your app is in the foreground when the service starts, your service has the full six hours after the app goes to the background.
  4. Instead of using a mediaProcessing foreground service, use an alternative API, like WorkManager.

If your app's mediaProcessing foreground services have run for 6 hours in the last 24, you cannot start another mediaProcessing foreground service unless the user has brought your app to the foreground (which resets the timer). If you try to start another mediaProcessing foreground service, the system throws ForegroundServiceStartNotAllowedException with an error message like "Time limit already exhausted for foreground service type mediaProcessing".

For more information about the mediaProcessing service type, see Changes to foreground service types for Android 15: Media processing.

Testing

To test your app's behavior, you can enable media processing timeouts even if your app is not targeting Android 15 (as long as the app is running on an Android 15 device). To enable timeouts, run the following adb command:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

You can also adjust the timeout period, to make it easier to test how your app behaves when the limit is reached. To set a new timeout period, run the following adb command:

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds

محدودیت در گیرنده های پخش BOOT_COMPLETED که خدمات پیش زمینه را راه اندازی می کنند

محدودیت های جدیدی برای گیرنده های پخش BOOT_COMPLETED وجود دارد که خدمات پیش زمینه را راه اندازی می کنند. گیرنده های BOOT_COMPLETED مجاز به راه اندازی انواع خدمات پیش زمینه زیر نیستند :

اگر یک گیرنده BOOT_COMPLETED سعی کند هر یک از آن نوع خدمات پیش زمینه را راه اندازی کند، سیستم ForegroundServiceStartNotAllowedException پرتاب می کند.

تست کردن

برای آزمایش رفتار برنامه‌تان، می‌توانید این محدودیت‌های جدید را فعال کنید، حتی اگر برنامه شما اندروید 15 را هدف قرار ندهد (تا زمانی که برنامه روی دستگاه Android 15 اجرا شود). دستور adb زیر را اجرا کنید:

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

برای ارسال یک پخش BOOT_COMPLETED بدون راه اندازی مجدد دستگاه، دستور adb زیر را اجرا کنید:

adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name

محدودیت‌هایی برای شروع سرویس‌های پیش‌زمینه در زمانی که برنامه دارای مجوز SYSTEM_ALERT_WINDOW است

Previously, if an app held the SYSTEM_ALERT_WINDOW permission, it could launch a foreground service even if the app was currently in the background (as discussed in exemptions from background start restrictions).

If an app targets Android 15, this exemption is now narrower. The app now needs to have the SYSTEM_ALERT_WINDOW permission and also have a visible overlay window. That is, the app needs to first launch a TYPE_APPLICATION_OVERLAY window and the window needs to be visible before you start a foreground service.

If your app attempts to start a foreground service from the background without meeting these new requirements (and it does not have some other exemption), the system throws ForegroundServiceStartNotAllowedException.

If your app declares the SYSTEM_ALERT_WINDOW permission and launches foreground services from the background, it may be affected by this change. If your app gets a ForegroundServiceStartNotAllowedException, check your app's order of operations and make sure your app already has an active overlay window before it attempts to start a foreground service from the background. You can check if your overlay window is currently visible by calling View.getWindowVisibility(), or you can override View.onWindowVisibilityChanged() to get notified whenever the visibility changes.

Testing

To test your app's behavior, you can enable these new restrictions even if your app is not targeting Android 15 (as long as the app is running on an Android 15 device). To enable these new restrictions on starting foreground services from the background, run the following adb command:

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

تغییراتی در زمان‌هایی که برنامه‌ها می‌توانند وضعیت کلی حالت «مزاحم نشوید» را تغییر دهند

برنامه‌هایی که Android 15 (سطح API 35) و بالاتر را هدف قرار می‌دهند، دیگر نمی‌توانند وضعیت کلی یا خط‌مشی «مزاحم نشوید» (DND) را در دستگاه تغییر دهند (چه با تغییر تنظیمات کاربر یا خاموش کردن حالت DND). در عوض، برنامه‌ها باید یک AutomaticZenRule ارائه دهند، که سیستم آن را در یک خط‌مشی جهانی با طرح موجود بیشترین محدودیت‌کننده-سیاست-برنده ترکیب می‌کند. تماس‌های APIهای موجود که قبلاً بر وضعیت جهانی تأثیر می‌گذاشتند ( setInterruptionFilter ، setNotificationPolicy ) منجر به ایجاد یا به‌روزرسانی یک AutomaticZenRule ضمنی می‌شود که بسته به چرخه تماس آن فراخوان‌های API، روشن و خاموش می‌شود.

توجه داشته باشید که این تغییر تنها در صورتی بر رفتار قابل مشاهده تأثیر می‌گذارد که برنامه setInterruptionFilter(INTERRUPTION_FILTER_ALL) را فراخوانی کند و انتظار دارد که این تماس AutomaticZenRule را که قبلاً توسط صاحبان آن فعال شده است غیرفعال کند.

تغییرات API در OpenJDK

Android 15 continues the work of refreshing Android's core libraries to align with the features in the latest OpenJDK LTS releases.

Some of these changes can affect app compatibility for apps targeting Android 15 (API level 35):

  • Changes to string formatting APIs: Validation of argument index, flags, width, and precision are now more strict when using the following String.format() and Formatter.format() APIs:

    For example, the following exception is thrown when an argument index of 0 is used (%0 in the format string):

    IllegalFormatArgumentIndexException: Illegal format argument index = 0

    In this case, the issue can be fixed by using an argument index of 1 (%1 in the format string).

  • Changes to component type of Arrays.asList(...).toArray(): When using Arrays.asList(...).toArray(), the component type of the resulting array is now an Object—not the type of the underlying array's elements. So the following code throws a ClassCastException:

    String[] elements = (String[]) Arrays.asList("one", "two").toArray();

    For this case, to preserve String as the component type in the resulting array, you could use Collection.toArray(Object[]) instead:

    String[] elements = Arrays.asList("two", "one").toArray(new String[0]);

  • Changes to language code handling: When using the Locale API, language codes for Hebrew, Yiddish, and Indonesian are no longer converted to their obsolete forms (Hebrew: iw, Yiddish: ji, and Indonesian: in). When specifying the language code for one of these locales, use the codes from ISO 639-1 instead (Hebrew: he, Yiddish: yi, and Indonesian: id).

  • Changes to random int sequences: Following the changes made in https://bugs.openjdk.org/browse/JDK-8301574, the following Random.ints() methods now return a different sequence of numbers than the Random.nextInt() methods do:

    Generally, this change shouldn't result in app-breaking behavior, but your code shouldn't expect the sequence generated from Random.ints() methods to match Random.nextInt().

The new SequencedCollection API can affect your app's compatibility after you update compileSdk in your app's build configuration to use Android 15 (API level 35):

  • Collision with MutableList.removeFirst() and MutableList.removeLast() extension functions in kotlin-stdlib

    The List type in Java is mapped to the MutableList type in Kotlin. Because the List.removeFirst() and List.removeLast() APIs have been introduced in Android 15 (API level 35), the Kotlin compiler resolves function calls, for example list.removeFirst(), statically to the new List APIs instead of to the extension functions in kotlin-stdlib.

    If an app is re-compiled with compileSdk set to 35 and minSdk set to 34 or lower, and then the app is run on Android 14 and lower, a runtime error is thrown:

    java.lang.NoSuchMethodError: No virtual method
removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;

    The existing NewApi lint option in Android Gradle Plugin can catch these new API usages.

    ./gradlew lint

MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi]
      list.removeFirst()

    To fix the runtime exception and lint errors, the removeFirst() and removeLast() function calls can be replaced with removeAt(0) and removeAt(list.lastIndex) respectively in Kotlin. If you're using Android Studio Ladybug | 2024.1.3 or higher, it also provides a quick fix option for these errors.

    Consider removing @SuppressLint("NewApi") and lintOptions { disable 'NewApi' } if the lint option has been disabled.

  • Collision with other methods in Java

    New methods have been added into the existing types, for example, List and Deque. These new methods might not be compatible with the methods with the same name and argument types in other interfaces and classes. In the case of a method signature collision with incompatibility, the javac compiler outputs a build-time error. For example:

    Example error 1:

    javac MyList.java

MyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List
  public void removeLast() {
              ^
  return type void is not compatible with Object
  where E is a type-variable:
    E extends Object declared in interface List

    Example error 2:

    javac MyList.java

MyList.java:7: error: types Deque<Object> and List<Object> are incompatible;
public class MyList implements  List<Object>, Deque<Object> {
  both define reversed(), but with unrelated return types
1 error

    Example error 3:

    javac MyList.java

MyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible;
public static class MyList implements List<Object>, MyInterface<Object> {
  class MyList inherits unrelated defaults for getFirst() from types List and MyInterface
  where E#1,E#2 are type-variables:
    E#1 extends Object declared in interface List
    E#2 extends Object declared in interface MyInterface
1 error

    To fix these build errors, the class implementing these interfaces should override the method with a compatible return type. For example:

    @Override
public Object getFirst() {
    return List.super.getFirst();
}

امنیت

اندروید ۱۵ شامل تغییراتی است که امنیت سیستم را ارتقا می‌دهد تا به محافظت از برنامه‌ها و کاربران در برابر برنامه‌های مخرب کمک کند.

نسخه‌های محدود TLS

اندروید 15 استفاده از TLS نسخه 1.0 و 1.1 را محدود می کند. این نسخه‌ها قبلاً در اندروید منسوخ شده بودند، اما اکنون برای برنامه‌هایی که اندروید 15 را هدف قرار می‌دهند غیرمجاز هستند.

فعالیت پس‌زمینه امن راه‌اندازی می‌شود

اندروید ۱۵ با افزودن تغییراتی که مانع از اجرای برنامه‌های مخرب در پس‌زمینه توسط برنامه‌های دیگر، افزایش سطح دسترسی و سوءاستفاده از تعامل کاربر می‌شود، از کاربران در برابر برنامه‌های مخرب محافظت می‌کند و به آنها کنترل بیشتری بر دستگاه‌هایشان می‌دهد. از اندروید ۱۰ (سطح API ۲۹) فعالیت‌های پس‌زمینه محدود شده‌اند.

تغییرات دیگر

  • سازندگان PendingIntent طوری تغییر دهید که به طور پیش‌فرض، فعالیت‌های پس‌زمینه را مسدود کنند . این کار به جلوگیری از ایجاد تصادفی PendingIntent توسط برنامه‌ها که می‌تواند توسط افراد مخرب مورد سوءاستفاده قرار گیرد، کمک می‌کند.
  • هیچ برنامه‌ای را به پیش‌زمینه نیاورید، مگر اینکه فرستنده‌ی PendingIntent اجازه دهد . هدف این تغییر جلوگیری از سوءاستفاده‌ی برنامه‌های مخرب از قابلیت شروع فعالیت‌ها در پس‌زمینه است. به‌طور پیش‌فرض، برنامه‌ها مجاز به آوردن پشته‌ی وظایف به پیش‌زمینه نیستند، مگر اینکه سازنده‌ی برنامه اجازه‌ی اجرای فعالیت در پس‌زمینه را داده باشد یا فرستنده امتیاز اجرای فعالیت در پس‌زمینه را داشته باشد.
  • کنترل کنید که فعالیت برتر یک پشته وظیفه چگونه می‌تواند وظیفه خود را به پایان برساند . اگر فعالیت برتر یک وظیفه را به پایان برساند، اندروید به آخرین وظیفه فعال خود برمی‌گردد. علاوه بر این، اگر یک فعالیت غیر برتر وظیفه خود را به پایان برساند، اندروید به صفحه اصلی برمی‌گردد؛ و پایان این فعالیت غیر برتر را مسدود نمی‌کند.
  • جلوگیری از اجرای فعالیت‌های دلخواه از برنامه‌های دیگر به وظیفه خودتان . این تغییر مانع از آن می‌شود که برنامه‌های مخرب با ایجاد فعالیت‌هایی که به نظر می‌رسد از برنامه‌های دیگر هستند، کاربران را فیشینگ کنند.
  • جلوگیری از در نظر گرفتن پنجره‌های غیرقابل مشاهده برای اجرای فعالیت‌های پس‌زمینه . این کار به جلوگیری از سوءاستفاده برنامه‌های مخرب از اجرای فعالیت‌های پس‌زمینه برای نمایش محتوای ناخواسته یا مخرب به کاربران کمک می‌کند.

مقاصد امن‌تر

Android 15 introduces StrictMode for intents.

In order to see detailed logs about Intent usage violations, use following method:

Kotlin

fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        .detectUnsafeIntentLaunch()
        .build()
    )
}

Java

public void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
            .detectUnsafeIntentLaunch()
            .build());
}

تجربه کاربری و رابط کاربری سیستم

اندروید ۱۵ شامل تغییراتی است که برای ایجاد یک تجربه کاربری سازگارتر و شهودی‌تر در نظر گرفته شده‌اند.

تغییرات درج پنجره

در اندروید 15 دو تغییر مربوط به ورودی‌های پنجره وجود دارد: لبه به لبه به‌طور پیش‌فرض اعمال می‌شود و همچنین تغییراتی در پیکربندی وجود دارد، مانند پیکربندی پیش‌فرض نوارهای سیستم.

Edge-to-edge enforcement

اگر برنامه‌ها برای اندروید ۱۵ (سطح API 35) طراحی شده باشند، به‌طور پیش‌فرض در دستگاه‌هایی که اندروید ۱۵ را اجرا می‌کنند، لبه به لبه هستند.

برنامه‌ای که اندروید ۱۴ را هدف قرار داده و روی دستگاه اندروید ۱۵ به صورت کامل اجرا نمی‌شود.


برنامه‌ای که اندروید ۱۵ (سطح API 35) را هدف قرار می‌دهد و به صورت لبه به لبه روی دستگاه اندروید ۱۵ اجرا می‌شود. این برنامه عمدتاً از کامپوننت‌های Compose متریال ۳ استفاده می‌کند که به طور خودکار درج‌ها را اعمال می‌کنند. این صفحه تحت تأثیر منفی اجرای لبه به لبه اندروید ۱۵ قرار نمی‌گیرد.

این یک تغییر اساسی است که ممکن است تأثیر منفی بر رابط کاربری برنامه شما بگذارد. این تغییرات بر روی بخش‌های زیر از رابط کاربری تأثیر می‌گذارند:

  • نوار ناوبری با استفاده از ژست‌های حرکتی
    • به طور پیش‌فرض شفاف.
    • افست پایین غیرفعال است، بنابراین محتوا پشت نوار ناوبری سیستم ترسیم می‌شود، مگر اینکه از insets استفاده شود.
    • setNavigationBarColor و R.attr#navigationBarColor منسوخ شده‌اند و بر ناوبری ژست‌ها تأثیری ندارند.
    • setNavigationBarContrastEnforced و R.attr#navigationBarContrastEnforced همچنان هیچ تاثیری بر ناوبری ژست‌ها ندارند.
  • ناوبری ۳ دکمه‌ای
    • میزان شفافیت (Opacity) به طور پیش‌فرض روی ۸۰٪ تنظیم شده است، و احتمالاً رنگ آن با پس‌زمینه پنجره مطابقت دارد.
    • افست پایین غیرفعال است، بنابراین محتوا پشت نوار ناوبری سیستم ترسیم می‌شود، مگر اینکه از insets استفاده شود.
    • setNavigationBarColor و R.attr#navigationBarColor به طور پیش‌فرض طوری تنظیم شده‌اند که با پس‌زمینه پنجره مطابقت داشته باشند. برای اینکه این پیش‌فرض اعمال شود، پس‌زمینه پنجره باید رنگی قابل ترسیم داشته باشد. این API منسوخ شده است اما همچنان بر ناوبری سه دکمه‌ای تأثیر می‌گذارد.
    • setNavigationBarContrastEnforced و R.attr#navigationBarContrastEnforced به طور پیش‌فرض روی true تنظیم شده‌اند که یک پس‌زمینه مات ۸۰٪ به ناوبری ۳ دکمه‌ای اضافه می‌کند.
  • نوار وضعیت
    • به طور پیش‌فرض شفاف.
    • فاصله‌ی بالایی غیرفعال است، بنابراین محتوا پشت نوار وضعیت رسم می‌شود، مگر اینکه از insets استفاده شود.
    • setStatusBarColor و R.attr#statusBarColor منسوخ شده‌اند و هیچ تاثیری روی اندروید ۱۵ ندارند.
    • setStatusBarContrastEnforced و R.attr#statusBarContrastEnforced منسوخ شده‌اند اما هنوز هم روی اندروید ۱۵ تأثیر دارند.
  • برش نمایشگر
    • layoutInDisplayCutoutMode پنجره‌های غیر شناور باید LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS باشد. SHORT_EDGES ، NEVER و DEFAULT به عنوان ALWAYS تفسیر می‌شوند تا کاربران نوار سیاه ناشی از بریدگی صفحه نمایش را نبینند و صفحه نمایش لبه به لبه به نظر برسد.

مثال زیر یک برنامه را قبل و بعد از هدف قرار دادن اندروید ۱۵ (سطح API ۳۵) و قبل و بعد از اعمال insets نشان می‌دهد. این مثال جامع نیست، ممکن است در Android Auto متفاوت به نظر برسد.

برنامه‌ای که اندروید ۱۴ را هدف قرار داده و روی دستگاه اندروید ۱۵ به صورت کامل اجرا نمی‌شود.
برنامه‌ای که اندروید ۱۵ (سطح API 35) را هدف قرار داده و به صورت لبه به لبه روی دستگاه اندروید ۱۵ اجرا می‌شود. با این حال، بسیاری از عناصر به دلیل محدودیت‌های لبه به لبه اندروید ۱۵، اکنون توسط نوار وضعیت، نوار ناوبری ۳ دکمه‌ای یا بریدگی صفحه نمایش پنهان شده‌اند. رابط کاربری پنهان شامل نوار برنامه بالای Material 2، دکمه‌های عملیاتی شناور و موارد لیست است.
برنامه‌ای که اندروید ۱۵ (سطح API 35) را هدف قرار می‌دهد، روی دستگاه اندروید ۱۵ لبه به لبه است و از insets استفاده می‌کند تا رابط کاربری پنهان نشود.
اگر برنامه شما از قبل edge-to-edge است، چه مواردی را باید بررسی کنید؟

اگر برنامه شما از قبل لبه به لبه است و از insets استفاده می‌کند، به جز در سناریوهای زیر، اکثراً تحت تأثیر قرار نگرفته‌اید. با این حال، حتی اگر فکر می‌کنید تحت تأثیر قرار نگرفته‌اید، توصیه می‌کنیم برنامه خود را آزمایش کنید.

  • شما یک پنجره غیرشناور دارید، مانند یک Activity که از SHORT_EDGES ، NEVER یا DEFAULT به جای LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS استفاده می‌کند. اگر برنامه شما هنگام اجرا از کار می‌افتد، ممکن است به دلیل صفحه شروع (splashscreen) شما باشد. می‌توانید وابستگی اصلی صفحه شروع را به 1.2.0-alpha01 یا بالاتر ارتقا دهید یا window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always قرار دهید.
  • ممکن است صفحات کم‌بازدیدتری با رابط کاربری مسدود شده وجود داشته باشند. بررسی کنید که این صفحات کم‌بازدید رابط کاربری مسدود شده نداشته باشند. صفحات کم‌بازدید شامل موارد زیر هستند:
    • صفحات ورود یا ورود به سیستم
    • صفحات تنظیمات
اگر برنامه شما از قبل edge-to-edge نیست، چه مواردی را باید بررسی کنید؟

اگر برنامه شما از قبل edge-to-edge نیست، به احتمال زیاد تحت تأثیر قرار گرفته‌اید. علاوه بر سناریوهایی برای برنامه‌هایی که از قبل edge-to-edge هستند، باید موارد زیر را در نظر بگیرید:

  • اگر برنامه شما از کامپوننت‌های Material 3 ( androidx.compose.material3 ) در compose استفاده می‌کند، مانند TopAppBar ، BottomAppBar و NavigationBar ، این کامپوننت‌ها احتمالاً تحت تأثیر قرار نمی‌گیرند زیرا به طور خودکار insetها را مدیریت می‌کنند.
  • اگر برنامه شما از کامپوننت‌های Material 2 ( androidx.compose.material ) در Compose استفاده می‌کند، این کامپوننت‌ها به طور خودکار insetها را مدیریت نمی‌کنند. با این حال، می‌توانید به insetها دسترسی داشته باشید و آنها را به صورت دستی اعمال کنید. در androidx.compose.material 1.6.0 و بالاتر، از پارامتر windowInsets برای اعمال insetها به صورت دستی برای BottomAppBar ، TopAppBar ، BottomNavigation و NavigationRail استفاده کنید. به همین ترتیب، از پارامتر contentWindowInsets برای Scaffold استفاده کنید.
  • اگر برنامه شما از نماها و کامپوننت‌های متریال ( com.google.android.material ) استفاده می‌کند، اکثر کامپوننت‌های متریال مبتنی بر نماها مانند BottomNavigationView ، BottomAppBar ، NavigationRailView یا NavigationView ، درج‌ها را مدیریت می‌کنند و نیازی به کار اضافی ندارند. با این حال، اگر از AppBarLayout استفاده می‌کنید، باید android:fitsSystemWindows="true" را اضافه کنید.
  • برای کامپوننت‌های سفارشی، insetها را به صورت دستی به عنوان padding اعمال کنید. اگر محتوای شما درون یک Scaffold است، می‌توانید insetها را با استفاده از مقادیر padding Scaffold استفاده کنید. در غیر این صورت، padding را با استفاده از یکی از WindowInsets اعمال کنید.
  • اگر برنامه شما از viewها و BottomSheet ، SideSheet یا containerهای سفارشی استفاده می‌کند، با استفاده از ViewCompat.setOnApplyWindowInsetsListener ، فاصله‌گذاری (padding) را اعمال کنید. برای RecyclerView ، با استفاده از این listener، فاصله‌گذاری را اعمال کنید و همچنین clipToPadding="false" را اضافه کنید.
اگر برنامه شما نیاز به ارائه محافظت از پس‌زمینه سفارشی دارد، چه مواردی را بررسی کنید؟

اگر برنامه شما باید محافظت از پس‌زمینه سفارشی را برای ناوبری سه دکمه‌ای یا نوار وضعیت ارائه دهد، برنامه شما باید با استفاده از WindowInsets.Type#tappableElement() یک عنصر ترکیبی یا یک view را در پشت نوار سیستم قرار دهد تا ارتفاع نوار ناوبری سه دکمه‌ای یا WindowInsets.Type#statusBars دریافت کند.

منابع اضافی و به‌روز

برای ملاحظات بیشتر در مورد اعمال درج، به راهنماهای « نمای لبه به لبه» و «نوشتن لبه به لبه» مراجعه کنید.

API های منسوخ شده

API های زیر منسوخ شده اند اما غیرفعال نشده اند:

API های زیر منسوخ و غیرفعال شده اند:

Stable configuration

If your app targets Android 15 (API level 35) or higher, Configuration no longer excludes the system bars. If you use the screen size in the Configuration class for layout calculation, you should replace it with better alternatives like an appropriate ViewGroup, WindowInsets, or WindowMetricsCalculator depending on your need.

Configuration has been available since API 1. It is typically obtained from Activity.onConfigurationChanged. It provides information like window density, orientation, and sizes. One important characteristic about the window sizes returned from Configuration is that it previously excluded the system bars.

The configuration size is typically used for resource selection, such as /res/layout-h500dp, and this is still a valid use case. However, using it for layout calculation has always been discouraged. If you do so, you should move away from it now. You should replace the use of Configuration with something more suitable depending on your use case.

If you use it to calculate the layout, use an appropriate ViewGroup, such as CoordinatorLayout or ConstraintLayout. If you use it to determine the height of the system navbar, use WindowInsets. If you want to know the current size of your app window, use computeCurrentWindowMetrics.

The following list describes the fields affected by this change:

مقدار پیش‌فرض ویژگی elegantTextHeight برابر با true است.

برای برنامه‌هایی که Android 15 (سطح API 35) را هدف قرار می‌دهند، ویژگی elegantTextHeight TextView به‌طور پیش‌فرض true می‌شود و فونت فشرده‌ای را که به‌طور پیش‌فرض استفاده می‌شود با برخی از اسکریپت‌هایی که معیارهای عمودی بزرگی دارند با فونتی که بسیار خواناتر است جایگزین می‌کند. فونت فشرده برای جلوگیری از شکستن طرح‌بندی‌ها معرفی شد. Android 13 (سطح API 33) از بسیاری از این شکستگی‌ها جلوگیری می‌کند و به طرح متن اجازه می‌دهد تا ارتفاع عمودی را با استفاده از ویژگی fallbackLineSpacing کشیده شود.

در اندروید 15، فونت فشرده همچنان در سیستم باقی می‌ماند، بنابراین برنامه شما می‌تواند elegantTextHeight را روی false تنظیم کند تا رفتار قبلی را داشته باشد، اما بعید است که در نسخه‌های آینده پشتیبانی شود. بنابراین، اگر برنامه شما از اسکریپت های زیر پشتیبانی می کند: عربی، لائوس، میانمار، تامیل، گجراتی، کانادا، مالایالام، اودیا، تلوگو یا تایلندی، برنامه خود را با تنظیم elegantTextHeight روی true تست کنید.

رفتار elegantTextHeight برای برنامه‌هایی که Android 14 (سطح API 34) و پایین‌تر را هدف قرار می‌دهند.
رفتار elegantTextHeight برای برنامه هایی که اندروید 15 را هدف قرار می دهند.

تغییر عرض TextView برای شکل‌های پیچیده حروف

در نسخه‌های قبلی اندروید، برخی از فونت‌های شکسته یا زبان‌هایی که شکل پیچیده‌ای دارند، ممکن است حروف را در ناحیه شخصیت قبلی یا بعدی بکشند. در برخی موارد، چنین حروفی در موقعیت آغاز یا پایان بریده می شدند. با شروع اندروید 15، یک TextView عرض را برای ترسیم فضای کافی برای چنین حروفی اختصاص می‌دهد و به برنامه‌ها اجازه می‌دهد تا برای جلوگیری از برش، بالشتک‌های اضافی را در سمت چپ درخواست کنند.

از آنجایی که این تغییر بر نحوه تعیین عرض یک TextView تأثیر می‌گذارد، اگر برنامه Android 15 (سطح API 35) یا بالاتر را هدف قرار دهد، TextView به طور پیش‌فرض عرض بیشتری را اختصاص می‌دهد. می توانید این رفتار را با فراخوانی API setUseBoundsForWidth در TextView فعال یا غیرفعال کنید.

از آنجایی که افزودن پد سمت چپ ممکن است باعث ایجاد ناهماهنگی در طرح‌بندی‌های موجود شود، این پد به‌طور پیش‌فرض حتی برای برنامه‌هایی که Android 15 یا بالاتر را هدف قرار می‌دهند، اضافه نمی‌شود. با این حال، می‌توانید با فراخوانی setShiftDrawingOffsetForStartOverhang ، بالشتک اضافی برای جلوگیری از بریدن اضافه کنید.

مثال‌های زیر نشان می‌دهند که چگونه این تغییرات می‌توانند طرح‌بندی متن را برای برخی از فونت‌ها و زبان‌ها بهبود بخشند.

طرح بندی استاندارد برای متن انگلیسی با فونت شکسته. برخی از حروف بریده شده است. اینجا XML مربوطه است: 

<TextView
    android:fontFamily="cursive"
    android:text="java" />
طرح بندی برای همان متن انگلیسی با عرض و بالشتک اضافی. اینجا XML مربوطه است: 

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />
طرح بندی استاندارد برای متن تایلندی. برخی از حروف بریده شده است. اینجا XML مربوطه است: 

<TextView
    android:text="คอมพิวเตอร์" />
طرح بندی برای همان متن تایلندی با عرض و بالشتک اضافی. اینجا XML مربوطه است: 

<TextView
    android:text="คอมพิวเตอร์"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

ارتفاع خط پیش‌فرضِ آگاه از زبان برای EditText

در نسخه‌های قبلی اندروید، طرح‌بندی متن، ارتفاع متن را به اندازه ارتفاع خط فونتی که با منطقه فعلی مطابقت دارد، افزایش می‌داد. به عنوان مثال، اگر محتوا به زبان ژاپنی بود، چون ارتفاع خط فونت ژاپنی کمی بزرگتر از فونت لاتین است، ارتفاع متن کمی بزرگتر می شد. با این حال، علی‌رغم این تفاوت‌ها در ارتفاع خط، عنصر EditText بدون توجه به منطقه مورد استفاده، همانطور که در تصویر زیر نشان داده شده است، اندازه یکسانی داشت:

سه کادر نشان دهنده عناصر EditText که می تواند حاوی متنی از انگلیسی (en)، ژاپنی (ja) و برمه ای (my) باشد. ارتفاع EditText یکسان است، حتی اگر این زبان ها دارای ارتفاع خطوط متفاوت از یکدیگر باشند.

برای برنامه‌هایی که Android 15 (سطح API 35) را هدف قرار می‌دهند، اکنون یک حداقل ارتفاع خط برای EditText محفوظ است تا با فونت مرجع برای Locale مشخص‌شده مطابقت داشته باشد، همانطور که در تصویر زیر نشان داده شده است:

سه کادر نشان دهنده عناصر EditText که می تواند حاوی متنی از انگلیسی (en)، ژاپنی (ja) و برمه ای (my) باشد. ارتفاع EditText اکنون شامل فضایی برای قرار دادن ارتفاع خط پیش‌فرض برای فونت‌های این زبان‌ها می‌شود.

در صورت نیاز، برنامه شما می‌تواند رفتار قبلی را با تعیین ویژگی useLocalePreferredLineHeightForMinimum به false بازیابی کند، و برنامه شما می‌تواند حداقل معیارهای عمودی سفارشی را با استفاده از setMinimumFontMetrics API در Kotlin و Java تنظیم کند.

دوربین و رسانه

اندروید ۱۵ تغییرات زیر را در رفتار دوربین و رسانه برای برنامه‌هایی که اندروید ۱۵ یا بالاتر را هدف قرار می‌دهند، ایجاد می‌کند.

محدودیت‌های درخواست فوکوس صوتی

Apps that target Android 15 (API level 35) must be the top app or running a foreground service in order to request audio focus. If an app attempts to request focus when it does not meet one of these requirements, the call returns AUDIOFOCUS_REQUEST_FAILED.

You can learn more about audio focus at Manage audio focus.

محدودیت‌های غیر SDK به‌روزرسانی شدند

Android 15 includes updated lists of restricted non-SDK interfaces based on collaboration with Android developers and the latest internal testing. Whenever possible, we make sure that public alternatives are available before we restrict non-SDK interfaces.

If your app does not target Android 15, some of these changes might not immediately affect you. However, while it's possible for your app to access some non-SDK interfaces depending on your app's target API level, using any non-SDK method or field always carries a high risk of breaking your app.

If you are unsure if your app uses non-SDK interfaces, you can test your app to find out. If your app relies on non-SDK interfaces, you should begin planning a migration to SDK alternatives. Nevertheless, we understand that some apps have valid use cases for using non-SDK interfaces. If you can't find an alternative to using a non-SDK interface for a feature in your app, you should request a new public API.

برای اطلاعات بیشتر در مورد تغییرات این نسخه از اندروید، به‌روزرسانی‌های محدودیت‌های رابط غیر SDK در Android 15 را ببینید. برای کسب اطلاعات بیشتر در مورد رابط های غیر SDK به طور کلی، به محدودیت ها در رابط های غیر SDK مراجعه کنید.