نقل التطبيقات إلى الإصدار 12 من نظام التشغيل Android

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

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

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

تتضمّن عملية النقل النموذجية مرحلتَين يمكن أن تكونا متزامنتَين:

• ضمان توافق التطبيق (بحلول الإصدار النهائي من Android 12)
• استهداف الميزات وواجهات برمجة التطبيقات الجديدة للنظام الأساسي (في أقرب وقت ممكن بعد الإصدار النهائي)

ضمان التوافق مع Android 12

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

يمكنك عادةً تعديل تطبيقك ونشر تحديث بدون الحاجة إلى تغيير targetSdkVersion للتطبيق. وبالمثل، لن تحتاج إلى استخدام واجهات برمجة تطبيقات جديدة أو تغيير compileSdkVersion للتطبيق، على الرغم من أنّ ذلك قد يعتمد على طريقة إنشاء تطبيقك ووظائف النظام الأساسي التي يستخدمها.

قبل البدء في الاختبار، احرص على التعرّف على تغييرات السلوك لجميع التطبيقات. قد تؤثر هذه التغييرات في تطبيقك، حتى إذا لم تغيّر targetSdkVersion.

إجراء اختبار التوافق

في معظم الحالات، يكون اختبار التوافق مع Android 12 مشابهًا لاختبار التطبيقات العادي. هذا هو الوقت المناسب لمراجعة إرشادات جودة التطبيق الأساسية و أفضل الممارسات للاختبار.

لإجراء الاختبار، ثبِّت تطبيقك الحالي المنشور على جهاز يعمل بنظام التشغيل Android 12، واختبِر جميع المسارات والوظائف بحثًا عن المشاكل. لمساعدتك في التركيز على الاختبار، راجِع تغييرات السلوك لجميع التطبيقات التي تم تقديمها في Android 12 والتي يمكن أن تؤثر في طريقة عمل تطبيقك أو تؤدي إلى تعطّله.

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

أخيرًا، احرص على اختبار المكتبات وحِزم SDK في تطبيقك بشكل كامل للتأكّد من أنّها تعمل على النحو المتوقّع على Android 12 وتتّبع أفضل الممارسات للخصوصية والأداء وتجربة المستخدم ومعالجة البيانات والأذونات. إذا وجدت مشكلة، حاوِل التحديث إلى أحدث إصدار من حزمة SDK أو تواصَل مع مطوّر حزمة SDK للحصول على المساعدة.

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

تعديل استهداف التطبيق وإنشاؤه باستخدام واجهات برمجة التطبيقات الجديدة

بعد نشر إصدار متوافق من تطبيقك، تتمثل الخطوة التالية في إضافة الدعم الكامل لنظام التشغيل Android 12 من خلال تعديل targetSdkVersion والاستفادة من واجهات برمجة التطبيقات والإمكانات الجديدة في Android 12. يمكنك إجراء هذه التعديلات متى أصبحت جاهزًا، مع الأخذ في الاعتبار متطلبات Google Play لاستهداف النظام الأساسي الجديد.

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

توضّح الخطوات التالية كيفية توفير الدعم الكامل لنظام التشغيل Android 12.

الحصول على حزمة SDK وتغيير الاستهداف والإنشاء باستخدام واجهات برمجة التطبيقات الجديدة

لبدء اختبار الدعم الكامل لنظام التشغيل Android 12، استخدِم أحدث إصدار مبكر حصري من "استوديو Android" لتنزيل حزمة Android 12 SDK وأي أدوات أخرى تحتاج إليها. بعد ذلك، عدِّل targetSdkVersion و compileSdkVersion لتطبيقك، وأعِد تجميع التطبيق. اطّلِع على دليل إعداد حزمة SDK للحصول على التفاصيل.

اختبار تطبيق Android 12

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

كما هو الحال مع اختبار التوافق الأساسي، اختبِر جميع المسارات والوظائف بحثًا عن المشاكل. ركِّز اختبارك على الـ تغييرات السلوك للتطبيقات التي تستهدف Android 12. هذا هو الوقت المناسب أيضًا للتحقّق من تطبيقك من ناحية إرشادات جودة التطبيق الأساسية وأفضل الممارسات للاختبار.

احرص على مراجعة واختبار حالات استخدام واجهات غير تابعة لحزمة SDK ومقيّدة التي قد تنطبق. انتبه إلى تحذيرات logcat التي تسلّط الضوء على عمليات الوصول هذه، واستخدِم طريقة detectNonSdkApiUsage() في `StrictMode` لرصدها آليًا.

أخيرًا، احرص على اختبار المكتبات وحِزم SDK في تطبيقك بشكل كامل للتأكّد من أنّها تعمل على النحو المتوقّع على Android 12 وتتّبع أفضل الممارسات للخصوصية والأداء وتجربة المستخدم ومعالجة البيانات والأذونات. إذا وجدت مشكلة، حاوِل التحديث إلى أحدث إصدار من حزمة SDK أو تواصَل مع مطوّر حزمة SDK للحصول على المساعدة.

الاختبار باستخدام مفاتيح التوافق مع التطبيق

يتضمّن Android 12 مفاتيح توافق تسهّل اختبار تطبيقك مع تغييرات السلوك المستهدَفة. بالنسبة إلى تطبيق قابل للتصحيح، تتيح لك المفاتيح ما يلي:

• اختبار التغييرات المستهدَفة بدون تغيير `targetSdkVersion` للتطبيق فعليًا. يمكنك استخدام المفاتيح لفرض تفعيل تغييرات سلوك مستهدَفة محدّدة لتقييم التأثير في تطبيقك الحالي.
• تركيز الاختبار على تغييرات محدّدة فقط : بدلاً من الاضطرار إلى معالجة جميع التغييرات المستهدَفة في وقت واحد، تتيح لك مفاتيح التبديل إيقاف جميع التغييرات المستهدَفة باستثناء التغييرات التي تريد اختبارها.
• إدارة المفاتيح من خلال adb : يمكنك استخدام أوامر adb لتفعيل التغييرات القابلة للتبديل وإيقافها في بيئة الاختبار الآلي.
• تصحيح الأخطاء بشكل أسرع باستخدام معرّفات التغيير العادية : لكل تغيير قابل للتبديل معرّف واسم فريدان يمكنك استخدامهما لتصحيح السبب الجذري بسرعة في ناتج السجلّ.

أثناء الاستعداد لتغيير استهداف تطبيقك أو أثناء التطوير النشط لدعم Android 12، يمكن أن تساعدك المفاتيح. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في إطار التوافق (Android 12).