عند تحميل حِزمة APK، يجب أن تستوفي متطلبات مستوى واجهة برمجة التطبيقات المستهدَف في Google Play.
اعتبارًا من 31 أغسطس 2025:
- يجب أن تستهدف التطبيقات الجديدة وتحديثات التطبيقات الإصدار Android 15 (المستوى 35 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث لإرسالها إلى Google Play، باستثناء تطبيقات Wear OS ونظام التشغيل Android Automotive وتطبيقات Android TV التي يجب أن تستهدف الإصدار Android 14 (المستوى 34 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث.
- يجب أن تستهدف التطبيقات الحالية الإصدار Android 14 (المستوى 34 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث لكي تبقى متاحة للمستخدمين الجُدد على الأجهزة التي تعمل بإصدار أحدث من مستوى واجهة برمجة التطبيقات المستهدف في تطبيقك. أمّا التطبيقات التي تستهدف Android 13 (المستوى 33 لواجهة برمجة التطبيقات) أو الإصدارات الأقدم، بما في ذلك Android 12 (المستوى 31 لواجهة برمجة التطبيقات) أو الإصدارات الأقدم المتوافقة مع نظامي التشغيل Wear OS وAndroid TV، فلن تكون متاحة إلا على الأجهزة التي تعمل بنظام التشغيل Android مماثل لمستوى واجهة برمجة التطبيقات المستهدف لتطبيقك أو أقدم منه.
يمكنك طلب تمديد الموعد النهائي حتى 1 نوفمبر 2025 إذا كنت بحاجة إلى مزيد من الوقت لتحديث تطبيقك، وسيتاح نموذج طلب التمديد لتطبيقك في Play Console في وقت لاحق من هذا العام.
تشمل الحالات المستثناة من هذه المتطلبات ما يلي:
- التطبيقات الخاصة بشكل دائم التي تقتصر على مستخدمين في مؤسسة معيَّنة والمخصَّصة للتوزيع الداخلي فقط
لماذا يجب استهداف حِزم SDK الأحدث؟
يقدّم كل إصدار جديد من Android تغييرات لتحسين الأمان والأداء وتعزيز تجربة المستخدم على Android. لا تنطبق بعض هذه التغييرات إلا على التطبيقات التي تحدّد صراحةً إمكانية التوافق من خلال سمة targetSdkVersion في ملف البيان (المعروفة أيضًا باسم مستوى واجهة برمجة التطبيقات المستهدَف).
عند ضبط إعدادات تطبيقك لاستهداف مستوى حديث لواجهة برمجة التطبيقات، فإنّ ذلك يضمن استفادة المستخدمين من هذه التحسينات، مع السماح بتشغيل تطبيقك على إصدارات Android قديمة. يسمح استهداف مستوى واجهة برمجة التطبيقات الحديث أيضًا لتطبيقك بالاستفادة من أحدث الميزات في النظام الأساسي لإبهار المستخدمين. بالإضافة إلى ذلك، اعتبارًا من الإصدار 10 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 29)، تظهر للمستخدمين رسالة تحذير عند بدء تشغيل تطبيق للمرة الأولى إذا كان التطبيق يستهدف الإصدار 5.1 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 22) أو إصدارًا أقدم.
يُبرز هذا المستند النقاط المهمة التي تحتاج إلى معرفتها عند تعديل مستوى واجهة برمجة التطبيقات المستهدَف لاستيفاء متطلبات Google Play. راجِع التعليمات في الأقسام التالية، حسب الإصدار الذي تريد نقل بياناتك إليه.
نقل البيانات من الإصدار 12 من نظام التشغيل Android والإصدارات الأحدث (المستوى 31 لواجهة برمجة التطبيقات) إلى إصدار أحدث
لتحديث تطبيقك لاستهداف إصدار أحدث من Android، اتّبِع قائمة التغييرات ذات الصلة في السلوك:
- التغييرات في سلوك Android 13
- التغييرات في سلوك نظام التشغيل Android 14
- التغييرات في سلوك الإصدار Android 15
- التغييرات في سلوك Android 16
الترحيل من Android 11 (مستوى واجهة برمجة التطبيقات 30) إلى Android 12 (مستوى واجهة برمجة التطبيقات 31)
الأمان والأذونات
- البلوتوث: يجب استبدال بيانات
BLUETOOTHوBLUETOOTH_ADMINبأذوناتBLUETOOTH_SCANأوBLUETOOTH_ADVERTISEأوBLUETOOTH_CONNECT. لم يعُد عليك تقديم طلبات للحصول على إذن التشغيلLOCATIONلإجراء عمليات البلوتوث. - الموقع الجغرافي: يمكن للمستخدمين أن يطلبوا من التطبيقات استرداد معلومات الموقع الجغرافي التقريبي فقط. يجب طلب إذن
ACCESS_COARSE_LOCATIONفي كل مرة تطلب فيهاACCESS_FINE_LOCATION.- فلاتر الأهداف: إذا كان تطبيقك يحتوي على أنشطة أو خدمات أو مستقبِلات بث تستخدم فلاتر الأهداف، عليك الإفصاح صراحةً عن السمة android:exported لهذه المكوّنات.
- الإسبات: قد يتم وضع التطبيقات في وضع الإسبات إذا لم يتم استخدامها لفترة من الوقت. في "وضع الإسبات"، تتم إعادة ضبط أذونات وقت التشغيل وذاكرة التخزين المؤقت للتطبيق، ولا يمكنك تشغيل المهام أو التنبيهات. يمكنك الاطّلاع على حالة الإسبات في تطبيقك.
- قابلية تغيير رمز PendingIntent: يجب تحديد قابلية التغيّر لكل عنصر من عناصر PendingIntent ينشئه تطبيقك.
تجربة المستخدم
- الإشعارات المخصّصة: لن تستخدم الإشعارات التي تتضمّن طرق عرض محتوى مخصّصة مساحة الإشعارات الكاملة، بل سيطبّق النظام نموذجًا عاديًا. يضمن هذا النموذج أن تتضمّن الإشعارات المخصّصة الزخرفة نفسها التي تتضمّنها الإشعارات الأخرى في جميع الحالات. وهذا السلوك مطابق تقريبًا لسلوك
Notification.DecoratedCustomViewStyle. - تغييرات في عملية إثبات ملكية "روابط التطبيقات" على Android: عند استخدام عملية إثبات ملكية "روابط التطبيقات" على Android، تأكَّد من أنّ فلاتر الأهداف تتضمّن فئة BROWSABLE وتتوافق مع نظام HTTPS.
الأداء
تقييد إمكانية تشغيل الخدمات التي تعمل في المقدّمة: لا يمكن لتطبيقك بدء تشغيل الخدمات التي تعمل في المقدّمة أثناء تشغيله في الخلفية إذا كان يستهدف الإصدار Android 12 أو الإصدارات الأحدث، باستثناء بعض الحالات الخاصة. إذا حاول أحد التطبيقات بدء خدمة تعمل في المقدّمة أثناء تشغيله في الخلفية، سيحدث استثناء (باستثناء بعض الحالات الخاصة).
ننصحك باستخدام WorkManager لجدولة مهمة مُعجَّلة وبدء تنفيذها أثناء تشغيل تطبيقك في الخلفية. لإكمال الإجراءات الحسّاسة للوقت التي يطلبها المستخدم، ابدأ الخدمات التي تعمل في المقدّمة ضمن منبّه محدَّد الوقت.
قيود على استخدام الإشعارات كمنصّة انطلاق: عندما ينقر المستخدمون على الإشعارات، تستجيب بعض التطبيقات من خلال تشغيل أحد مكونات التطبيق التي تبدأ النشاط الذي يراه المستخدم ويتفاعل معه. يُعرف مكوّن التطبيق هذا باسم "نطاطة الإشعارات".
يجب ألا تبدأ التطبيقات الأنشطة من الخدمات أو أدوات استقبال البث التي يتم استخدامها كمنصات انطلاق للإشعارات. بعد أن ينقر المستخدم على إشعار أو زر إجراء داخل الإشعار، لا يمكن لتطبيقك استدعاء
startActivity()داخل خدمة أو أداة استقبال بث.
يمكنك الاطّلاع على المجموعة الكاملة من التغييرات التي تؤثّر في التطبيقات التي تستهدف الإصدار 12 من نظام التشغيل Android (المستوى 31 من واجهة برمجة التطبيقات).
نقل البيانات من إصدار أقدم من Android 11 (المستوى 30 لواجهة برمجة التطبيقات)
اختَر إصدار Android الذي سيتم نقل البيانات منه:
نقل البيانات إلى Android 5 (مستوى واجهة برمجة التطبيقات 21)
راجِع صفحة "تغييرات السلوك" الخاصة بكل إصدار من الإصدارات التالية للتأكّد من أنّ تطبيقك قد أخذ في الاعتبار التغييرات التي تم تقديمها في هذه الإصدارات:
- Android 5.0 (مستوى واجهة برمجة التطبيقات 21)
- Android 4.4 (مستوى واجهة برمجة التطبيقات 19)
- Android 4.1.x (مستوى واجهة برمجة التطبيقات 16)
تابِع باتّباع التعليمات الواردة في القسم التالي.
نقل البيانات إلى الإصدار 6 من نظام التشغيل Android (المستوى 23 لواجهة برمجة التطبيقات)
تنطبق الاعتبارات التالية على التطبيقات التي تستهدف الإصدار 6.0 من نظام التشغيل Android والإصدارات الأحدث من النظام الأساسي:
-
-
لا يتم منح الأذونات الخطيرة إلا في وقت التشغيل. يجب أن توفّر واجهات المستخدم عناصر مرئية تتيح منح هذه الأذونات.
-
احرص على إعداد تطبيقك للتعامل مع رفض طلبات الأذونات كلما أمكن ذلك. على سبيل المثال، إذا رفض المستخدم طلب الوصول إلى نظام تحديد المواقع العالمي (GPS) على الجهاز، تأكَّد من أنّ تطبيقك لديه طريقة أخرى للمتابعة.
-
للاطّلاع على قائمة شاملة بالتغييرات التي تم إدخالها في الإصدار 6.0 من نظام التشغيل Android (المستوى 23 من واجهة برمجة التطبيقات)، راجِع صفحة التغييرات في السلوك الخاصة بهذا الإصدار من النظام الأساسي.
تابِع باتّباع التعليمات الواردة في القسم التالي.
الانتقال إلى الإصدار 7 من نظام التشغيل Android (المستوى 24 لواجهة برمجة التطبيقات)
تنطبق الاعتبارات التالية على التطبيقات التي تستهدف الإصدار 7.0 من نظام التشغيل Android والإصدارات الأحدث من النظام الأساسي:
-
وضع "القيلولة" و"وضع الاستعداد للتطبيقات"
تصميم السلوكيات الموضّحة في التحسين من أجل ميزتَي "قيلولة" و"تطبيقات وضع الاستعداد"، والتي تشمل التغييرات التدريجية التي تم طرحها في عدّة إصدارات من النظام الأساسي
عندما يكون الجهاز في وضع قيلولة ووضع الاستعداد للتطبيقات، يتصرف النظام على النحو التالي:
- يحظر الوصول إلى الشبكة
- تأجيل المنبّهات والمزامنة والمهام
- تقييد عمليات البحث عن شبكات Wi-Fi ونظام تحديد المواقع العالمي (GPS)
- يتم حظر الرسائل ذات الأولوية العادية من مراسلة Firebase السحابية.
-
التغييرات في الأذونات
- يحظر النظام الوصول إلى الأدلة الخاصة بالتطبيقات.
-
يؤدي عرض عنوان URI
file://خارج تطبيقك إلى تشغيلFileUriExposedException. إذا كنت بحاجة إلى مشاركة ملفات خارج تطبيقك، عليك تنفيذFileProvider
-
يحظر النظام الربط بالمكتبات غير التابعة لمجموعة أدوات تطوير البرامج الأصلية (NDK).
للاطّلاع على قائمة شاملة بالتغييرات التي تم إدخالها في Android 7.0 (مستوى واجهة برمجة التطبيقات 24)، راجِع صفحة التغييرات في السلوك الخاصة بهذا الإصدار من النظام الأساسي.
تابِع باتّباع التعليمات الواردة في القسم التالي.
نقل البيانات إلى الإصدار 8 من نظام التشغيل Android (المستوى 26 لواجهة برمجة التطبيقات)
تنطبق الاعتبارات التالية على التطبيقات التي تستهدف الإصدار 8.0 من نظام التشغيل Android والإصدارات الأحدث من النظام الأساسي:
-
حدود التنفيذ في الخلفية
-
يفرض النظام قيودًا على الخدمات التي تستخدمها التطبيقات التي لا تعمل في المقدّمة.
-
يعرض
startService()الآن استثناءً عندما يحاول تطبيق استدعاءه أثناء حظرstartService(). -
لبدء الخدمات التي تعمل في المقدّمة، يجب أن يستخدم التطبيق
startForeground()وstartForegroundService(). - راجِع بعناية التغييرات التي تم إجراؤها على JobScheduler API، كما هو موضّح في صفحة "التغييرات في السلوك" في Android 8.0 (مستوى واجهة برمجة التطبيقات 26).
- تتطلّب مراسلة Firebase السحابية الإصدار 10.2.1 من حزمة تطوير البرامج (SDK) لخدمات Google Play أو إصدارًا أحدث.
- عند استخدام مراسلة Firebase السحابية، يخضع تسليم الرسائل لحدود التنفيذ في الخلفية. عندما يكون العمل في الخلفية ضروريًا عند تلقّي الرسالة، مثل إجراء مزامنة بيانات الخلفية، يجب أن يجدول تطبيقك المهام باستخدام Firebase Job Dispatcher أو JobIntentService بدلاً من ذلك. لمزيد من المعلومات، راجِع مستندات مراسلة Firebase السحابية.
-
يعرض
-
عمليات البث الضمني
-
يتم حظر عمليات البث الضمني. للحصول على معلومات حول معالجة أحداث الخلفية، يُرجى الاطّلاع على مستندات واجهة برمجة التطبيقات
JobScheduler.
-
يتم حظر عمليات البث الضمني. للحصول على معلومات حول معالجة أحداث الخلفية، يُرجى الاطّلاع على مستندات واجهة برمجة التطبيقات
-
قيود رصد الموقع الجغرافي في الخلفية
-
تتوفّر للتطبيقات التي تعمل في الخلفية إمكانية محدودة للوصول إلى بيانات الموقع الجغرافي.
- على الأجهزة التي تتضمّن "خدمات Google Play"، استخدِم موفّر الموقع الجغرافي المدمج للحصول على تحديثات دورية بشأن الموقع الجغرافي.
-
تتوفّر للتطبيقات التي تعمل في الخلفية إمكانية محدودة للوصول إلى بيانات الموقع الجغرافي.
-
يفرض النظام قيودًا على الخدمات التي تستخدمها التطبيقات التي لا تعمل في المقدّمة.
-
قنوات الإشعارات
- يجب تحديد خصائص مقاطعة الإشعارات على أساس كل قناة.
- يجب تعيين الإشعارات إلى قناة لتظهر.
-
يتوافق هذا الإصدار من النظام الأساسي مع
NotificationCompat.Builder.
-
الخصوصية
- يتم تحديد نطاق ANDROID_ID لكل مفتاح توقيع تطبيق.
للاطّلاع على قائمة شاملة بالتغييرات التي تم تقديمها في الإصدار 8.0 من نظام التشغيل Android (المستوى 26 من واجهة برمجة التطبيقات)، يُرجى الانتقال إلى صفحة التغييرات في السلوك الخاصة بهذا الإصدار من النظام الأساسي.
نقل البيانات من Android 8 (المستوى 26 لواجهة برمجة التطبيقات) إلى Android 9 (المستوى 28 لواجهة برمجة التطبيقات)
-
إدارة الطاقة
- توفّر حِزم "تطبيقات وضع الاستعداد" قيودًا جديدة على التشغيل في الخلفية استنادًا إلى مستوى التفاعل مع التطبيق، مثل المهام المؤجّلة والمنبّهات والحصص على الرسائل ذات الأولوية العالية.
- تحسينات على ميزة "توفير شحن البطارية" زيادة القيود المفروضة على التطبيقات في وضع الاستعداد
-
إذن الوصول إلى الخدمة التي تعمل في المقدّمة
- يجب طلب الإذن العادي
FOREGROUND_SERVICE(وليس إذن التشغيل)
- يجب طلب الإذن العادي
-
التغييرات في الخصوصية
- الوصول المحدود إلى أجهزة الاستشعار في الخلفية
- تم حظر الوصول إلى سجلّات المكالمات، وهي الآن في مجموعة أذونات
CALL_LOG - حظر الوصول إلى أرقام الهواتف، ويتطلّب ذلك الحصول على إذن
READ_CALL_LOG - حظر الوصول إلى معلومات شبكة Wi-Fi
للاطّلاع على قائمة شاملة بالتغييرات التي تم إدخالها في Android 9.0 (المستوى 28 من واجهة برمجة التطبيقات)، يُرجى الاطّلاع على التغييرات في السلوك.
نقل البيانات من Android 9 (مستوى واجهة برمجة التطبيقات 28) إلى Android 10 (مستوى واجهة برمجة التطبيقات 29)
-
الإشعارات
التي تتضمّن وضع العرض بملء الشاشة
-
يجب طلب الإذن العادي
USE_FULL_SCREEN_INTENT(وليس إذن التشغيل).
-
يجب طلب الإذن العادي
-
التوافق مع الأجهزة القابلة للطي والأجهزة ذات الشاشات الكبيرة
-
يمكن أن تكون أنشطة متعدّدة الآن في حالة "تمت استعادة النشاط" في الوقت نفسه، ولكن يمكن التركيز على نشاط واحد فقط.
-
يؤثّر هذا التغيير في سلوك كل من
onResume()وonPause(). -
مفهوم جديد لدورة الحياة وهو "الأكثر استئنافًا" ويمكن رصده من خلال الاشتراك في
onTopResumedActivityChanged().- يمكن أن يكون نشاط واحد فقط في حالة "استئناف في المقدّمة".
-
يؤثّر هذا التغيير في سلوك كل من
-
عند ضبط قيمة
resizeableActivityعلىfalse، يمكن للتطبيقات بالإضافة إلى ذلك تحديد قيمةminAspectRatioالتي تضع التطبيق تلقائيًا في إطار على نسب العرض إلى الارتفاع الأضيق.
-
يمكن أن تكون أنشطة متعدّدة الآن في حالة "تمت استعادة النشاط" في الوقت نفسه، ولكن يمكن التركيز على نشاط واحد فقط.
-
التغييرات في الخصوصية
-
التخزين الفرعي
- يقتصر الوصول إلى مساحة التخزين الخارجية على دليل خاص بالتطبيق وأنواع معيّنة من الوسائط التي أنشأها التطبيق.
-
وصول محدود إلى بيانات الموقع الجغرافي أثناء تشغيل التطبيق في الخلفية، ويتطلّب ذلك الحصول على إذن
ACCESS_BACKGROUND_LOCATION. - تقييد الوصول إلى المعرّفات غير القابلة لإعادة الضبط، مثل رقم IMEI والرقم التسلسلي
-
تقييد الوصول إلى معلومات عن النشاط البدني، مثل عدد خطوات المستخدم، ويتطلّب ذلك الحصول على إذن
ACTIVITY_RECOGNITION. -
تم حظر الوصول إلى
بعض
واجهات برمجة التطبيقات الخاصة بالهاتف والبلوتوث وشبكة Wi-Fi، ما يتطلّب الحصول على إذن
ACCESS_FINE_LOCATION. -
حظر الوصول إلى إعدادات Wi-Fi
- لم يعُد بإمكان التطبيقات تفعيل شبكة Wi-Fi أو إيقافها مباشرةً، بل يجب أن يتم ذلك باستخدام لوحات الإعدادات.
-
قيود على بدء الاتصال بشبكة Wi-Fi،
تتطلّب استخدام إما
WifiNetworkSpecifierأوWifiNetworkSuggestion.
-
التخزين الفرعي
نقل البيانات من الإصدار 10 من نظام التشغيل Android (المستوى 29 لواجهة برمجة التطبيقات) إلى الإصدار 11 من نظام التشغيل Android (المستوى 30 لواجهة برمجة التطبيقات)
-
الخصوصية
- فرض استخدام التخزين الفرعي : يجب أن تعتمد التطبيقات نموذج التخزين الفرعي الذي يتم فيه حفظ أنواع الملفات الخاصة بالتطبيق والوسائط وغيرها من أنواع الملفات والوصول إليها باستخدام مواقع مخصّصة.
- إعادة ضبط الأذونات تلقائيًا: إذا لم يتفاعل المستخدمون مع تطبيق معيّن لبضعة أشهر، يعيد النظام ضبط أذونات التطبيق الحسّاسة تلقائيًا. من المفترض ألا يؤثّر ذلك في معظم التطبيقات. إذا كان تطبيقك يعمل في الخلفية بشكل أساسي بدون تفاعلات المستخدم، يمكنك أن تطلب من المستخدمين إيقاف إعادة الضبط التلقائي.
- رصد الموقع الجغرافي في الخلفية: يجب أن تطلب التطبيقات إذن تحديد الموقع الجغرافي في المقدّمة وفي الخلفية بشكل منفصل. لا يمكن منح إذن رصد الموقع الجغرافي في الخلفية إلا من خلال إعدادات التطبيق بدلاً من مربّعات الحوار الخاصة بأذونات وقت التشغيل.
-
إذن الوصول إلى حِزم التطبيقات: عندما يطلب تطبيق قائمة بالتطبيقات والخدمات المثبَّتة على الجهاز، يتم فلترة القائمة التي يتم عرضها.
- إذا كنت تستخدم خدمات تحويل النص إلى كلام أو التعرّف على الكلام، عليك إضافة عناصر طلبات البحث الخاصة بالخدمات إلى ملف البيان.
-
الأمان
- لم يعُد مسموحًا باستخدام ملفات `resource.arsc` المضغوطة
- الإصدار 2 من مخطّط توقيع حِزم APK مطلوب الآن. ولأسباب تتعلّق بالتوافق مع الإصدارات القديمة، على المطوّرين أيضًا مواصلة التوقيع باستخدام الإصدار 1 من مخطّط توقيع حزمة APK.
- قيود على الواجهات غير المتوفّرة في حزمة SDK لا يُنصح باستخدام واجهات غير متوفرة في حزمة SDK للتطبيقات التي تستهدف المستوى 30 من واجهة برمجة التطبيقات، لأنّ بعض هذه الواجهات غير المتوفرة في حزمة SDK محظورة الآن. يمكنك الاطّلاع على الواجهات غير المتوفرة في حزمة SDK التي تم حظرها الآن في Android 11 للحصول على قائمة شاملة بالواجهات غير المتوفرة في حزمة SDK المحظورة.
للاطّلاع على قائمة شاملة بالتغييرات التي تم تقديمها في Android 11 (المستوى 30 لواجهة برمجة التطبيقات)، يُرجى الانتقال إلى صفحة التغييرات في السلوك.
يمكنك مواصلة التحديث إلى الإصدار 31 من واجهة برمجة التطبيقات باتّباع التعليمات الواردة في القسم السابق.
تطوير تطبيقاتك
أثناء تحديث مستوى واجهة برمجة التطبيقات المستهدَف لتطبيقاتك، ننصحك باستخدام أحدث ميزات النظام الأساسي لتحديث تطبيقاتك وإبهار المستخدمين.
- ننصحك باستخدام CameraX، وهي إصدار تجريبي، للاستفادة إلى أقصى حد من استخدام الكاميرا.
- استخدِم مكوّنات Jetpack للمساعدة في اتّباع أفضل الممارسات، وتوفير الوقت الذي تستغرقه في كتابة الرموز البرمجية النموذجية، وتبسيط المهام المعقّدة حتى تتمكّن من التركيز على الرموز البرمجية التي تهمّك.
- استخدِم Kotlin لكتابة تطبيقات أفضل بشكل أسرع وبعدد أقل من الرموز البرمجية.
- احرص على اتّباع متطلبات الخصوصية وأفضل الممارسات المتعلّقة بها.
- أضِف إمكانية استخدام المظهر الداكن إلى تطبيقاتك.
- أضِف إمكانية استخدام التنقّل بالإيماءات إلى تطبيقاتك.
- نقل تطبيقك من Google Cloud Messaging (GCM) إلى أحدث إصدار من مراسلة Firebase السحابية.
- الاستفادة من ميزة إدارة النوافذ المتقدّمة
- إتاحة نسب عرض إلى ارتفاع أكبر (أكثر من 16:9) للاستفادة من التطورات الحديثة في الأجهزة تأكَّد من تغيير حجم تطبيقك لملء مساحة الشاشة المتاحة. لا تحدّد الحدّ الأقصى لنسبة العرض إلى الارتفاع إلا عند الضرورة القصوى. لمزيد من المعلومات حول الحد الأقصى لنسب العرض إلى الارتفاع، يُرجى الاطّلاع على بيان دعم الشاشة المقيد.
- أضِف إمكانية استخدام نوافذ متعدّدة لمساعدة تطبيقك في زيادة الإنتاجية وإدارة شاشات عرض متعدّدة.
- إذا كان توفير تجربة رائعة للتطبيق المصغّر سيؤدي إلى تحسين تجربة المستخدم،
أضِف ميزة نافذة ضمن النافذة.
- تحسين الأداء على الأجهزة التي تحتوي على صورة مقطوعة للشاشة
- لا تفترض ارتفاع شريط الحالة. بدلاً من ذلك، استخدِم
WindowInsetsوView.OnApplyWindowInsetsListener. لمزيد من المعلومات، يمكنك مشاهدة فيديو مؤتمر droidcon في نيويورك لعام 2017. - لا تفترض أنّ التطبيق يملأ النافذة بأكملها. بدلاً من ذلك، أكِّد موقعها الجغرافي باستخدام
View.getLocationInWindow()وليسView.getLocationOnScreen(). * عند التعامل معMotionEvent، استخدِمMotionEvent.getX()وMotionEvent.getY()، وليسMotionEvent.getRawX()وMotionEvent.getRawY().
التحقّق من حِزم SDK والمكتبات وتحديثها
تأكَّد من أنّ تبعيات حزمة تطوير البرامج (SDK) التابعة لجهات خارجية تتوافق مع الإصدار 31 من واجهة برمجة التطبيقات: ينشر بعض مزوّدي حِزم SDK هذا الإصدار في ملف البيان، بينما يتطلّب البعض الآخر إجراء بحث إضافي. إذا كنت تستخدم حزمة تطوير برامج (SDK) لا تتوافق مع الإصدار 31 من واجهة برمجة التطبيقات، عليك إعطاء الأولوية لحلّ المشكلة بالتعاون مع موفِّر حزمة تطوير البرامج (SDK).
بالإضافة إلى ذلك، يُرجى العِلم أنّ targetSdkVersion في تطبيقك أو لعبتك قد يقيّد الوصول إلى مكتبات نظام Android الأساسي الخاصة. لمزيد من التفاصيل، يُرجى الاطّلاع على ربط تطبيقات NDK بمكتبات المنصة.
عليك أيضًا التحقّق من أي قيود قد تكون موجودة في إصدار "مكتبة دعم Android" الذي تستخدمه. وكالعادة، عليك التأكّد من التوافق بين رقم الإصدار الرئيسي من "مكتبة دعم Android" وcompileSdkVersion لتطبيقك.
ننصحك باختيار targetSdkVersion أصغر من أو يساوي رقم الإصدار الرئيسي من مكتبة الدعم. ننصحك بالتحديث إلى إصدار حديث ومتوافق من "مكتبة الدعم" للاستفادة من أحدث ميزات التوافق وإصلاحات الأخطاء.
اختبار تطبيقك
بعد تعديل مستوى واجهة برمجة التطبيقات والميزات في تطبيقك حسب الاقتضاء، عليك اختبار بعض حالات الاستخدام الأساسية. الاقتراحات التالية ليست شاملة، ولكنها تهدف إلى توجيه عملية الاختبار. نقترح اختبار ما يلي:
- أن يتم تجميع تطبيقك إلى الإصدار 29 من واجهة برمجة التطبيقات بدون أخطاء أو تحذيرات
أنّ تطبيقك لديه استراتيجية للحالات التي يرفض فيها المستخدم طلبات الأذونات، وأنّه يطلب من المستخدم منح الأذونات. لإجراء ذلك:
- انتقِل إلى شاشة "معلومات التطبيق" الخاصة بتطبيقك، وأوقِف كل إذن.
- افتح التطبيق وتأكَّد من عدم حدوث أي أعطال.
- إجراء اختبارات لحالات الاستخدام الأساسية والتأكّد من إعادة طلب الأذونات المطلوبة
يتعامل مع ميزة "توفير البطارية" بالنتائج المتوقّعة وبدون أخطاء.
- باستخدام adb، ضَع جهازك الاختباري في وضع "السكون" أثناء تشغيل تطبيقك.
- اختبِر أي حالات استخدام تؤدي إلى تشغيل رسائل "مراسلة Firebase السحابية".
- اختبِر أي حالات استخدام تستخدم المنبّهات أو المهام.
- تخلَّص من أي تبعيات على الخدمات التي تعمل في الخلفية.
- ضبط تطبيقك على وضع "تطبيقات وضع الاستعداد"
- اختبِر أي حالات استخدام تؤدي إلى تشغيل رسائل "مراسلة Firebase السحابية".
- اختبِر أي حالات استخدام تستخدم المنبّهات.
- باستخدام adb، ضَع جهازك الاختباري في وضع "السكون" أثناء تشغيل تطبيقك.
التعامل مع الصور أو الفيديوهات الجديدة التي يتم التقاطها
- تأكَّد من أنّ تطبيقك يتعامل مع عمليات البث المقيدة
ACTION_NEW_PICTUREوACTION_NEW_VIDEOبشكل صحيح (أي تم نقلها إلى مهام JobScheduler). - تأكَّد من أنّ أي حالات استخدام مهمة تعتمد على هذه الأحداث لا تزال تعمل.
- تأكَّد من أنّ تطبيقك يتعامل مع عمليات البث المقيدة
التعامل مع مشاركة الملفات مع تطبيقات أخرى - اختبار أي حالة استخدام تشارك بيانات الملفات مع أي تطبيق آخر (حتى تطبيق آخر من المطوّر نفسه)
- اختبِر ما إذا كان المحتوى يظهر في التطبيق الآخر ولا يؤدي إلى حدوث أعطال.
معلومات إضافية
فعِّل خيار تلقّي الرسائل الإلكترونية في Google Play Console حتى نتمكّن من إرسال آخر الأخبار والإشعارات المهمة من Android وGoogle Play إليك، بما في ذلك النشرة الإخبارية الشهرية للشركاء.