पिछली रिलीज़ की तरह, Android 15 में भी कुछ बदलाव किए गए हैं. इनसे आपके ऐप्लिकेशन पर असर पड़ सकता है. यहां दिए गए बदलाव, सिर्फ़ उन ऐप्लिकेशन पर लागू होते हैं जो Android 15 या इसके बाद के वर्शन को टारगेट कर रहे हैं. अगर आपका ऐप्लिकेशन, Android 15 या इसके बाद के वर्शन को टारगेट कर रहा है, तो आपको अपने ऐप्लिकेशन में बदलाव करना चाहिए, ताकि इन व्यवहारों को सही तरीके से सपोर्ट किया जा सके. हालांकि, ऐसा सिर्फ़ उन मामलों में करना होगा जहां यह लागू होता है.
Android 15 पर चलने वाले सभी ऐप्लिकेशन पर असर डालने वाले बदलावों की सूची भी ज़रूर देखें. इससे कोई फ़र्क़ नहीं पड़ता कि आपके ऐप्लिकेशन का targetSdkVersion
क्या है.
मुख्य फ़ंक्शन
Android 15, Android सिस्टम की कई मुख्य सुविधाओं में बदलाव करता है या उन्हें बेहतर बनाता है.
फ़ोरग्राउंड सेवाओं में बदलाव
我们将对 Android 15 中的前台服务进行以下更改。
数据同步前台服务超时行为
Android 15 में, dataSync
के लिए टाइम आउट का नया तरीका जोड़ा गया है. यह तरीका, Android 15 (एपीआई लेवल 35) या उसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन के लिए है. यह व्यवहार, mediaProcessing
फ़ोरग्राउंड सेवा के नए टाइप पर भी लागू होता है.
सिस्टम, किसी ऐप्लिकेशन की dataSync
सेवाओं को 24 घंटे में कुल छह घंटे तक चलने की अनुमति देता है. इसके बाद, सिस्टम चल रही सेवा के Service.onTimeout(int, int)
तरीके को कॉल करता है. इसे Android 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]"
इस बदलाव की वजह से होने वाली समस्याओं से बचने के लिए, इनमें से एक या एक से ज़्यादा काम किए जा सकते हैं:
- अपनी सेवा में
Service.onTimeout(int, int)
का नया तरीका लागू करें. जब आपके ऐप्लिकेशन को कॉलबैक मिल जाए, तोstopSelf()
को कुछ सेकंड के अंदर कॉल करना न भूलें. (अगर ऐप्लिकेशन को तुरंत नहीं रोका जाता, तो सिस्टम गड़बड़ी जनरेट करता है.) - पक्का करें कि आपके ऐप्लिकेशन की
dataSync
सेवाएं किसी भी 24 घंटे में कुल छह घंटे से ज़्यादा न चलें (जब तक कि उपयोगकर्ता टाइमर को रीसेट करके ऐप्लिकेशन से इंटरैक्ट न करे). dataSync
फ़ोरग्राउंड सेवाओं को सिर्फ़ उपयोगकर्ता के सीधे इंटरैक्शन के ज़रिए शुरू करें. सेवा शुरू होने पर, आपका ऐप्लिकेशन फ़ोरग्राउंड में होता है. इसलिए, ऐप्लिकेशन के बैकग्राउंड में जाने के बाद भी, आपकी सेवा के पास पूरे छह घंटे होते हैं.dataSync
फ़ोरग्राउंड सेवा का इस्तेमाल करने के बजाय, किसी अन्य एपीआई का इस्तेमाल करें.
अगर आपके ऐप्लिकेशन की dataSync
फ़ोरग्राउंड सेवाएं पिछले 24 में छह घंटे तक चली हैं, तो आपके पास dataSync
की दूसरी फ़ोरग्राउंड सेवा शुरू करने का विकल्प नहीं है. जब तक उपयोगकर्ता आपके ऐप्लिकेशन को फ़ोरग्राउंड में न ले जाए (इससे टाइमर रीसेट हो जाता है). किसी दूसरी dataSync
फ़ोरग्राउंड सेवा को शुरू करने की कोशिश करने पर, सिस्टम ForegroundServiceStartNotAllowedException
का गड़बड़ी का मैसेज दिखाता है. जैसे, "फ़ोरग्राउंड सेवा के लिए समयसीमा खत्म हो चुकी है" डेटा सिंक करें.
टेस्ट करना
अपने ऐप्लिकेशन के व्यवहार की जांच करने के लिए, डेटा सिंक टाइम आउट की सुविधा चालू की जा सकती है. भले ही, आपका ऐप्लिकेशन 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 में, फ़ोरग्राउंड सेवा का एक नया टाइप mediaProcessing
जोड़ा गया है. यह सेवा टाइप, मीडिया फ़ाइलों को ट्रांसकोड करने जैसे कामों के लिए सही है. उदाहरण के लिए, कोई मीडिया ऐप्लिकेशन किसी ऑडियो फ़ाइल को डाउनलोड कर सकता है और उसे चलाने से पहले, किसी दूसरे फ़ॉर्मैट में बदल सकता है. mediaProcessing
फ़ोरग्राउंड सेवा का इस्तेमाल करके, यह पक्का किया जा सकता है कि ऐप्लिकेशन बैकग्राउंड में होने पर भी कन्वर्ज़न जारी रहे.
सिस्टम किसी ऐप्लिकेशन की mediaProcessing
सेवाओं को 24 घंटों में कुल छह घंटे चलाने की अनुमति देता है. इसके बाद, सिस्टम, मौजूदा सेवा के Service.onTimeout(int, int)
तरीके को कॉल करता है (Android 15 में शुरू किया गया). फ़िलहाल, Service.stopSelf()
को कॉल करने के लिए सेवा को कुछ सेकंड मिलेंगे. अगर सेवा Service.stopSelf()
को कॉल नहीं करती है, तो सिस्टम में कोई इंटरनल अपवाद दिखता है. अपवाद को Logcat में लॉग इन किया जाता है जिसमें यह मैसेज शामिल है:
Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"
अपवाद से बचने के लिए, इनमें से कोई एक काम किया जा सकता है:
- अपनी सेवा में
Service.onTimeout(int, int)
का नया तरीका लागू करें. जब आपके ऐप्लिकेशन को कॉलबैक मिलता है, तो कुछ सेकंड के अंदरstopSelf()
को कॉल करना न भूलें. (अगर ऐप्लिकेशन को तुरंत नहीं रोका जाता, तो सिस्टम गड़बड़ी जनरेट करता है.) - पक्का करें कि आपके ऐप्लिकेशन की
mediaProcessing
सेवाएं, 24 घंटे में कुल छह घंटे से ज़्यादा न चलें. ऐसा तब तक नहीं होगा, जब तक उपयोगकर्ता ऐप्लिकेशन के साथ इंटरैक्ट करके, टाइमर को रीसेट नहीं करता. - सीधे उपयोगकर्ता के साथ इंटरैक्शन होने पर ही,
mediaProcessing
फ़ोरग्राउंड सेवाएं शुरू करें. सेवा शुरू होने के समय, आपका ऐप्लिकेशन फ़ोरग्राउंड में होता है. इसलिए, ऐप्लिकेशन के बैकग्राउंड में चलने के बाद, आपकी सेवा को पूरे छह घंटे तक चालू रखा जाता है. mediaProcessing
फ़ोरग्राउंड सेवा का इस्तेमाल करने के बजाय, WorkManager जैसे अन्य एपीआई का इस्तेमाल करें.
अगर आपके ऐप्लिकेशन की mediaProcessing
फ़ोरग्राउंड सेवाएं पिछले 24 में छह घंटों तक चली हैं, तो mediaProcessing
फ़ोरग्राउंड सेवा को तब तक शुरू नहीं किया जा सकता, जब तक
उपयोगकर्ता आपके ऐप्लिकेशन को फ़ोरग्राउंड में न ले जाए (इससे टाइमर रीसेट हो जाता है). अगर कोई दूसरी mediaProcessing
फ़ोरग्राउंड सेवा शुरू करने की कोशिश की जाती है, तो सिस्टम ForegroundServiceStartNotAllowedException
को गड़बड़ी का मैसेज दिखाता है. जैसे, "mediaProcessing टाइप की फ़ोरग्राउंड सेवा के लिए, समयसीमा पहले ही खत्म हो चुकी है".
mediaProcessing
सेवा टाइप के बारे में ज़्यादा जानकारी के लिए, Android 15 के लिए फ़ोरग्राउंड सेवा टाइप में हुए बदलाव: मीडिया प्रोसेसिंग देखें.
टेस्ट करना
अपने ऐप्लिकेशन के काम करने के तरीके की जांच करने के लिए, मीडिया प्रोसेसिंग के टाइम आउट को चालू किया जा सकता है. भले ही, आपका ऐप्लिकेशन 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 media_processing_fgs_timeout_duration duration-in-milliseconds
对启动前台服务的 BOOT_COMPLETED
广播接收器的限制
在启动 BOOT_COMPLETED
广播接收器方面存在新限制
前台服务。BOOT_COMPLETED
接收器不能启动
以下类型的前台服务:
dataSync
camera
mediaPlayback
phoneCall
mediaProjection
microphone
(自 Android 14 起,microphone
就受到此限制)
如果 BOOT_COMPLETED
接收器尝试启动任何上述类型的前台
服务,系统会抛出 ForegroundServiceStartNotAllowedException
。
测试
如需测试应用的行为,您可以启用这些新限制,即使您的应用并未以 Android 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 (एपीआई लेवल 35) और उसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन, अब किसी डिवाइस पर 'परेशान न करें' (डीएनडी) मोड की ग्लोबल स्थिति या नीति को नहीं बदल सकते. ऐसा, उपयोगकर्ता की सेटिंग में बदलाव करके या डीएनडी मोड को बंद करके नहीं किया जा सकता. इसके बजाय, ऐप्लिकेशन को AutomaticZenRule
का योगदान देना होगा. सिस्टम, इस योगदान को सबसे ज़्यादा पाबंदी वाली मौजूदा नीति के साथ मिलाकर, ग्लोबल नीति बनाता है. पहले जिन मौजूदा एपीआई कॉल से ग्लोबल स्टेटस (setInterruptionFilter
,
setNotificationPolicy
) पर असर पड़ा था उनसे, एक 'असहमति' वाला AutomaticZenRule
पैरामीटर बनता है या अपडेट होता है. यह पैरामीटर, उन एपीआई कॉल के कॉल-साइकल के हिसाब से टॉगल किया जाता है.
ध्यान दें कि इस बदलाव का असर सिर्फ़ तब पड़ता है, जब ऐप्लिकेशन setInterruptionFilter(INTERRUPTION_FILTER_ALL)
को कॉल कर रहा हो और उसे उम्मीद हो कि उस कॉल से, AutomaticZenRule
को बंद किया जा सकेगा. AutomaticZenRule
को पहले उसके मालिकों ने चालू किया था.
OpenJDK API में हुए बदलाव
Android 15 将继续更新 Android 的核心库,以与最新 OpenJDK LTS 版本中的功能保持一致。
以下变更可能会影响以 Android 15(API 级别 35)为目标平台的应用的兼容性:
对字符串格式化 API 进行了更改:现在,使用以下
String.format()
和Formatter.format()
API 时,对实参索引、标志、宽度和精度的验证要求变得更加严格:String.format(String, Object[])
String.format(Locale, String, Object[])
Formatter.format(String, Object[])
Formatter.format(Locale, String, Object[])
例如,当使用参数索引 0(格式字符串中的
%0
)时,系统会抛出以下异常:IllegalFormatArgumentIndexException: Illegal format argument index = 0
在这种情况下,可以使用实参索引 1(格式字符串中的
%1
)来解决此问题。对
Arrays.asList(...).toArray()
的组件类型的更改:使用Arrays.asList(...).toArray()
时,所得数组的组件类型现在是Object
,而不是底层数组元素的类型。因此,以下代码会抛出ClassCastException
:String[] elements = (String[]) Arrays.asList("one", "two").toArray();
在这种情况下,为了在生成的数组中保留
String
作为组件类型,您可以改用Collection.toArray(Object[])
:String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
语言代码处理方面的变化:使用
Locale
API 时,希伯来语、意第绪语和印度尼西亚语的语言代码不再转换为其过时的形式(希伯来语:iw
、意第绪语:ji
和印度尼西亚语:in
)。指定这些语言区域的语言代码时,请改用 ISO 639-1 中的代码(希伯来语:he
、意第绪语:yi
和印度尼西亚语:id
)。对随机整数序列的更改:根据 https://bugs.openjdk.org/browse/JDK-8301574 中所做的更改,以下
Random.ints()
方法现在返回的数字序列与Random.nextInt()
方法返回的数字序列不同:一般来说,此更改不应导致应用行为中断,但您的代码不应期望从
Random.ints()
方法生成的序列与Random.nextInt()
相匹配。
新的 SequencedCollection
API 可能会影响您应用的兼容性,具体取决于您是否在应用的 build 配置中更新 compileSdk
以使用 Android 15(API 级别 35):
kotlin-stdlib
中MutableList.removeFirst()
和MutableList.removeLast()
扩展函数的冲突Java 中的
List
类型会映射到 Kotlin 中的MutableList
类型。 由于List.removeFirst()
和List.removeLast()
API 已在 Android 15(API 级别 35)中引入,因此 Kotlin 编译器会将函数调用(例如list.removeFirst()
)静态解析为新的List
API,而不是kotlin-stdlib
中的扩展函数。如果应用重新编译时将
compileSdk
设置为35
,并将minSdk
设置为34
或更低值,然后在 Android 14 及更低版本上运行该应用,则会抛出运行时错误:java.lang.NoSuchMethodError: No virtual method removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;
Android Gradle 插件中现有的
NewApi
lint 选项可以捕获这些新的 API 用法。./gradlew lint
MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi] list.removeFirst()为了修复运行时异常和 lint 错误,可以在 Kotlin 中将
removeFirst()
和removeLast()
函数调用分别替换为removeAt(0)
和removeAt(list.lastIndex)
。如果您使用的是 Android Studio Ladybug | 2024.1.3 或更高版本,它还会针对这些错误提供快速修复选项。如果已停用 lint 选项,请考虑移除
@SuppressLint("NewApi")
和lintOptions { disable 'NewApi' }
。与 Java 中的其他方法发生冲突
现有类型中添加了新方法,例如
List
和Deque
。这些新方法可能与具有相同名称和实参类型的其他接口和类中的方法不兼容。如果方法签名发生不兼容的冲突,javac
编译器会输出 build 时错误。例如:错误示例 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错误示例 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错误示例 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如需修复这些 build 错误,实现这些接口的类应使用兼容的返回类型替换相应方法。例如:
@Override public Object getFirst() { return List.super.getFirst(); }
सुरक्षा
Android 15 में ऐसे बदलाव किए गए हैं जिनसे सिस्टम की सुरक्षा को बढ़ावा मिलता है. इससे ऐप्लिकेशन और लोगों को नुकसान पहुंचाने वाले ऐप्लिकेशन से बचाने में मदद मिलती है.
पाबंदी वाले टीएलएस वर्शन
Android 15, TLS के 1.0 और 1.1 वर्शन के इस्तेमाल पर पाबंदी लगाता है. इन वर्शन को पहले Android में बंद कर दिया गया था. हालांकि, अब Android 15 को टारगेट करने वाले ऐप्लिकेशन के लिए, इनका इस्तेमाल करने की अनुमति नहीं है.
बैकग्राउंड में सुरक्षित तरीके से गतिविधि शुरू करना
Android 15 可保护用户免受恶意应用的侵害,并让用户更好地控制 来防止恶意后台应用 将其他应用置于前台、提升其权限以及滥用 用户互动自以下时间以来,后台活动启动一直受到限制 Android 10(API 级别 29)。
其他变更
除了 UID 匹配限制之外,还包括以下其他更改:
- 默认情况下,将
PendingIntent
创建者更改为屏蔽后台活动启动。这有助于防止应用意外创建可能会被恶意操作者滥用的PendingIntent
。 - 除非
PendingIntent
发件人允许,否则请勿将应用调至前台。此变更旨在防止恶意应用滥用 在后台启动 activity 的功能。默认情况下,应用 允许将任务堆栈转到前台,除非创建者允许 后台活动启动权限或发送者有后台活动 启动权限 - 控制任务堆栈顶部 activity 如何完成其任务。如果顶部 activity 完成任务,Android 将返回上次处于活动状态的任务。此外,如果非顶层 activity 完成其任务,Android 将 返回主屏幕;它不会挡住这个非顶层的 活动。
- 防止将其他应用中的任意 activity 启动到您自己的 activity 任务。这项变更可防止恶意应用通过创建看似来自其他应用的 activity 来钓鱼式攻击用户。
- 阻止系统考虑非可见窗口来启动后台 activity。这有助于防止恶意应用滥用后台 activity 启动来向用户显示不需要或恶意的内容。
ज़्यादा सुरक्षित इंटेंट
Android 15 में, इंटेंट को ज़्यादा सुरक्षित बनाने के लिए नए वैकल्पिक सुरक्षा उपाय पेश किए गए हैं और ज़्यादा मज़बूत. इन बदलावों का मकसद, किसी भी जोखिम की आशंका को रोकना है ऐसे इरादों का गलत तरीके से इस्तेमाल किया जा सके जिनका फ़ायदा नुकसान पहुंचाने वाले ऐप्लिकेशन उठा सकते हैं. Android 15 में, इंटेंट की सुरक्षा को बेहतर बनाने के लिए दो मुख्य बदलाव किए गए हैं:
- टारगेट इंटेंट फ़िल्टर का मैच करें: ऐसे इंटेंट जो खास कॉम्पोनेंट को टारगेट करते हैं टारगेट के इंटेंट-फ़िल्टर की जानकारी से सटीक रूप से मैच होता हो. अगर आपने किसी का इस्तेमाल करने के लिए, टारगेट इंटेंट कॉम्पोनेंट को पाने वाली गतिविधि के तय इंटेंट-फ़िल्टर के साथ अलाइन करें.
- इंटेंट में कार्रवाइयां होनी चाहिए: बिना कार्रवाई वाले इंटेंट, अब किसी भी इंटेंट-फ़िल्टर से मैच नहीं करेंगे. इसका मतलब है कि गतिविधियों या सेवाओं को शुरू करने के लिए इस्तेमाल किए गए इंटेंट में, साफ़ तौर पर बताई गई कार्रवाई होनी चाहिए.
आपका ऐप्लिकेशन इन बदलावों के हिसाब से कैसी प्रतिक्रिया देता है, यह देखने के लिए इसका इस्तेमाल करें
आपके ऐप्लिकेशन में StrictMode
. पूरी जानकारी देखने के लिए
Intent
के इस्तेमाल से जुड़े उल्लंघनों के लॉग में, नीचे दिया गया तरीका जोड़ें:
Kotlin
fun onCreate() { StrictMode.setVmPolicy(VmPolicy.Builder() .detectUnsafeIntentLaunch() .build() ) }
Java
public void onCreate() { StrictMode.setVmPolicy(new VmPolicy.Builder() .detectUnsafeIntentLaunch() .build()); }
उपयोगकर्ता अनुभव और सिस्टम यूज़र इंटरफ़ेस (यूआई)
Android 15 में कुछ ऐसे बदलाव किए गए हैं जिनसे उपयोगकर्ताओं को बेहतर और आसान अनुभव मिलेगा.
विंडो इंसर्ट में बदलाव
Android 15 में, विंडो इनसेट से जुड़े दो बदलाव किए गए हैं: डिफ़ॉल्ट रूप से, स्क्रीन के किनारों तक विंडो दिखती है. साथ ही, कॉन्फ़िगरेशन में भी बदलाव किए गए हैं. जैसे, सिस्टम बार का डिफ़ॉल्ट कॉन्फ़िगरेशन.
एज-टू-एज एनफ़ोर्समेंट
अगर कोई ऐप्लिकेशन Android 15 (एपीआई लेवल 35) को टारगेट कर रहा है, तो Android 15 पर चलने वाले डिवाइसों पर वह डिफ़ॉल्ट रूप से एज-टू-एज डिसप्ले दिखाएगा.

