يتضمّن نظام Android 17 الأساسي تغييرات في السلوك قد تؤثّر في تطبيقك.
تنطبق تغييرات السلوك التالية على جميع التطبيقات عند تشغيلها على Android 17،
بغض النظر عن targetSdkVersion. عليك اختبار تطبيقك ثم تعديله حسب الحاجة ليتوافق مع هذه التغييرات، حيثما ينطبق ذلك.
يُرجى أيضًا مراجعة قائمة التغييرات في السلوك التي تؤثر فقط في التطبيقات التي تستهدف Android 17.
الوظيفة الأساسية
يتضمّن Android 17 (المستوى 37 لواجهة برمجة التطبيقات) التغييرات التالية التي تعدّل أو توسّع إمكانات أساسية متنوّعة في نظام Android.
الحدود القصوى لذاكرة التطبيقات
Android 17 引入了基于设备 RAM 总容量的应用内存限制,旨在为应用和 Android 用户打造更稳定、更确定的环境。这些限制侧重于在内存泄漏和其他异常值触发系统级不稳定(导致界面卡顿、耗电量增加和应用被终止)之前,对其进行检测。虽然我们预计对绝大多数应用会话的影响微乎其微,但我们建议您遵循以下内存最佳实践,包括建立内存基准。
您可以通过在 ApplicationExitInfo 中调用 getDescription 来确定应用会话是否受到影响;如果应用受到影响,退出原因将为 REASON_OTHER,说明将包含字符串 "MemoryLimiter:AnonSwap" 以及其他信息。您还可以将基于触发器的性能分析与 TRIGGER_TYPE_ANOMALY 搭配使用,以获取在达到内存限制时收集的堆转储。
管理应用的内存文档提供了相关信息,可帮助您诊断应用的内存问题并优化其资源消耗。
测试应用在内存限制下的行为
您可以使用 Android 调试桥 (adb) 调整或停用任何设备上的内存限制。shell 命令 am 提供了三个子命令来调整内存限制。(这些命令对不施加内存限制的设备没有影响。)
am memory-limiter ignore <uid>|none|allam memory-limiter manual <pid> <limit>|max|noneam memory-limiter status
ignore指示内存限制器忽略部分或全部进程。 传递 UID(Android 用户 ID)会指示内存限制器忽略对与该 UID 关联的所有进程的强制执行。您还可以传递
all(忽略所有应用)或none(不忽略任何应用)。 传递none会覆盖之前对am memory-limiter ignore的任何调用。如果您指示内存限制器忽略某个 UID,您仍然可以通过调用
am memory-limiter manual,对应用内的进程应用手动内存限制。manual指示系统对具有指定 PID(进程 ID)的进程施加内存限制。内存限制指定为整数 MB;例如,传递
30指定进程限制为 30 MB 内存。传递max会移除该进程的所有内存限制。 传递none会移除对进程设置的所有手动限制,从而恢复系统的默认限制(如果有)。status报告内存限制器的当前状态。该状态包括对可见和不可见进程施加的内存限制。
الخصوصية
يتضمّن Android 17 التغييرات التالية لتحسين خصوصية المستخدم.
الحماية من خلال كلمة المرور الصالحة لمرة واحدة (OTP) عبر الرسائل القصيرة
اعتبارًا من الإصدار 17 من نظام التشغيل Android، سيتم توسيع نطاق حماية الرسائل القصيرة التي تحتوي على كلمات مرور صالحة لمرة واحدة (OTP).
في الإصدارات السابقة من Android، كانت هذه الحماية تركّز بشكل أساسي على تنسيق SMS Retriever. تأخّر تسليم الرسائل التي تحتوي على رمز تجزئة لاسترداد الرسائل القصيرة (SMS) لمعظم التطبيقات لمدة ثلاث ساعات. ومع ذلك، تم استثناء بعض التطبيقات (مثل معالج الرسائل القصيرة التلقائي) من التأخير، كما تم استثناء التطبيق الذي يمتلك التجزئة.
بدءًا من الإصدار Android 17، يتم تطبيق الحماية أيضًا على الرسائل بتنسيق WebOTP. إذا كان التطبيق يملك إذنًا بقراءة رسائل SMS ولكنّه ليس المستلِم المقصود لرسالة WebOTP (كما هو محدّد من خلال عملية التحقّق من النطاق)، لن يتمكّن التطبيق من الوصول إلى الرسالة إلا بعد مرور ثلاث ساعات على استلامها. يهدف هذا التغيير إلى تحسين أمان المستخدم من خلال ضمان أنّ التطبيقات المرتبطة بالنطاق المذكور في الرسالة هي فقط التي يمكنها قراءة رمز التحقّق آليًا.
خلال فترة التأخير هذه التي تبلغ ثلاث ساعات، يتم حجب بث SMS_RECEIVED_ACTION وتتم تصفية طلبات البحث في قاعدة بيانات مقدّم خدمة الرسائل القصيرة. وتكون الرسالة القصيرة SMS متاحة لهذه التطبيقات بعد التأخير. ينطبق هذا التغيير على
جميع التطبيقات، بغض النظر عن مستوى واجهة برمجة التطبيقات المستهدف.
يُستثنى من هذا التأخير بعض التطبيقات، مثل تطبيق المساعد التلقائي للرسائل القصيرة والتطبيقات المصاحبة للأجهزة المتصلة وما إلى ذلك. يجب أن تنتقل جميع التطبيقات التي تعتمد على قراءة رسائل SMS لاستخراج كلمات المرور الصالحة لمرة واحدة إلى استخدام واجهات برمجة التطبيقات SMS Retriever أو SMS User Consent لضمان استمرار عملها.
الأمان
يتضمّن Android 17 التحسينات التالية على مستوى أمان الجهاز والتطبيقات.
خطة إيقاف usesClearTraffic نهائيًا
في إصدار مستقبلي، نخطّط لإيقاف العنصر usesCleartextTraffic نهائيًا.
يجب أن تنتقل التطبيقات التي تحتاج إلى إجراء اتصالات غير مشفّرة (HTTP) إلى
استخدام ملف إعدادات أمان الشبكة، والذي يتيح لك
تحديد النطاقات التي يحتاج تطبيقك إلى إجراء اتصالات نصية واضحة بها.
يُرجى العِلم أنّ ملفات إعدادات أمان الشبكة لا تتوفّر إلا في المستويات 24 والإصدارات الأحدث من واجهة برمجة التطبيقات. إذا كان الحد الأدنى لمستوى واجهة برمجة التطبيقات في تطبيقك أقل من 24، عليك تنفيذ كلا الإجراءين التاليين:
- اضبط السمة
usesCleartextTrafficعلىtrue - استخدام ملف إعدادات الشبكة
إذا كان الحد الأدنى لمستوى واجهة برمجة التطبيقات في تطبيقك هو 24 أو أعلى، يمكنك استخدام ملف إعداد الشبكة ولن تحتاج إلى ضبط usesCleartextTraffic.
تقييد أذونات معرّفات الموارد المنتظمة (URI) الضمنية
目前,如果应用启动具有操作 ACTION_SEND、ACTION_SEND_MULTIPLE 或 ACTION_IMAGE_CAPTURE 的 URI 的 intent,系统会自动向目标应用授予读取和写入 URI 权限。从 Android 18 开始,系统将不再自动授予这些权限。因此,我们建议应用明确授予相关 URI 权限,而不是依赖系统来授予这些权限。
如需检测应用中这些 intent 的使用情况,请将 StrictMode 与 detectImplicitUriPermissionGrant() 搭配使用,以触发违规行为:
Kotlin
val policy = StrictMode.VmPolicy.Builder() .detectImplicitUriPermissionGrant() .penaltyLog() .build() StrictMode.setVmPolicy(policy)
Java
StrictMode.VmPolicy policy = new StrictMode.VmPolicy.Builder() .detectImplicitUriPermissionGrant() .penaltyLog() .build(); StrictMode.setVmPolicy(policy);
或者,您也可以监控记录的异常,其中包含系统隐式设置授权时显示的消息 Please set the grant explicitly in the app。您可以使用以下 adb 命令监控这些日志:
adb logcat | grep "Please set the grant explicitly in the app"
如需明确授予必要的权限,请将 FLAG_GRANT_READ_URI_PERMISSION 标志添加到 ACTION_SEND 和 ACTION_SEND_MULTIPLE intent:
Kotlin
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
Java
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
为 ACTION_IMAGE_CAPTURE intent 添加 FLAG_GRANT_READ_URI_PERMISSION 和 FLAG_GRANT_WRITE_URI_PERMISSION 标志:
Kotlin
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION)
Java
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
الحدود القصوى لمخزن مفاتيح التشفير لكل تطبيق
يجب أن تتجنّب التطبيقات إنشاء أعداد زائدة من المفاتيح في Android Keystore، لأنّه مورد مشترَك لجميع التطبيقات على الجهاز. بدءًا من الإصدار 17 من نظام التشغيل Android، يفرض النظام حدًا أقصى لعدد المفاتيح التي يمكن أن يمتلكها التطبيق. الحدّ الأقصى هو 50,000 مفتاح للتطبيقات غير التابعة للنظام والتي تستهدف الإصدار 17 من نظام التشغيل Android (المستوى 37 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث، و200,000 مفتاح لجميع التطبيقات الأخرى. يبلغ الحد الأقصى لعدد المفاتيح في تطبيقات النظام 200,000 مفتاح، بغض النظر عن مستوى واجهة برمجة التطبيقات الذي تستهدفه.
إذا حاول أحد التطبيقات إنشاء مفاتيح تتجاوز الحدّ الأقصى، سيتعذّر إنشاؤها وسيظهر الخطأ
KeyStoreException. تحتوي سلسلة رسائل الاستثناء على معلومات
حول الحد الأقصى للمفاتيح. إذا استدعى التطبيق getNumericErrorCode() في الاستثناء، تعتمد القيمة المعروضة على مستوى واجهة برمجة التطبيقات الذي يستهدفه التطبيق:
- بالنسبة إلى التطبيقات التي تستهدف الإصدار 17 من نظام التشغيل Android (المستوى 37 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث:
تعرض السمة
getNumericErrorCode()القيمة الجديدة لـERROR_TOO_MANY_KEYS. - جميع التطبيقات الأخرى: تعرض السمة
getNumericErrorCode()القيمةERROR_INCORRECT_USAGE.
حظر حركة البيانات في الاسترجاع بين الملفات الشخصية
اعتبارًا من الإصدار Android 17، لن يُسمح تلقائيًا بمرور البيانات عبر الاسترجاع بين الملفات الشخصية. ولا تتأثر حركة مرور الاسترجاع ضمن الملف الشخصي نفسه. ينطبق هذا التغيير على جميع التطبيقات التي تعمل بنظام التشغيل Android 17 أو الإصدارات الأحدث، بغض النظر عن مستوى واجهة برمجة التطبيقات الذي يستهدفه التطبيق.
تجربة المستخدم وواجهة مستخدم النظام
يتضمّن Android 17 التغييرات التالية التي تهدف إلى توفير تجربة مستخدم أكثر اتساقًا وسهولة.
استعادة مستوى الرؤية التلقائي لـ IME بعد التدوير
بدءًا من الإصدار 17 من نظام التشغيل Android، عندما تتغيّر إعدادات الجهاز (على سبيل المثال، من خلال التدوير)، ولا يتعامل التطبيق نفسه مع هذا التغيير، لا تتم استعادة مستوى رؤية أداة تحرير أسلوب الإدخال (IME) السابق.
إذا خضع تطبيقك لتغيير في الإعدادات لا يتعامل معه، وكان التطبيق يحتاج إلى ظهور لوحة المفاتيح بعد التغيير، يجب طلب ذلك صراحةً. يمكنك تقديم هذا الطلب بإحدى الطرق التالية:
- اضبط السمة
android:windowSoftInputModeعلىstateAlwaysVisible. - اطلب لوحة المفاتيح الافتراضية آليًا في إجراء
onCreate()الخاص بنشاطك، أو أضِف الإجراءonConfigurationChanged().
المعلومات المقدَّمة
يتضمّن Android 17 التغييرات التالية التي تؤثّر في كيفية تفاعل التطبيقات مع أجهزة الإدخال البشري، مثل لوحات المفاتيح ولوحات اللمس.
توفّر لوحات اللمس أحداثًا نسبية تلقائيًا أثناء التقاط المؤشر
بدءًا من الإصدار 17 من نظام التشغيل Android، إذا طلب أحد التطبيقات التقاط المؤشر باستخدام
View.requestPointerCapture() واستخدم المستخدم لوحة لمس، يتعرّف النظام على حركة المؤشر وإيماءات التمرير من لمسات المستخدم ويُبلغ التطبيق بها بالطريقة نفسها التي يتم بها الإبلاغ عن حركات المؤشر وعجلة التمرير من الماوس الذي تم التقاطه. في معظم الحالات، يغني ذلك التطبيقات التي تتيح استخدام الماوس عن إضافة منطق معالجة خاص للوحات اللمس. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات View.POINTER_CAPTURE_MODE_RELATIVE.
في السابق، لم يكن النظام يحاول التعرّف على الإيماءات من لوحة اللمس،
بل كان يرسل المواقع الجغرافية الأولية والمطلقة للأصابع إلى التطبيق بتنسيق مشابه
للمسات الشاشة التي تعمل باللمس. إذا كان التطبيق لا يزال يتطلّب هذه البيانات المطلقة، يجب أن يستدعي طريقة View.requestPointerCapture(int) الجديدة باستخدام View.POINTER_CAPTURE_MODE_ABSOLUTE بدلاً من ذلك.
الوسائط
يتضمّن Android 17 التغييرات التالية في سلوك الوسائط.
تعزيز أمان الصوت في الخلفية
اعتبارًا من الإصدار 17 من نظام التشغيل Android، يفرض إطار عمل الصوت قيودًا على التفاعلات الصوتية في الخلفية، بما في ذلك تشغيل الصوت وطلبات التركيز على الصوت وواجهات برمجة التطبيقات لتغيير مستوى الصوت، وذلك لضمان بدء هذه التغييرات عن قصد من قِبل المستخدم.
إذا حاول التطبيق طلب واجهات برمجة تطبيقات الصوت عندما لا يكون التطبيق في دورة حياة صالحة،
ستتعذّر واجهات برمجة تطبيقات تشغيل الصوت وتغيير مستوى الصوت بدون إرسال
استثناء أو تقديم رسالة تعذُّر. تعذّر تنفيذ واجهة برمجة التطبيقات الخاصة بالتركيز على الصوت وظهر رمز النتيجة AUDIOFOCUS_REQUEST_FAILED.
لمزيد من المعلومات، بما في ذلك استراتيجيات التخفيف من آثار هذه المشكلة، يُرجى الاطّلاع على تعزيز أمان الصوت في الخلفية.
إمكانية الاتصال
يتضمّن Android 17 التغييرات التالية لتحسين إمكانية اتصال الجهاز بالشبكة.
بدء إعادة الإقران بشكل مستقل في حال فقدان اتصال البلوتوث
يقدّم Android 17 ميزة إعادة الإقران المستقلة، وهي تحسين على مستوى النظام مصمّم لحلّ مشكلة فقدان اتصال البلوتوث تلقائيًا.
في السابق، إذا تم فقدان عملية الربط، كان على المستخدمين الانتقال يدويًا إلى "الإعدادات" لإلغاء إقران الجهاز الملحق ثم إعادة إقرانه. تستند هذه الميزة إلى تحسينات الأمان في Android 16 من خلال السماح للنظام بإعادة إنشاء عمليات الربط بعد الحصول على موافقة المستخدم. ويؤدي ذلك إلى عدم اضطرار المستخدمين إلى الانتقال يدويًا إلى "الإعدادات" لإلغاء إقران الأجهزة الملحقة وإعادة إقرانها.
على الرغم من أنّ معظم التطبيقات لن تتطلّب إجراء تغييرات على الرموز البرمجية، يجب أن يكون المطوّرون على دراية بالتغييرات التالية في سلوك حزمة Bluetooth:
- سياق إقران جديد: يتضمّن
ACTION_PAIRING_REQUESTالآنEXTRA_PAIRING_CONTEXTالإضافي الذي يسمح للتطبيقات بالتمييز بين طلب الإقران العادي ومحاولة إعادة الإقران التي يبدأها النظام بشكل مستقل. - تحديثات المفاتيح المشروطة: لن يتم استبدال مفاتيح الأمان الحالية إلا إذا تمت إعادة الإقران بنجاح وكان الاتصال الجديد يستوفي مستوى الأمان للارتباط السابق أو يتجاوزه.
- تعديل توقيت الإجراء: يتم الآن بث الإجراء
ACTION_KEY_MISSINGفقط في حال تعذُّر محاولة إعادة الإقران المستقلة. ويقلّل ذلك من معالجة الأخطاء غير الضرورية في التطبيق إذا نجح النظام في استعادة الربط في الخلفية. - إشعار المستخدم: يدير النظام عملية إعادة الإقران من خلال إشعارات ومربّعات حوار جديدة في واجهة المستخدم. سيُطلب من المستخدمين تأكيد محاولة إعادة الإقران لضمان علمهم بإعادة الاتصال.
على الشركات المصنّعة للأجهزة الملحقة ومطوّري التطبيقات المصاحبة التأكّد من أنّ الأجهزة والتطبيقات تتعامل بسلاسة مع عمليات الربط. لاختبار هذا السلوك، يمكنك محاكاة فقدان الاتصال عن بُعد باستخدام إحدى الطريقتَين التاليتَين:
- إزالة معلومات الربط يدويًا من الجهاز الملحق
- إلغاء إقران الجهاز يدويًا من خلال: الإعدادات > الأجهزة المتصلة