التغييرات في السلوك: التطبيقات التي تستهدف الإصدار 15 Android أو الإصدارات الأحدث

مثل الإصدارات السابقة، يتضمّن Android 15 تغييرات في السلوك قد تؤثر في تطبيقك. تنطبق التغييرات التالية في السلوك حصريًا على التطبيقات التي تستهدف Android 15 أو الإصدارات الأحدث. إذا كان تطبيقك يستهدف Android 15 أو الإصدارات الأحدث، عليك تعديل تطبيقك ليتوافق مع هذه السلوكيات بشكل صحيح، حيثما ينطبق ذلك.

يُرجى أيضًا مراجعة قائمة التغييرات في السلوك التي تؤثر في جميع التطبيقات التي تعمل على Android 15 بغض النظر عن targetSdkVersion لتطبيقك.

الوظيفة الأساسية

يعدّل Android 15 الإمكانات الأساسية المختلفة لنظام Android أو يوسّع نطاقها.

التغييرات على الخدمات التي تعمل في المقدّمة

我们将对 Android 15 中的前台服务进行以下更改。

• 数据同步前台服务超时行为
• 新的媒体处理前台服务类型
• 对启动前台服务的 BOOT_COMPLETED 广播接收器的限制
• 在应用拥有 SYSTEM_ALERT_WINDOW 权限时启动前台服务的限制

数据同步前台服务超时行为

يقدّم Android 15 سلوكًا جديدًا للمهلة في dataSync للتطبيقات التي تستهدف Android 15 (المستوى 35 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث. ينطبق هذا السلوك أيضًا على نوع "mediaProcessing" الجديد للخدمة التي تعمل في المقدّمة.

يسمح النظام بتشغيل خدمات dataSync للتطبيق لمدة 6 ساعات إجمالاً خلال 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]"

ملاحظة: تتم مشاركة الحدّ الزمني البالغ 6 ساعات مع جميع dataSync خدمات foreground التطبيق. على سبيل المثال، إذا كان التطبيق يشغِّل خدمة dataSync لمدة أربع ساعات، ثم بدأ خدمة dataSync مختلفة، لن يُسمح بتشغيل هذه الخدمة الثانية سوى لمدة ساعتَين. ومع ذلك، إذا عرض المستخدم التطبيق في المقدمة، تتم إعادة ضبط الموقّت وسيتوفّر لدى التطبيق 6 ساعات.

لتجنُّب المشاكل المتعلّقة بهذا التغيير في السلوك، يمكنك اتّخاذ إجراء أو أكثر من الإجراءات التالية:

1. يجب أن تنفِّذ خدمتك طريقة Service.onTimeout(int, int) الجديدة. عندما يتلقّى تطبيقك المكالمة المُعاد توجيهها، احرص على الاتصال بالرقم stopSelf() في غضون بضع ثوانٍ. (إذا لم توقف التطبيق على الفور، سيُنشئ النظام حالة تعطُّل.)
2. تأكَّد من أنّ خدمات dataSync في تطبيقك لا تعمل لأكثر من إجمالي 6 ساعات في أي فترة 24 ساعة (ما لم يتفاعل المستخدم مع التطبيق، يؤدي ذلك إلى إعادة ضبط الموقّت).
3. لا تبدأ dataSync الخدمات التي تعمل في المقدّمة إلا نتيجةً لتفاعل مباشر من العميل، لأنّ تطبيقك يكون في المقدّمة عند بدء الخدمة، ويكون لدى خدمتك ست ساعات كاملة بعد انتقال التطبيق إلى الخلفية.
4. بدلاً من استخدام خدمة dataSync تعمل في المقدّمة، استخدِم واجهة برمجة تطبيقات بديلة.

إذا استمر تشغيل خدمات dataSync التي تعمل في المقدّمة في تطبيقك لمدة 6 ساعات في آخر 24 ساعة، لا يمكنك بدء خدمة أخرى تعمل في المقدّمة dataSync ما لم ينقل المستخدم تطبيقك إلى المقدّمة (ما يؤدي إلى إعادة ضبط الموقّت). إذا حاولت بدء dataSync خدمة أخرى تعمل في المقدّمة، يُرسِل النظام ForegroundServiceStartNotAllowedException رسالة خطأ مثل "انتهت المهلة الزمنية للخدمة التي تعمل في المقدّمة من النوع dataSync".