यह एक बड़ा बदलाव है. इससे आपके ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) पर बुरा असर पड़ सकता है. बदलावों से यूज़र इंटरफ़ेस (यूआई) के इन हिस्सों पर असर पड़ता है:
- जेस्चर हैंडल वाला नेविगेशन बार
- डिफ़ॉल्ट रूप से पारदर्शी होता है.
- बॉटम ऑफ़सेट बंद है. इसलिए, कॉन्टेंट सिस्टम नेविगेशन बार के पीछे दिखता है. हालांकि, अगर इंसर्ट लागू किए जाते हैं, तो ऐसा नहीं होता.
setNavigationBarColor
औरR.attr#navigationBarColor
को बंद कर दिया गया है. इनका इस्तेमाल करने से, हाथ के जेस्चर (स्पर्श) वाले नेविगेशन पर कोई असर नहीं पड़ता.setNavigationBarContrastEnforced
औरR.attr#navigationBarContrastEnforced
का जेस्चर नेविगेशन पर कोई असर नहीं पड़ता.
- तीन बटन वाला नेविगेशन
- ओपैसिटी डिफ़ॉल्ट रूप से 80% पर सेट होती है. इसका रंग, विंडो के बैकग्राउंड से मेल खा सकता है.
- बॉटम ऑफ़सेट बंद है, इसलिए कॉन्टेंट सिस्टम नेविगेशन बार के पीछे दिखता है. हालांकि, अगर इंसर्ट लागू किए जाते हैं, तो ऐसा नहीं होगा.
setNavigationBarColor
औरR.attr#navigationBarColor
को डिफ़ॉल्ट रूप से, विंडो के बैकग्राउंड से मैच करने के लिए सेट किया जाता है. डिफ़ॉल्ट सेटिंग लागू करने के लिए, विंडो का बैकग्राउंड, ड्रॉ करने लायक रंग होना चाहिए. इस एपीआई का इस्तेमाल अब नहीं किया जा सकता. हालांकि, इससे तीन बटन वाले नेविगेशन पर अब भी असर पड़ता है.setNavigationBarContrastEnforced
औरR.attr#navigationBarContrastEnforced
की वैल्यू डिफ़ॉल्ट रूप से सही पर सेट होती है. इससे तीन बटन वाले नेविगेशन में, 80% अपारदर्शी बैकग्राउंड जुड़ जाता है.
- स्टेटस बार
- डिफ़ॉल्ट रूप से पारदर्शी होता है.
- टॉप ऑफ़सेट बंद है. इसलिए, स्टेटस बार के पीछे कॉन्टेंट तब तक नहीं दिखता, जब तक कि इंसर्ट लागू नहीं किए जाते.
setStatusBarColor
औरR.attr#statusBarColor
अब काम नहीं करते. इनका Android 15 पर कोई असर नहीं पड़ता.setStatusBarContrastEnforced
औरR.attr#statusBarContrastEnforced
अब काम नहीं करते, लेकिन इनका असर अब भी Android 15 पर पड़ता है.
- डिसप्ले कटआउट
- नॉन-फ़्लोटिंग विंडो का
layoutInDisplayCutoutMode
LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
होना चाहिए.SHORT_EDGES
,NEVER
, औरDEFAULT
कोALWAYS
के तौर पर दिखाया जाता है, ताकि उपयोगकर्ताओं को डिसप्ले कटआउट की वजह से काली पट्टी न दिखे और वे किनारे से किनारे तक दिखें.
- नॉन-फ़्लोटिंग विंडो का
यहां दिए गए उदाहरण में, Android 15 (एपीआई लेवल 35) को टारगेट करने से पहले और बाद में ऐप्लिकेशन को दिखाया गया है. साथ ही, इनसेट लागू करने से पहले और बाद में ऐप्लिकेशन को दिखाया गया है. यह उदाहरण पूरी जानकारी नहीं देता. यह Android Auto पर अलग तरह से दिख सकता है.



