نقل التطبيقات إلى Android 13

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

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

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

تشمل عملية نقل البيانات العادية مرحلتَين يمكن أن تكونا متزامنتَين:

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

التأكّد من التوافق مع Android 13

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

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

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

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

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

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

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

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

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

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

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

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

توضِّح الخطوات التالية كيفية توفير التوافق الكامل مع Android 13.

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

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

اختبار تطبيقك على Android 13

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

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

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

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

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

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

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

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