الاختبار

لاختبار سلوك تطبيقك، يمكنك تفعيل مهلات مزامنة البيانات حتى إذا كان تطبيقك لا يستهدف الإصدار 15 من نظام التشغيل Android (ما دام التطبيق يعمل على جهاز 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 للتطبيق لمدة إجمالية تبلغ 6 ساعات خلال فترة 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]"

ملاحظة: تتم مشاركة الحدّ الزمني البالغ 6 ساعات مع جميع mediaProcessing خدمات التطبيق التي تعمل في المقدّمة. على سبيل المثال، إذا شغّل أحد التطبيقات خدمة mediaProcessing لمدة أربع ساعات، ثم شغّل خدمة mediaProcessing مختلفة، سيتم السماح بتشغيل تلك الخدمة الثانية لمدة ساعتين فقط. ومع ذلك، إذا أعاد المستخدم عرض التطبيق في المقدّمة، تتم إعادة ضبط الموقّت ويصبح لدى التطبيق 6 ساعات.

لتجنُّب حدوث الاستثناء، يمكنك تنفيذ أحد الإجراءات التالية:

1. اطلب من مقدّم الخدمة تنفيذ طريقة Service.onTimeout(int, int) الجديدة. عندما يتلقّى تطبيقك معاودة الاتصال، احرص على الاتصال بـ stopSelf() في غضون بضع ثوانٍ. (إذا لم توقف التطبيق على الفور، سيُنشئ النظام حالة تعطُّل.)
2. تأكَّد من أنّ خدمات mediaProcessing في تطبيقك لا تعمل لأكثر من إجمالي 6 ساعات في أي فترة 24 ساعة (ما لم يتفاعل المستخدم مع التطبيق، يؤدي ذلك إلى إعادة ضبط الموقّت).
3. لا تبدأ mediaProcessing الخدمات التي تعمل في المقدّمة إلا نتيجةً لتفاعل مباشر من العميل، لأنّ تطبيقك يكون في المقدّمة عند بدء الخدمة، ويكون لدى خدمتك ست ساعات كاملة بعد انتقال التطبيق إلى الخلفية.
4. بدلاً من استخدام خدمة mediaProcessing تعمل في المقدّمة، استخدِم واجهة برمجة تطبيقات بديلة، مثل WorkManager.

إذا استمر تشغيل خدمات mediaProcessing التي تعمل في المقدّمة في تطبيقك لمدة 6 ساعات في آخر 24 ساعة، لا يمكنك بدء خدمة أخرى تعمل في المقدّمة mediaProcessing ما لم ينقل المستخدم تطبيقك إلى المقدّمة (ما يؤدي إلى إعادة ضبط الموقّت). إذا حاولت بدء خدمة "mediaProcessing" أخرى تعمل في المقدّمة، سيعرض النظام ForegroundServiceStartNotAllowedException رسالة خطأ مثل "تم استنفاد المهلة الزمنية لنوع الخدمة التي تعمل في المقدّمة mediaProcessing".

لمزيد من المعلومات عن نوع الخدمة mediaProcessing، يُرجى الاطّلاع على المقالة التغييرات التي طرأت على أنواع الخدمات التي تعمل في المقدّمة لنظام التشغيل Android 15: معالجة الوسائط.

الاختبار

لاختبار سلوك تطبيقك، يمكنك تفعيل مهلات معالجة الوسائط حتى إذا كان تطبيقك لا يستهدف الإصدار 15 من نظام التشغيل Android (ما دام التطبيق يعمل على جهاز يعمل بالإصدار 15 من نظام التشغيل Android). لتفعيل مهلات الانتظار، شغِّل الأمر 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 (تم فرض هذا التقييد على microphone منذ بدء استخدام الإصدار 14 من نظام التشغيل Android)

إذا حاول مستقبل BOOT_COMPLETED بدء أيّ من هذه الأنواع من الخدمات التي تعمل في المقدّمة، يُرسِل النظام الخطأ ForegroundServiceStartNotAllowedException.

الاختبار