अगर आपका ऐप्लिकेशन पहले से ही एज-टू-एज है, तो क्या जांच करें
अगर आपका ऐप्लिकेशन पहले से ही एज-टू-एज है और उसमें इनसेट लागू हैं, तो आपको ज़्यादा असर नहीं पड़ेगा. हालांकि, इन स्थितियों में असर पड़ सकता है. हालांकि, अगर आपको लगता है कि आपके ऐप्लिकेशन पर इसका असर नहीं पड़ा है, तो भी हमारा सुझाव है कि आप अपने ऐप्लिकेशन की जांच करें.
- आपके पास ऐसी विंडो है जो फ़्लोटिंग नहीं है. जैसे,
Activity
जोLAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS
के बजायSHORT_EDGES
,NEVER
याDEFAULT
का इस्तेमाल करती है. अगर लॉन्च होने पर आपका ऐप्लिकेशन क्रैश हो जाता है, तो ऐसा स्प्लैशस्क्रीन की वजह से हो सकता है. core splashscreen डिपेंडेंसी को 1.2.0-alpha01 या उसके बाद के वर्शन पर अपग्रेड किया जा सकता है. इसके अलावा,window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always
सेट किया जा सकता है. - ऐसा हो सकता है कि यूज़र इंटरफ़ेस (यूआई) के कुछ हिस्से ढके होने की वजह से, स्क्रीन पर कम ट्रैफ़िक हो. पुष्टि करें कि कम विज़िट की जाने वाली इन स्क्रीन पर, यूज़र इंटरफ़ेस (यूआई) का कोई हिस्सा छिपा हुआ न हो. कम ट्रैफ़िक वाली स्क्रीन में ये शामिल हैं:
- ऑनबोर्डिंग या साइन-इन स्क्रीन
- सेटिंग पेज
अगर आपका ऐप्लिकेशन पहले से ही एज-टू-एज नहीं है, तो क्या देखना चाहिए
अगर आपका ऐप्लिकेशन पहले से ही एज-टू-एज नहीं है, तो हो सकता है कि आप पर इसका असर पड़े. पहले से ही एज-टू-एज डिसप्ले वाले ऐप्लिकेशन के अलावा, आपको इन बातों का भी ध्यान रखना चाहिए:
- अगर आपका ऐप्लिकेशन, Compose में Material 3 कॉम्पोनेंट (
androidx.compose.material3
) का इस्तेमाल करता है, जैसे किTopAppBar
,BottomAppBar
, औरNavigationBar
, तो इन कॉम्पोनेंट पर असर नहीं पड़ेगा, क्योंकि ये इनसेट को अपने-आप मैनेज करते हैं. - अगर आपका ऐप्लिकेशन Compose में Material 2 कॉम्पोनेंट (
androidx.compose.material
) का इस्तेमाल कर रहा है, तो ये कॉम्पोनेंट इंसर्ट को अपने-आप मैनेज नहीं करते. हालांकि, आपको इनसेट का ऐक्सेस मिल सकता है और उन्हें मैन्युअल तरीके से लागू किया जा सकता है. androidx.compose.material 1.6.0 और इसके बाद के वर्शन में,windowInsets
पैरामीटर का इस्तेमाल करके,BottomAppBar
,TopAppBar
,BottomNavigation
, औरNavigationRail
के लिए इंसर्ट मैन्युअल तरीके से लागू करें. इसी तरह,Scaffold
के लिएcontentWindowInsets
पैरामीटर का इस्तेमाल करें. - अगर आपका ऐप्लिकेशन व्यू और Material Components (
com.google.android.material
) का इस्तेमाल करता है, तो व्यू पर आधारित ज़्यादातर Material Components, जैसे किBottomNavigationView
,BottomAppBar
,NavigationRailView
याNavigationView
, इनसेट को मैनेज करते हैं. इसके लिए, आपको कुछ और करने की ज़रूरत नहीं होती. हालांकि,AppBarLayout
का इस्तेमाल करने पर,android:fitsSystemWindows="true"
को जोड़ना ज़रूरी है. - कस्टम कंपोज़ेबल के लिए, पैडिंग के तौर पर इंसर्ट को मैन्युअल तरीके से लागू करें. अगर आपका कॉन्टेंट
Scaffold
में है, तोScaffold
पैडिंग वैल्यू का इस्तेमाल करके, इनसेट का इस्तेमाल किया जा सकता है. इसके अलावा,WindowInsets
में से किसी एक का इस्तेमाल करके पैडिंग लागू करें. - अगर आपका ऐप्लिकेशन व्यू और
BottomSheet
,SideSheet
या कस्टम कंटेनर का इस्तेमाल कर रहा है, तोViewCompat.setOnApplyWindowInsetsListener
का इस्तेमाल करके पैडिंग लागू करें.RecyclerView
के लिए, इस लिसनर का इस्तेमाल करके पैडिंग लागू करें. साथ ही,clipToPadding="false"
जोड़ें.
अगर आपके ऐप्लिकेशन में बैकग्राउंड में काम करने वाली सुविधा के लिए, कस्टम सुरक्षा की सुविधा उपलब्ध कराना ज़रूरी है, तो आपको किन बातों का ध्यान रखना चाहिए
अगर आपके ऐप्लिकेशन को तीन बटन वाले नेविगेशन या स्टेटस बार के लिए, कस्टम बैकग्राउंड सुरक्षा की सुविधा देनी है, तो आपके ऐप्लिकेशन को सिस्टम बार के पीछे कंपोज़ेबल या व्यू रखना चाहिए. इसके लिए, WindowInsets.Type#tappableElement()
का इस्तेमाल करके तीन बटन वाले नेविगेशन बार की ऊंचाई या WindowInsets.Type#statusBars
का इस्तेमाल करना चाहिए.
पूरी स्क्रीन पर दिखने वाले अन्य संसाधन
इनसेट लागू करने के बारे में ज़्यादा जानकारी के लिए, Edge to Edge Views और Edge to Edge Compose गाइड देखें.
पुराने एपीआई
ये एपीआई बंद कर दिए गए हैं, लेकिन इन्हें अब भी इस्तेमाल किया जा सकता है:
R.attr#enforceStatusBarContrast
R.attr#navigationBarColor
(तीन बटन वाले नेविगेशन के लिए, 80% ऐल्फ़ा के साथ)Window#isStatusBarContrastEnforced
Window#setNavigationBarColor
(तीन बटन वाले नेविगेशन के लिए, 80% ऐल्फ़ा के साथ)Window#setStatusBarContrastEnforced
इन एपीआई को बंद कर दिया गया है और ये काम नहीं करेंगे:
R.attr#navigationBarColor
(जेस्चर वाले नेविगेशन के लिए)R.attr#navigationBarDividerColor
R.attr#statusBarColor
Window#setDecorFitsSystemWindows
Window#getNavigationBarColor
Window#getNavigationBarDividerColor
Window#getStatusBarColor
Window#setNavigationBarColor
(जेस्चर वाले नेविगेशन के लिए)Window#setNavigationBarDividerColor
Window#setStatusBarColor
स्टेबल कॉन्फ़िगरेशन
अगर आपका ऐप्लिकेशन, Android 15 (एपीआई लेवल 35) या इसके बाद के वर्शन को टारगेट करता है, तो Configuration
अब सिस्टम बार को शामिल नहीं करता है. अगर लेआउट का हिसाब लगाने के लिए, Configuration
क्लास में स्क्रीन साइज़ का इस्तेमाल किया जाता है, तो आपको इसे बेहतर विकल्पों से बदलना चाहिए. जैसे, अपनी ज़रूरत के हिसाब से सही ViewGroup
, WindowInsets
या WindowMetricsCalculator
.
Configuration
, एपीआई 1 से उपलब्ध है. आम तौर पर, इसे Activity.onConfigurationChanged
से लिया जाता है. इससे विंडो डेंसिटी, ओरिएंटेशन, और साइज़ जैसी जानकारी मिलती है. Configuration
से मिले विंडो साइज़ की एक अहम खासियत यह है कि इसमें पहले सिस्टम बार शामिल नहीं होते थे.
कॉन्फ़िगरेशन साइज़ का इस्तेमाल आम तौर पर संसाधन चुनने के लिए किया जाता है. जैसे, /res/layout-h500dp
. यह अब भी इस्तेमाल का मान्य उदाहरण है. हालांकि, लेआउट का हिसाब लगाने के लिए इसका इस्तेमाल करने से हमेशा मना किया जाता है. अगर आपने ऐसा किया है, तो आपको अब इससे दूर हो जाना चाहिए. आपको Configuration
की जगह, अपनी ज़रूरत के हिसाब से कोई और बेहतर विकल्प इस्तेमाल करना चाहिए.
अगर आपको लेआउट का हिसाब लगाने के लिए इसका इस्तेमाल करना है, तो सही ViewGroup
का इस्तेमाल करें. जैसे, CoordinatorLayout
या ConstraintLayout
. अगर इसका इस्तेमाल सिस्टम के नेविगेशन बार की ऊंचाई का पता लगाने के लिए किया जाता है, तो WindowInsets
का इस्तेमाल करें. अगर आपको अपने ऐप्लिकेशन की विंडो का मौजूदा साइज़ जानना है, तो computeCurrentWindowMetrics
का इस्तेमाल करें.
यहां दी गई सूची में, उन फ़ील्ड के बारे में बताया गया है जिन पर इस बदलाव का असर पड़ा है:
Configuration.screenWidthDp
औरscreenHeightDp
साइज़ में अब सिस्टम बार शामिल होते हैं.Configuration.smallestScreenWidthDp
परscreenWidthDp
औरscreenHeightDp
में हुए बदलावों का असर पड़ता है.Configuration.orientation
पर, स्क्वेयर जैसे डिवाइसों परscreenWidthDp
औरscreenHeightDp
में किए गए बदलावों का असर पड़ता है.Display.getSize(Point)
पर,Configuration
में हुए बदलावों का असर सीधे तौर पर नहीं पड़ता. इसे एपीआई लेवल 30 से बंद कर दिया गया है.Display.getMetrics()
, एपीआई लेवल 33 से ही इस तरह काम कर रहा है.
elegantTextHeight एट्रिब्यूट डिफ़ॉल्ट रूप से सही पर सेट होता है
对于以 Android 15(API 级别 35)为目标平台的应用,elegantTextHeight
TextView
属性默认会变为 true
,将默认使用的紧凑字体替换为一些具有较大垂直测量的脚本,使其更易于阅读。紧凑字体旨在防止布局中断;Android 13(API 级别 33)允许文本布局利用 fallbackLineSpacing
属性拉伸垂直高度,从而防止许多此类中断。
在 Android 15 中,系统中仍保留了紧凑字体,因此您的应用可以将 elegantTextHeight
设置为 false
以获得与之前相同的行为,但即将发布的版本不太可能支持此字体。因此,如果您的应用支持以下脚本:阿拉伯语、老挝语、缅甸语、泰米尔语、古吉拉特语、卡纳达语、马拉雅拉姆语、奥里亚语、泰卢固语或泰语,请将 elegantTextHeight
设置为 true
以测试您的应用。

