تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تغييرات إطار عمل التوافق (Android 11)

تصف هذه الصفحة كل تغيير في السلوك يؤثر في التطبيق تمت إضافته إلى إطار عمل التوافق في Android 11 (المستوى 30 من واجهة برمجة التطبيقات). استخدِم هذه القائمة إلى جانب خيارات المطوّرين وأوامر ADB لاختبار تطبيقك وتصحيح الأخطاء فيه أثناء الاستعداد لاستهداف Android 11.

ADD_CONTENT_OBSERVER_FLAGS

رقم تعريف التغيير: 150939131

الحالة التلقائية: مفعَّلة للتطبيقات التي تستهدف Android 11 (المستوى 30 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.

في التطبيقات التي تستهدف Android 11، هناك تحميل زائد جديد لواجهة برمجة التطبيقات onChange(boolean, Uri, int) يتضمّن وسيطة flags بعدد صحيح.

هذه الطريقة الجديدة هي بديل متاح للجميع لحزمة تطوير البرامج (SDK) للتطبيقات التي تستخدم طريقة التحميل الزائد onChange() غير المضمَّنة في حزمة SDK التي تتضمّن وسيطة userId بعدد صحيح.

ADMIN_APP_password_COMPLEXITY

رقم تعريف التغيير: 123562444

بالنسبة إلى تطبيقات المشرف التي تستهدف Android 11، تعرض رسالة خطأ عندما يضبط تطبيق متطلب كلمة مرور لا صلة له بجودة كلمة المرور المحددة حاليًا. على سبيل المثال، عند ضبط جودة كلمة المرور على DevicePolicyManager.PASSWORD_QUALITY_UNSPECIFIED، لن يتمكّن التطبيق من ضبط حدّ أدنى لطول كلمة المرور. في هذه الحالة، قبل محاولة ضبط الحدّ الأدنى لطول كلمة المرور، يجب أن يستدعي التطبيق أولاً الطريقة setPasswordQuality() ثم يستدعي الطريقة setPasswordMinimumLength() فقط.

بالإضافة إلى ذلك، عندما يؤدي تطبيق مشرف يستهدف الإصدار 11 من نظام التشغيل Android إلى خفض جودة كلمة المرور، تتم إعادة ضبط أي متطلبات حالية لكلمة المرور لم تعد سارية على القيم التلقائية.

APP_DATA_DIRECTORY_ISOLATION

رقم تعريف التغيير: 143937733

لم يعد بإمكان التطبيقات التي تستهدف الإصدار 11 من نظام التشغيل Android الوصول إلى الملفات في أدلة البيانات الخاصة لأي تطبيق، بغض النظر عن إصدار حزمة تطوير البرامج (SDK) المستهدَف للتطبيق الآخر.

لمزيد من المعلومات، راجع الوصول إلى الأدلة الخاصة.

APN_READING_Permission_CHANGE_ID

رقم تعريف التغيير: 124107808

بالنسبة إلى التطبيقات التي تستهدف Android 11، يجب الحصول الآن على إذن Manifest.permission.WRITE_APN_SETTINGS للوصول إلى قاعدة بيانات اسم نقطة الوصول.

لمزيد من المعلومات عن هذا التغيير، يمكنك الاطّلاع على تقييد إمكانية الوصول للقراءة إلى قاعدة بيانات APN.

BACKGROUND_RATIONALE_CHANGE_ID

رقم تعريف التغيير: 147316723

ويجب أن تقدِّم التطبيقات مبررًا صالحًا في كل مرة تطلب فيها الوصول إلى موقع الجهاز في الخلفية.

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

CALLBACK_ON_CLEAR_change

رقم تعريف التغيير: 119147584

عند استدعاء Editor.clear ، يتم الآن استدعاء OnSharedPreferenceChangeListener.onSharedPreferenceChanged باستخدام مفتاح null.

لمزيد من المعلومات حول هذا التغيير، يمكنك الاطّلاع على تغييرات معاودة الاتصال لـ OnSharedPreferenceChangeListener.

CALLBACK_ON_MORE_ERROR_CODE_CHANGE

رقم تعريف التغيير: 130595455

تم الآن توسيع رموز الخطأ لكل من updateAvailableNetworks(List, Executor, Consumer) وsetPreferredOpportunisticDataSubscription(int, boolean, Executor, Consumer).

CALL_BACK_ON_CHANGED_LISTENER_WITH_SWITCHED_OP_CHANGE

رقم تعريف التغيير: 148180766

وهذا تغيير بسيط في سلوك startWatchingMode(String, String, AppOpsManager.OnOpChangedListener). قبل هذا التغيير، دعا النظام مرة أخرى للعملية التي تم تبديلها. بعد التغيير، سيعاود النظام الاتصال للعملية المطلوبة بالفعل أو جميع العمليات التي تم تحويلها في حالة عدم تحديد أي عملية.

CAMERA_MICROPHONE_CAPCompliance_CHANGE_ID

رقم تعريف التغيير: 136219221

بالنسبة إلى التطبيقات التي تستهدف Android 11، لن تتلقّى الخدمات التي تعمل في المقدّمة إمكانيات الكاميرا والميكروفون أثناء الاستخدام إلا عند ضبط R.attr.foregroundServiceType على ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA وServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE على التوالي في ملف البيان. في الإصدارات السابقة من Android، كانت الخدمات التي تعمل في المقدّمة تتلقى تلقائيًا إمكانات الكاميرا والميكروفون.

لمزيد من المعلومات حول هذا التغيير، يمكنك الاطّلاع على أنواع الخدمات التي تعمل في المقدّمة في Android 11.

تغيير_BACKGROUND_CUSTOM_TOAST_BLOCK

رقم تعريف التغيير: 128611929

لم يعد بإمكان التطبيقات نشر إشعارات منبثقة مخصّصة في الخلفية. مع ذلك، سيظل بإمكان التطبيقات نشر إشعارات منبثقة باستخدام الطريقة Toast.makeText(Context, CharSequence, int) وخياراتها المختلفة أثناء تشغيلها في الخلفية.

لمزيد من المعلومات عن هذا التغيير، يمكنك الاطّلاع على حظر طرق العرض الموسَّعة المخصّصة.

CHANGE_RESTRICT_SAW_INTENT

رقم تعريف التغيير: 135920175

الحالة التلقائية: لا يمكن تفعيل هذا التغيير. ولا يتم تسجيله إلا من خلال إطار التوافق.

إنّ الأهداف التي تستخدم الإجراء android.settings.MANAGE_APP_OVERLAY_PERMISSION ومخطّط معرِّف الموارد المنتظم (URI) لبيانات package لم تعُد توجِّه المستخدم إلى شاشة خاصة بالتطبيق لإدارة الإذن المرتبط. بدلاً من ذلك، يتم توجيه المستخدم إلى شاشة يمكنه فيها إدارة جميع التطبيقات التي طلبت الإذن.

تغيير_TEXT_TOASTS_IN_THE_SYSTEM

رقم تعريف التغيير: 147798919

يتم الآن عرض إشعارات التنبيه النصية باستخدام SystemUI بدلاً من داخل التطبيق. ويمنع هذا التطبيقات من التحايل على القيود المفروضة على نشر إشعارات منبثقة مخصّصة في الخلفية.

DEFAULT_SCOPED_STORAGE

رقم تعريف التغيير: 149924527

الحالة التلقائية: مفعَّلة لجميع التطبيقات

تستخدم الآن جميع التطبيقات التي تستهدف Android 11 مساحة التخزين ذات النطاق تلقائيًا ولم يعد بإمكانها إيقاف مساحة التخزين ذات النطاق.

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

للتعرّف على مزيد من المعلومات حول التغييرات التي طرأت على مساحة التخزين للنطاق في Android 11، يُرجى الاطّلاع على قسم التخزين الفرعي في الصفحة حول التغييرات التي طرأت على مساحة التخزين في Android في Android 11.

EMPTY_INTENT_ACTION_CATEGORY

رقم تعريف التغيير: 151163173

بالنسبة إلى التطبيقات التي تستهدف Android 11، يعرض النظام الآن رسالة خطأ إذا كان action في فلتر الأهداف أو category عبارة عن سلسلة فارغة. كان هناك خطأ في النظام الأساسي قبل Android 11 أتاح لهذه الحالة إمكانية المرور بدون حدوث خطأ. لاحظ أن هذا لا يشمل الحالات التي تكون فيها السمة فارغة أو مفقودة، لأن ذلك يؤدي دائمًا إلى ظهور خطأ.

FILTER_APPLICATION_QUERY

رقم تعريف التغيير: 135549675

تحتاج التطبيقات الآن إلى توضيح الحِزَم والأغراض التي تنوي استخدامها قبل أن تتمكّن من الحصول على تفاصيل بشأن التطبيقات الأخرى على الجهاز. ويجب إنشاء هذه البيانات باستخدام العلامة <queries> ضمن ملف بيان التطبيق.

لمعرفة مزيد من المعلومات حول طريقة طلب البحث عن التطبيقات المثبّتة الأخرى والتفاعل معها في الإصدار 11 من نظام Android، يمكنك الاطّلاع على صفحة خصوصية إذن الوصول إلى الحزمة.

FORCE_ENABLE_SCOPED_STORAGE

رقم تعريف التغيير: القيمة: 132649864

الحالة التلقائية: غير مفعّلة لجميع التطبيقات.

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

GET_DATA_CONNECTION_state_R_VERSION

رقم تعريف التغيير: 148535736

للتحقّق من إصدار حزمة تطوير البرامج (SDK) الخاص بـ PreciseDataConnectionState#getDataConnectionState

GET_DATA_state_R_VERSION

رقم تعريف التغيير: 148534348

للتحقّق من إصدار حزمة تطوير البرامج (SDK) الخاص بـ getDataState()

عمليات الاستثناء

رقم تعريف التغيير: 150935354

بالنسبة إلى التطبيقات التي تستهدف Android 11 (المستوى 30 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث، لن يتم تطبيق أي استثناءات أمان على getProvider(String).

GET_TARGET_SDK_VERSION_CODE_ ويضمّن

رقم تعريف التغيير: 145147528

الحالة التلقائية: مفعَّلة للتطبيقات التي تستهدف Android 10 (المستوى 29 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث.

للتحقّق من إصدار حزمة تطوير البرامج (SDK) لطريقة SmsManager.sendResolverResult().

GWP_ASAN

رقم تعريف التغيير: 135634846

الحالة التلقائية: غير مفعّلة لجميع التطبيقات.

تُفعِّل هذه السياسة ميزة رصد أخطاء الذاكرة الأصلية في التطبيقات.

لمزيد من المعلومات حول هذا التغيير، يُرجى الاطّلاع على دليل GWP-ASan.

HIDE_MAXTARGETSDK_P_HIDDEN_APIS

رقم تعريف التغيير: 149997251

بالنسبة إلى التطبيقات التي تستهدف Android 10 (المستوى 29 من واجهة برمجة التطبيقات) أو الإصدارات الأحدث، ستتم إزالة إمكانية الوصول إلى جميع الواجهات التي لا تتضمّن حزمة SDK التي تشكّل جزءًا من قائمة max-target-p (greylist-max-p) لنظام التشغيل Android 10 (مستوى واجهة برمجة التطبيقات 29).

HIDE_MAXTARGETSDK_Q_HIDDEN_APIS

رقم تعريف التغيير: 149994052

بالنسبة إلى التطبيقات التي تستهدف Android 11 (المستوى 30 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث، ستتم إزالة إمكانية الوصول إلى جميع الواجهات التي لا تتضمّن حزمة SDK التي تشكّل جزءًا من قائمة max-target-q (greylist-max-q) لنظام التشغيل Android 11 (المستوى 30 لواجهة برمجة التطبيقات).

لمزيد من المعلومات عن هذا التغيير، يمكنك الاطّلاع على الواجهات التي لم يتم تثبيت حزمة تطوير البرامج (SDK) فيها والتي تم حظرها الآن في الإصدار 11 من نظام التشغيل Android.

LISTEN_CODE_change

رقم تعريف التغيير: 147600208

للتحقّق من إصدار حزمة تطوير البرامج (SDK) في TelephonyManager.listen(PhoneStateListener, int)

MISSING_APP_TAG

رقم تعريف التغيير: 150776642

بالنسبة إلى التطبيقات التي تستهدف الإصدار 11 من نظام التشغيل Android، يظهر خطأ الآن عندما لا يتضمّن ملف البيان الخاص بالتطبيق العلامة application أو instrumentation.

NATIVE_HEAP_POINTER_TAGGING

رقم تعريف التغيير: 135754954

بالنسبة إلى التطبيقات التي تستهدف الإصدار 11 من نظام التشغيل Android، تتضمّن عمليات تخصيص العناصر المُدمجة ضمن العناصر الرئيسية الآن علامة ليست صفرية في أهم وحدات البايت.

لمزيد من المعلومات، يُرجى الاطّلاع على وضع علامات مؤشر عرض لقطات لأجزاء من الذاكرة.

PHONE_state_LISTENER_LIMIT_CHANGE_ID

رقم تعريف التغيير: 150880553

الحالة التلقائية: مفعَّلة لجميع التطبيقات

بالنسبة إلى التطبيقات التي تستهدف Android 11، هناك حدّ أقصى لعدد عناصر PhoneStateListener التي يمكن أن تسجِّلها أي عملية عبر TelephonyManager.listen(PhoneStateListener, int). الحد التلقائي هو 50 تطبيقًا، ويمكن تغييره من خلال تحديثات إعدادات الجهاز البعيد. يتم فرض هذا الحدّ باستخدام IllegalStateException تم طرحه من خلال TelephonyManager.listen(PhoneStateListener, int) عندما تحاول العملية المسيئة تسجيل عدد كبير جدًا من المستمعين.

PREVENT_meta_REFLECTION_BLACKLIST_ACCESS

رقم تعريف التغيير: 142365358

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

PROCESS_CAPAUDIENCE_CHANGE_ID

رقم تعريف التغيير: 136274596

بالنسبة إلى التطبيقات التي تستهدف Android 11، يمكن الآن استخدام علامة Context.BIND_INCLUDE_CAPABILITIES لنقل الإمكانات أثناء الاستخدام من معالجة العميل إلى خدمة محدّدة.

إزالة_ANDROID_TEST_BASE

رقم تعريف التغيير: 133396946

بالنسبة إلى التطبيقات التي تستهدف Android 11، تمت إزالة مكتبة android.test.base إذا كان التطبيق لا يعتمد على android.test.runner (لأنه يعتمد على الفئات من مكتبة android.test.base).

REQUEST_ACCESSIBILITY_button_CHANGE

رقم تعريف التغيير: 136293963

بالنسبة إلى خدمات تسهيل الاستخدام التي تستهدف الإصدار 11 من نظام التشغيل Android، يجب الآن تحديد علامة FLAG_REQUEST_ACCESSIBILITY_BUTTON في ملف البيانات الوصفية لخدمات تسهيل الاستخدام. وبخلاف ذلك، يتم تجاهل العلامة.

لمزيد من المعلومات حول هذا التغيير، يُرجى الاطّلاع على توضيح استخدام زر أدوات تسهيل الاستخدام في ملف بيانات وصفية.

RIS_ARSC_COMPRESSED

رقم تعريف التغيير: 132742131

لا يمكن تثبيت التطبيقات التي تستهدف Android 11 (المستوى 30 من واجهة برمجة التطبيقات) إذا كانت تحتوي على ملف resources.arsc مضغوط أو في حال عدم محاذاة هذا الملف على حدود بحجم 4 بايت.

لمزيد من المعلومات عن هذا التغيير، يُرجى الاطّلاع على ملفات الموارد المضغوطة.

RESTRICT_STORAGE_ACCESS_frameWORK

رقم تعريف التغيير: 141600225

إذا كان تطبيقك يستهدف Android 11 ويستخدم إطار عمل الوصول إلى مساحة التخزين (SAF)، لن يعود بإمكانك الوصول إلى أدلة معيّنة باستخدام الإجراءَين ACTION_OPEN_DOCUMENT وACTION_OPEN_DOCUMENT_TREE. لمعرفة المزيد من المعلومات عن هذه التغييرات، يمكنك الاطّلاع على قسم "قيود الوصول إلى المستندات" على الصفحة التي تناقش تحديثات الخصوصية المتعلقة بالتخزين في Android 11.

SELINUX_LATEST_CHANGES

رقم تعريف التغيير: 143539591

يمنع هذا التغيير التطبيقات من الوصول إلى نطاق Trust_app_R-targetSDk SELinux. هذا هو أحد التغييرات الأساسية في إطار عمل التوافق الذي يسمح للتطبيقات بالتبديل بين التغييرات الأخرى المحمية من خلال targetSdkVersion بدون تغيير targetSDKVersion الخاصة بها. ولهذا السبب، يجب عدم إيقاف هذا التغيير في تطبيق يستهدف Android 11، وإلا لن يعمل.

لا يؤثر هذا التغيير في التطبيقات التي تستخدم رقم تعريف مستخدم مشتركًا.

عدد THROW_SECURITY_EXCEPTIONS

رقم تعريف التغيير: 147340954

في الإصدارات السابقة لنظام التشغيل Android 11، كان لا يتم عرض SecurityException إلا من خلال واجهات برمجة تطبيقات setEnabled بسبب خطأ في الإذن. أمّا في نظام التشغيل Android 11، فلم يعُد ذلك صحيحًا، ويمكن أن نتلقّى "SecurityException" لأي عدد من الأسباب، ولا يتعذّر أيّ منها بسبب عدم رصد المُتصِل.

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

USE_SET_LOCATION_PLACES

رقم تعريف التغيير: 117835097

لم يعُد بإمكان تطبيقات المشرفين التي تستهدف Android 11 استخدام DevicePolicyManager.setSecureSetting(ComponentName, String, String) لتغيير إعداد Settings.Secure.LOCATION_MODE المتوقف نهائيًا. بدلاً من ذلك، يجب استخدام DevicePolicyManager.setLocationEnabled(ComponentName, boolean).