لاختبار سلوك تطبيقك، يمكنك تفعيل هذه القيود الجديدة حتى إذا كان تطبيقك لا يستهدف الإصدار 15 من Android (ما دام التطبيق يعمل على جهاز يعمل بالإصدار 15 من Android). شغِّل الأمر 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 权限时启动前台服务的限制

في السابق، إذا كان التطبيق يمتلك إذن SYSTEM_ALERT_WINDOW، كان بإمكانه بدء خدمة تعمل في المقدّمة حتى إذا كان التطبيق قيد التشغيل في الخلفية (كما هو описан في الاستثناءات من القيود المفروضة على بدء التطبيقات في الخلفية).

إذا كان التطبيق يستهدف الإصدار 15 من نظام التشغيل Android، أصبح هذا الإعفاء الآن أكثر تقييدًا. يجب أن يحصل التطبيق الآن على إذن SYSTEM_ALERT_WINDOW وأيضًا أن يتضمّن نافذة ملف شخصي مثبّت مرئية. وهذا يعني أنّ التطبيق يجب أن يفتح أولاً نافذة TYPE_APPLICATION_OVERLAY و يجب أن تكون النافذة مرئية قبل بدء خدمة تعمل في المقدّمة.

إذا حاول تطبيقك بدء خدمة تعمل في المقدّمة من الخلفية بدون استيفاء هذه المتطلبات الجديدة (وليس لديه أي استثناء آخر)، يُرسِل النظام الخطأ ForegroundServiceStartNotAllowedException.

إذا كان تطبيقك يعلن عن إذن SYSTEM_ALERT_WINDOW ويشغّل الخدمات التي تعمل في المقدّمة من الخلفية، قد يتأثّر بالتغيير الذي تم إجراؤه. إذا حصل تطبيقك على ForegroundServiceStartNotAllowedException، تحقَّق من ترتيب عمليات تطبيقك وتأكَّد من أنّ تطبيقك لديه نافذة تراكب نشطة قبل أن يحاول بدء خدمة تعمل في المقدّمة من الخلفية. يمكنك التحقّق مما إذا كانت نافذة التراكب مرئية حاليًا من خلال استدعاء View.getWindowVisibility()، أو يمكنك إلغاء View.onWindowVisibilityChanged() للحصول على إشعارات عند تغيير مستوى العرض.

الاختبار

لاختبار سلوك تطبيقك، يمكنك تفعيل هذه القيود الجديدة حتى إذا كان تطبيقك لا يستهدف الإصدار 15 من نظام التشغيل Android (ما دام التطبيق يعمل على جهاز Android 15). لتفعيل هذه القيود الجديدة على بدء الخدمات التي تعمل في المقدّمة من الخلفية، شغِّل الأمر adb التالي:

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

تغييرات على الحالات التي يمكن فيها للتطبيقات تعديل الحالة العامة لوضع "عدم الإزعاج"

لم تعُد التطبيقات التي تستهدف الإصدار 15 من نظام التشغيل Android (المستوى 35 لواجهة برمجة التطبيقات) والإصدارات الأحدث قادرة على تغيير الحالة أو السياسة الشاملة لوضع "عدم الإزعاج" على الجهاز (إما عن طريق تعديل إعدادات المستخدم أو إيقاف وضع "عدم الإزعاج"). بدلاً من ذلك، يجب أن توفّر التطبيقات ملفًا بعنوان AutomaticZenRule، والذي يجمعه النظام في سياسة عامة وفقًا لأسلوب السياسة الأكثر تقييدًا هي السائدة. تؤدي طلبات البيانات من واجهات برمجة التطبيقات الحالية التي أثرت في السابق في الحالة العامة (setInterruptionFilter، setNotificationPolicy) إلى إنشاء AutomaticZenRule ضمني أو تعديله، ويتم تفعيله أو إيقافه استنادًا إلى دورة طلبات بيانات واجهة برمجة التطبيقات.

يُرجى العِلم أنّ هذا التغيير لا يؤثر في السلوك الملحوظ إلا إذا كان التطبيق يتصل setInterruptionFilter(INTERRUPTION_FILTER_ALL) ويتوقع أن يؤدي هذا الاتصال إلى إيقاف AutomaticZenRule الذي فعّله مالكو التطبيق سابقًا.

التغييرات في واجهة برمجة التطبيقات OpenJDK

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）。