elegantTextHeight
行为。
elegantTextHeight
行为。जटिल अक्षर के आकार के लिए, TextView की चौड़ाई में बदलाव होता है
Android के पिछले वर्शन में, पेचीदा आकार वाले कुछ कर्सिव फ़ॉन्ट या भाषाएं, पिछले या अगले वर्ण के एरिया में अक्षर खींच सकती हैं.
कुछ मामलों में, ऐसे अक्षरों को शुरुआत या आखिर में काटकर छोटा किया गया था.
Android 15 से, TextView
ऐसे अक्षरों के लिए ज़रूरी जगह बनाने के लिए
चौड़ाई तय करता है. साथ ही, क्लिप बनाने से रोकने के लिए,
ऐप्लिकेशन बाईं ओर ज़्यादा पैडिंग (जगह) का अनुरोध कर सकते हैं.
इस बदलाव का असर इस बात पर पड़ता है कि TextView
, चौड़ाई का फ़ैसला कैसे लेता है. इसलिए, अगर ऐप्लिकेशन Android 15 (एपीआई लेवल 35) या उसके बाद के वर्शन को टारगेट करता है, तो TextView
डिफ़ॉल्ट रूप से ज़्यादा चौड़ाई तय करता है. setUseBoundsForWidth
पर एपीआई को कॉल करके, इस सुविधा को चालू या बंद किया जा सकता है.TextView
बाईं ओर की पैडिंग जोड़ने से, हो सकता है कि मौजूदा लेआउट गलत तरीके से अलाइन हो जाएं. ऐसा होने पर, Android 15 या इसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन के लिए भी पैडिंग (जगह) डिफ़ॉल्ट रूप से नहीं जोड़ी जाती.
हालांकि, setShiftDrawingOffsetForStartOverhang
को कॉल करके, क्लिपिंग को रोकने के लिए अतिरिक्त पैडिंग जोड़ी जा सकती है.
नीचे दिए गए उदाहरणों से पता चलता है कि इन बदलावों से कुछ फ़ॉन्ट और भाषाओं के लिए टेक्स्ट लेआउट को बेहतर कैसे बनाया जा सकता है.