• 对随机 int 序列的更改：在 https://bugs.openjdk.org/browse/JDK-8301574 中做出更改后，以下 Random.ints() 方法现在返回的数字序列与 Random.nextInt() 方法不同：

  • Random.ints(long)
  • Random.ints(long, int, int)
  • Random.ints(int, int)
  • Random.ints()

  通常，此更改不会导致应用行为异常，但您的代码不应期望从 Random.ints() 方法生成的序列与 Random.nextInt() 匹配。

当您在应用的 build 配置中将 compileSdk 更新为使用 Android 15（API 级别 35）后，新的 SequencedCollection API 可能会影响应用的兼容性：

• 与 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 编译器会输出构建时错误。例如：

  错误示例 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
  

  如需修复这些构建错误，实现这些接口的类应使用兼容的返回值类型替换该方法。例如：

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

الأمان

يتضمّن Android 15 تغييرات تعزّز أمان النظام للمساعدة في حماية التطبيقات والمستخدمين من التطبيقات الضارة.

إصدارات بروتوكول أمان طبقة النقل (TLS) المحظورة

يفرض نظام التشغيل Android 15 قيودًا على استخدام الإصدارَين 1.0 و1.1 من بروتوكول أمان طبقة النقل. تم إيقاف هذه الإصدارات نهائيًا في Android، ولكن تم الآن حظر استخدامها في التطبيقات التي تستهدف الإصدار Android 15.

عمليات إطلاق آمنة للأنشطة في الخلفية

يحمي Android 15 المستخدمين من التطبيقات الضارة ويمنحهم المزيد من التحكّم في أجهزتهم من خلال إضافة تغييرات تمنع التطبيقات الضارة التي تعمل في الخلفية من نقل تطبيقات أخرى إلى المقدّمة، وزيادة امتيازاتها، وإساءة استخدام تفاعل المستخدم. تم فرض قيود على عمليات تشغيل الأنشطة في الخلفية منذ الإصدار Android 10 (المستوى 29 من واجهة برمجة التطبيقات).

تغييرات أخرى

• تغيير إعدادات PendingIntent لصنّاع المحتوى إلى حظر عمليات إطلاق نشاط الخلفية تلقائيًا ويساعد ذلك في منع التطبيقات من إنشاء PendingIntent عن طريق الخطأ، ما قد يؤدي إلى إساءة استخدامها من قِبل الجهات المسيئة.
• لا تعرض تطبيقًا في المقدّمة ما لم يسمح بذلك مرسل PendingIntent. يهدف هذا التغيير إلى منع التطبيقات الضارة من إساءة استخدام إمكانية بدء الأنشطة في الخلفية. بشكلٍ تلقائي، لا يُسمح للتطبيقات بنقل حزمة المهام إلى المقدّمة إلا إذا سمح المنشئ بأذونات تشغيل الأنشطة في الخلفية أو إذا كان لدى المرسِل أذونات تشغيل الأنشطة في الخلفية.
• التحكّم في كيفية إنهاء النشاط الأعلى في حزمة المهام إذا أنهى النشاط العلوي مهمة، سيعود نظام التشغيل Android إلى المهمة التي كانت نشطة آخر مرة. بالإضافة إلى ذلك، إذا أنهى نشاط غير نشط في المقدّمة مهمته، سيعود نظام التشغيل Android إلى الشاشة الرئيسية، ولن يحظر إنهاء هذا النشاط.
• منع تشغيل أنشطة عشوائية من تطبيقات أخرى في مهمتك يمنع هذا التغيير التطبيقات الضارة من خداع المستخدمين من خلال إنشاء أنشطة تبدو وكأنّها من تطبيقات أخرى.
• حظر النوافذ غير المرئية من أن يتم أخذها في الاعتبار عند تشغيل التطبيقات في الخلفية يساعد ذلك في منع التطبيقات الضارة من إساءة استخدام عمليات تشغيل الأنشطة في الخلفية لعرض محتوى غير مرغوب فيه أو ضار للمستخدمين.

أهداف أكثر أمانًا

يقدّم نظام التشغيل 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 بعض التغييرات التي تهدف إلى توفير تجربة مستخدم أكثر اتساقًا وسهولة.

تغييرات في Window inset

هناك تغييران مرتبطان بزوايا النافذة في Android 15: يتم تطبيق التمويه من الحافة إلى الحافة تلقائيًا، وهناك أيضًا تغييرات في الإعدادات، مثل الإعدادات التلقائية لأشرطة النظام.

全面实施政策

يتم عرض التطبيقات حتى حافة الشاشة تلقائيًا على الأجهزة التي تعمل بنظام التشغيل Android 15 إذا كان التطبيق يستهدف الإصدار 15 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 35).

ملاحظة مهمة: إذا لم يكن تطبيقك يعرض المحتوى على كامل الشاشة، قد يتم حجب أجزاء منه، وعليك التعامل مع المساحات المتروكة. اعتمادًا على التطبيق، قد يكون هذا العمل مهمًا أو لا. يمكن أن يقلّل مكوّن Material 3 Scaffold من العمل المطلوب للتوافق مع فرض ميزة "العرض على كامل الشاشة" في Android 15.

تطبيق يستهدف Android 14 ولا يتم عرضه حتى حافة الشاشة على جهاز Android 15.

تطبيق يستهدف الإصدار 15 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 35) ويعمل بوضع ملء الشاشة على جهاز Android 15. يستخدم هذا التطبيق في الغالب مكوّنات Material 3 Compose التي تطبّق المساحات المتروكة تلقائيًا. لا تتأثر هذه الشاشة سلبًا بفرض استخدام ميزة "العرض حتى حافة الشاشة" في Android 15.

هذا تغيير قد يؤدي إلى عطل ويؤثر سلبًا في واجهة مستخدم تطبيقك. تؤثر التغييرات في أقسام واجهة المستخدم التالية:

• شريط التنقّل بمقبض الإيماءات
  • يكون شفافًا بشكل تلقائي.
  • تم إيقاف الإزاحة السفلية، لذا يتم عرض المحتوى خلف شريط التنقّل في النظام ما لم يتم تطبيق الإزاحات.
  • تم إيقاف setNavigationBarColor وR.attr#navigationBarColor نهائيًا، ولا يؤثران في التنقّل بالإيماءات.
  • لا يزال setNavigationBarContrastEnforced وR.attr#navigationBarContrastEnforced لا يؤثران في التنقّل بالإيماءات.
• التنقُّل باستخدام ثلاثة أزرار
  • يتم ضبط مستوى التعتيم على% 80 تلقائيًا، مع احتمال تطابق اللون مع خلفية النافذة.
  • تم إيقاف الإزاحة السفلية لكي يتم عرض المحتوى خلف شريط التنقّل في النظام ما لم يتم تطبيق الإزاحات.
  • يتم ضبط setNavigationBarColor وR.attr#navigationBarColor لمطابقة خلفية النافذة تلقائيًا. يجب أن تكون خلفية النافذة لونًا قابلاً للرسم ليتم تطبيق هذا الإعداد التلقائي. تم إيقاف واجهة برمجة التطبيقات هذه نهائيًا، ولكنّها لا تزال تؤثر في ميزة التنقّل باستخدام 3 أزرار.
  • 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.

تطبيق يستهدف Android 14 ولا يتم عرضه حتى حافة الشاشة على جهاز Android 15.

تطبيق يستهدف الإصدار 15 من نظام التشغيل Android (المستوى 35 من واجهة برمجة التطبيقات) ويتم عرضه بملء الشاشة على جهاز يعمل بالإصدار 15 من نظام التشغيل Android ومع ذلك، يتم الآن إخفاء العديد من العناصر بواسطة شريط الحالة أو شريط التنقّل المكوّن من 3 أزرار أو الصورة المقطوعة للشاشة بسبب إجراءات التنفيذ المتعلّقة بميزة "العرض حتى حافة الشاشة" في Android 15. وتشمل واجهة المستخدم المخفية شريط التطبيقات العلوي وأزرار الإجراءات الرئيسية وعناصر القائمة في Material 2.

تطبيق يستهدف الإصدار 15 من نظام التشغيل Android (المستوى 35 لواجهة برمجة التطبيقات) ويتم عرضه بملء الشاشة على جهاز يعمل بنظام التشغيل Android 15 ويطبّق قياسات داخلية لكي لا يتم إخفاء واجهة المستخدم.