<TextView android:fontFamily="cursive" android:text="java" />

<TextView android:fontFamily="cursive" android:text="java" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />

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

<TextView android:text="คอมพิวเตอร์" android:useBoundsForWidth="true" android:shiftDrawingOffsetForStartOverhang="true" />
EditText के लिए, स्थान-भाषा के हिसाब से लाइन की डिफ़ॉल्ट ऊंचाई
Android के पिछले वर्शन में, टेक्स्ट लेआउट, टेक्स्ट की ऊंचाई को बढ़ा देता था, ताकि मौजूदा स्थानीय भाषा से मैच करने वाले फ़ॉन्ट की लाइन की ऊंचाई पूरी की जा सके. उदाहरण के लिए, अगर कॉन्टेंट जैपनीज़ में था, तो टेक्स्ट की ऊंचाई थोड़ी ज़्यादा हो गई, क्योंकि जैपनीज़ फ़ॉन्ट की लाइन की ऊंचाई, लैटिन फ़ॉन्ट की लाइन की ऊंचाई से थोड़ी ज़्यादा होती है. हालांकि, लाइन हाइट में इन अंतरों के बावजूद, इस्तेमाल किए जा रहे स्थानीय भाषा के बावजूद, EditText
एलिमेंट का साइज़ एक जैसा था, जैसा कि इस इमेज में दिखाया गया है:

EditText
एलिमेंट दिखाने वाले तीन बॉक्स, जिनमें इंग्लिश (en), जैपनीज़ (ja), और बर्मीज़ (my) भाषा का टेक्स्ट हो सकता है. EditText
की ऊंचाई एक जैसी है, भले ही इन भाषाओं की लाइन की ऊंचाई एक-दूसरे से अलग हो.Android 15 (एपीआई लेवल 35) को टारगेट करने वाले ऐप्लिकेशन के लिए, EditText
के लिए कम से कम लाइन हाइट तय की गई है. इससे, तय की गई लोकेल के रेफ़रंस फ़ॉन्ट से मैच करने में मदद मिलती है. इसकी जानकारी इस इमेज में दी गई है:

EditText
एलिमेंट दिखाने वाले तीन बॉक्स, जिनमें इंग्लिश (en), जैपनीज़ (ja), और बर्मीज़ (my) भाषा का टेक्स्ट हो सकता है. EditText
की ऊंचाई में अब इन भाषाओं के फ़ॉन्ट के लिए, डिफ़ॉल्ट लाइन की ऊंचाई को शामिल करने के लिए स्पेस शामिल है.ज़रूरत पड़ने पर, आपका ऐप्लिकेशन useLocalePreferredLineHeightForMinimum
एट्रिब्यूट को false
पर सेट करके, पहले जैसा व्यवहार वापस ला सकता है. साथ ही, आपका ऐप्लिकेशन Kotlin और Java में setMinimumFontMetrics
एपीआई का इस्तेमाल करके, कस्टम मिनिमम वर्टिकल मेट्रिक सेट कर सकता है.
कैमरा और मीडिया
Android 15 या इसके बाद के वर्शन को टारगेट करने वाले ऐप्लिकेशन के लिए, Android 15 में कैमरा और मीडिया के काम करने के तरीके में ये बदलाव किए गए हैं.
ऑडियो फ़ोकस का अनुरोध करने पर लगी पाबंदियां
Android 15 (एपीआई लेवल 35) को टारगेट करने वाले ऐप्लिकेशन को ऑडियो फ़ोकस का अनुरोध करने के लिए, टॉप ऐप्लिकेशन या फ़ोरग्राउंड सेवा के तौर पर चलना होगा. अगर कोई ऐप्लिकेशन इनमें से किसी एक ज़रूरी शर्त को पूरा न करने पर फ़ोकस का अनुरोध करता है, तो कॉल AUDIOFOCUS_REQUEST_FAILED
दिखाता है.
ऑडियो फ़ोकस के बारे में ज़्यादा जानने के लिए, ऑडियो फ़ोकस मैनेज करें पर जाएं.
एसडीके इंटिग्रेट किए बगैर इस्तेमाल की जाने वाली सुविधाओं पर लगी पाबंदियां अपडेट की गईं
Android 15 包含更新后的受限非 SDK 接口列表(基于与 Android 开发者之间的协作以及最新的内部测试)。在限制使用非 SDK 接口之前,我们会尽可能确保有可用的公开替代方案。
如果您的应用并非以 Android 15 为目标平台,其中一些变更可能不会立即对您产生影响。不过,虽然您的应用可以访问某些非 SDK 接口(具体取决于应用的目标 API 级别),但只要您使用任何非 SDK 方法或字段,终归存在导致应用出问题的显著风险。
如果您不确定自己的应用是否使用了非 SDK 接口,则可以测试该应用,进行确认。如果您的应用依赖于非 SDK 接口,则应该开始计划迁移到 SDK 替代方案。不过,我们知道某些应用具有使用非 SDK 接口的有效用例。如果您无法为应用中的某项功能找到使用非 SDK 接口的替代方案,则应该请求新的公共 API。
Android के इस वर्शन में हुए बदलावों के बारे में ज़्यादा जानने के लिए, Android 15 में, SDK टूल के अलावा अन्य इंटरफ़ेस से जुड़ी पाबंदियों में हुए अपडेट देखें. आम तौर पर, SDK टूल के बाहर के इंटरफ़ेस के बारे में ज़्यादा जानने के लिए, SDK टूल के बाहर के इंटरफ़ेस पर लगी पाबंदियां देखें.