ما يجب التحقّق منه إذا كان تطبيقك يعرض المحتوى على كامل الشاشة

إذا كان تطبيقك يعرض المحتوى من حافة الشاشة إلى حافتها ويطبّق قياسات داخلية، لن يتأثر في الغالب، باستثناء الحالات التالية. ومع ذلك، حتى إذا كنت تعتقد أنّك غير متأثر، ننصحك باختبار تطبيقك.

• لديك نافذة غير عائمة، مثل Activity تستخدم SHORT_EDGES أو NEVER أو DEFAULT بدلاً من LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS. إذا تعطّل تطبيقك عند تشغيله، قد يكون ذلك بسبب شاشة البداية. يمكنك ترقية تبعية core splashscreen إلى الإصدار 1.2.0-alpha01 أو إصدار أحدث أو ضبط window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always.
• قد تكون هناك شاشات ذات عدد زيارات أقل مع واجهة مستخدم محجوبة. تأكَّد من أنّ هذه الشاشات التي يقلّ عدد زياراتها لا تحتوي على واجهة مستخدم محجوبة. تشمل الشاشات التي تسجّل عددًا أقل من الزيارات ما يلي:
  • شاشات الإعداد أو تسجيل الدخول
  • صفحات الإعدادات

ما يجب التحقّق منه إذا لم يكن تطبيقك يعرض المحتوى على كامل الشاشة

إذا لم يكن تطبيقك يعرض المحتوى على كامل الشاشة، فمن المرجّح أن يتأثر بهذا التغيير. بالإضافة إلى سيناريوهات التطبيقات التي تم تفعيل ميزة "العرض على كامل الشاشة" فيها، يجب مراعاة ما يلي:

• إذا كان تطبيقك يستخدم مكوّنات Material 3 ‏( androidx.compose.material3) في Compose، مثل TopAppBar وBottomAppBar وNavigationBar، من المرجّح ألا تتأثر هذه المكوّنات لأنّها تتعامل مع الأجزاء تلقائيًا.
• إذا كان تطبيقك يستخدم مكوّنات Material 2 ( androidx.compose.material) في Compose، لا تتعامل هذه المكوّنات تلقائيًا مع الأجزاء المقتطعة. ومع ذلك، يمكنك الوصول إلى المجموعات وتطبيقها يدويًا. في androidx.compose.material 1.6.0 والإصدارات الأحدث، استخدِم المَعلمة windowInsets لتطبيق المساحات المتروكة يدويًا لكل من BottomAppBar وTopAppBar وBottomNavigation وNavigationRail. وبالمثل، استخدِم المَعلمة contentWindowInsets من أجل Scaffold.
• إذا كان تطبيقك يستخدم طرق العرض ومكوّنات Material (com.google.android.material)، فإنّ معظم مكوّنات Material المستندة إلى طرق العرض، مثل BottomNavigationView أو BottomAppBar أو NavigationRailView أو NavigationView، تتعامل مع العناصر المضمّنة ولا تتطلّب أي عمل إضافي. ومع ذلك، عليك إضافة android:fitsSystemWindows="true" في حال استخدام AppBarLayout.
• بالنسبة إلى الدوال المركّبة المخصّصة، يمكنك تطبيق المساحات المتروكة يدويًا كحشو. إذا كان المحتوى الخاص بك ضمن Scaffold، يمكنك استخدام المساحات المتروكة باستخدام قيم المساحة المتروكة Scaffold. وإلا، يمكنك تطبيق المساحة المتروكة باستخدام إحدى WindowInsets.
• إذا كان تطبيقك يستخدم طرق العرض وBottomSheet أو SideSheet أو حاويات مخصّصة، يمكنك تطبيق المساحة المتروكة باستخدام ViewCompat.setOnApplyWindowInsetsListener. بالنسبة إلى RecyclerView، يمكنك تطبيق المساحة المتروكة باستخدام هذا المستمع وإضافة clipToPadding="false" أيضًا.

ما يجب التحقّق منه إذا كان تطبيقك يوفّر ميزة "الحماية في الخلفية" المخصّصة

إذا كان تطبيقك يحتاج إلى توفير حماية مخصّصة للخلفية في شريط التنقّل الذي يتضمّن 3 أزرار أو شريط الحالة، يجب أن يضع تطبيقك دالة مركّبة أو طريقة عرض خلف شريط النظام باستخدام WindowInsets.Type#tappableElement() للحصول على ارتفاع شريط التنقّل الذي يتضمّن 3 أزرار أو WindowInsets.Type#statusBars.

مراجع إضافية حول ميزة "العرض على كامل الشاشة"

يمكنك الاطّلاع على دليلَي طرق العرض من الحافة إلى الحافة وميزة "الإنشاء من الحافة إلى الحافة" لمزيد من المعلومات حول تطبيق الإطارات الداخلية.

واجهات برمجة التطبيقات المتوقّفة نهائيًا

تم إيقاف واجهات برمجة التطبيقات التالية نهائيًا ولكن لم يتم إيقافها:

• 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

稳定配置

إذا كان تطبيقك يستهدف الإصدار 15 من نظام التشغيل Android (المستوى 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 تلقائيًا على true

بالنسبة إلى التطبيقات التي تستهدف الإصدار 15 من نظام التشغيل Android (المستوى 35 لواجهة برمجة التطبيقات)، تصبح سمة elegantTextHeight TextView true تلقائيًا، ما يؤدي إلى استبدال الخط المكثّف المستخدَم تلقائيًا ببعض النصوص البرمجية التي تحتوي على مقاييس عمودية كبيرة بخط يسهل قراءته. تم طرح الخط المكثّف لمنع حدوث مشاكل في التنسيقات. يمنع نظام التشغيل Android 13 (المستوى 33 من واجهة برمجة التطبيقات) حدوث العديد من هذه المشاكل من خلال السماح لتنسيق النص بشدّ الارتفاع العمودي باستخدام السمة fallbackLineSpacing .

في Android 15، سيظل الخط المكثّف متوفّرًا في النظام، لذا يمكن لتطبيقك ضبط elegantTextHeight على false للحصول على السلوك نفسه كما في السابق، ولكن من المرجّح عدم توفّره في الإصدارات القادمة. لذلك، إذا كان تطبيقك متوافقًا مع النصوص البرمجية التالية: العربية أو البورمية أو التايلاندية أو التاميل أو الغوجاراتية أو الكجراتية أو الماليالامية أو الأوديا أو التيلوغوية أو اللاوية، يمكنك اختبار تطبيقك من خلال ضبط القيمة elegantTextHeight على true.

سلوك elegantTextHeight للتطبيقات التي تستهدف الإصدار 14 من نظام التشغيل Android (المستوى 34 لواجهة برمجة التطبيقات) والإصدارات الأقدم

سلوك elegantTextHeight للتطبيقات التي تستهدف الإصدار Android 15

تغييرات في عرض TextView لأشكال الحروف المعقّدة

في الإصدارات السابقة من Android، قد ترسم بعض الخطوط المكتوبة بخط اليد أو اللغات التي تتضمن أشكالًا معقّدةً الأحرف في منطقة الحرف السابق أو التالي. في بعض الحالات، تم اقتطاع هذه الأحرف في موضع البداية أو النهاية. بدءًا من Android 15، يخصّص TextView عرضًا لرسم مساحة كافية لهذه الأحرف ويسمح للتطبيقات بطلب مساحات إضافية على يمين الحرف لمنع اقتصاصه.

وبما أنّ هذا التغيير يؤثر في كيفية تحديد TextView للعرض، TextView يحدّد عرضًا أكبر تلقائيًا إذا كان التطبيق يستهدف الإصدار 15 من نظام التشغيل Android (المستوى 35 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث. يمكنك تفعيل هذا السلوك أو إيقافه من خلال طلب بيانات من واجهة برمجة التطبيقات setUseBoundsForWidth على TextView.

بما أنّ إضافة مساحة متروكة على يمين العنصر قد تؤدي إلى عدم محاذاة التنسيقات الحالية، لا تتم إضافة المساحة المتروكة تلقائيًا حتى للتطبيقات التي تستهدف الإصدار 15 من نظام التشغيل Android أو الإصدارات الأحدث. ومع ذلك، يمكنك إضافة مساحة متروكة إضافية لمنع الاقتصاص من خلال استدعاء 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

在较低版本的 Android 中，文本布局会拉伸文本的高度，以满足与当前语言区域匹配的字体的行高。例如，如果内容是日语，由于日语字体的行高略高于拉丁字体，因此文本的高度会略高。不过，尽管行高存在这些差异，但无论使用的是哪种语言区域，EditText 元素的大小都是统一的，如下图所示：

三个框，表示可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 文本的 EditText 元素。EditText 的高度相同，即使这些语言的行高各不相同。

对于以 Android 15（API 级别 35）为目标平台的应用，现在为 EditText 预留了最小行高，以匹配指定语言区域的参考字体，如下图所示：

三个框，表示可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 文本的 EditText 元素。EditText 的高度现在包含足够的空间来容纳这些语言字体的默认行高。

如有需要，您的应用可以将 useLocalePreferredLineHeightForMinimum 属性指定为 false，以恢复之前的行为；您的应用还可以在 Kotlin 和 Java 中使用 setMinimumFontMetrics API 设置自定义最小垂直指标。

الكاميرا والوسائط

يُجري Android 15 التغييرات التالية على سلوك الكاميرا والوسائط في التطبيقات التي تستهدف Android 15 أو الإصدارات الأحدث.

القيود المفروضة على طلب التركيز على الصوت

يجب أن تكون التطبيقات التي تستهدف الإصدار 15 من نظام التشغيل Android (المستوى 35 لواجهة برمجة التطبيقات) هي التطبيق الأهم أو أن تعمل بخدمة في المقدّمة من أجل طلب تركيز الصوت. إذا حاول أحد التطبيقات طلب التركيز عندما لا يستوفي أحد هذه المتطلبات، يعرض الإجراء AUDIOFOCUS_REQUEST_FAILED.

يمكنك الاطّلاع على مزيد من المعلومات حول ميزة "تركيز الصوت" في مقالة إدارة ميزة "تركيز الصوت".

تعديل القيود المفروضة على الواجهات غير المضمّنة في حزمة تطوير البرامج (SDK)

يتضمّن Android 15 قوائم معدَّلة للواجهات المحظورة غير المضمَّنة في حزمة تطوير البرامج (SDK) استنادًا إلى التعاون مع مطوّري برامج Android وأحدث الاختبارات الداخلية. نحرص على توفير بدائل عامة قبل فرض قيود على الواجهات غير المتوفّرة في حزمة SDK كلما أمكن ذلك.

إذا كان تطبيقك لا يستهدف الإصدار 15 من نظام التشغيل Android، قد لا تؤثر بعض هذه التغييرات فيك على الفور. ومع ذلك، على الرغم من إمكانية وصول تطبيقك إلى بعض الواجهات غير المضمّنة في حزمة تطوير البرامج (SDK) وفقًا لمستوى واجهة برمجة التطبيقات المستهدَف في تطبيقك، فإنّ استخدام أي طريقة أو حقل غير مضمّن في حزمة تطوير البرامج (SDK) ينطوي دائمًا على مخاطر عالية قد تؤدي إلى تعطُّل تطبيقك.

إذا لم تكن متأكدًا مما إذا كان تطبيقك يستخدم واجهات غير متوفّرة في حزمة SDK، يمكنك اختبار تطبيقك لمعرفة ذلك. إذا كان تطبيقك يعتمد على واجهات غير تابعة لحزمة تطوير البرامج (SDK)، عليك البدء في التخطيط لنقل البيانات إلى بدائل حزمة تطوير البرامج (SDK). ومع ذلك، ندرك أنّ بعض التطبيقات لديها حالات استخدام صالحة لاستخدام واجهات غير تابعة لحزمة تطوير البرامج (SDK). إذا لم تتمكّن من العثور على بديل لاستخدام واجهة لا تتبع حزمة تطوير البرامج (SDK) لإحدى الميزات في تطبيقك، عليك طلب واجهة برمجة تطبيقات عامة جديدة.

لمزيد من المعلومات عن التغييرات في هذا الإصدار من Android، اطّلِع على التعديلات على قيود واجهات غير حزمة SDK في Android 15. للاطّلاع على مزيد من المعلومات حول الواجهات غير المتوفّرة في حزمة SDK بشكل عام، اطّلِع على مقالة القيود المفروضة على الواجهات غير المتوفّرة في حزمة SDK.