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

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

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

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

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

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

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

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

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

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

الحصول على Android 13

وضِع صورة نظام Android 13 على جهازك أو نزِّل صورة نظام لمحاكي Android.

مراجعة التغييرات

مراجعة التغييرات في سلوك النظام لتحديد المناطق التي يتوفّر فيها تطبيقك قد تتأثر.

الاختبار

ثبِّت تطبيقك على جهازك أو المحاكي وأجرِ الاختبارات. التركيز على التغييرات في سلوك النظام والعمل على جميع مسارات التطبيقات.

تعديل

لا تجرِ سوى التغييرات المطلوبة على الرمز البرمجي للتكيّف مع التغيُّرات في السلوك أو لحلّ المشاكل. إعادة التحويل البرمجي باستخدام مستوى واجهة برمجة التطبيقات نفسه التي يستهدفها تطبيقك في الأصل - لا يلزم استهداف Android 13.

نشر

توقيع مجموعة حزمات تطبيق Android المُحدَّثة وتحميلها ونشرها أو APK.

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

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

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

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

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

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

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

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

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

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

الحصول على حزمة تطوير البرامج (SDK) لنظام التشغيل Android 13

ثبِّت أحدث إصدار من الإصدار التجريبي من "استوديو Android" لإنشاء التطبيقات باستخدام الإصدار 13 من Android. تأكَّد من أنّ لديك جهاز Android 13 أو المحاكي.
عدِّل إعدادات targetSdkVersion وغيرها من إعدادات عملية الإنشاء.

مراجعة التغييرات في السلوك

راجِع التغييرات في السلوك التي تنطبق على التطبيقات التي تستهدف الإصدار 13 من Android. تحديد المناطق التي قد يتأثر فيها تطبيقك والتخطيط لكيفية دعمهم.

التحقّق من التغييرات الجديدة في الخصوصية

إجراء التغييرات اللازمة على الرموز البرمجية والبنية اللازمة للتوافق مع نظام Android 13 التغييرات في خصوصية المستخدم.

استخدام ميزات Android 13

يمكنك الاستفادة من واجهات برمجة التطبيقات لنظام التشغيل Android 13 لتوفير ميزات والإمكانيات الجديدة لتطبيقاتك. إعادة التحويل البرمجي لنظام Android 13

الاختبار

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

التحديث الأخير

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

نشر

وقِّع حِزمة Android App Bundle أو حزمة APK المعدَّلة وحمِّلها وانشرها.

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

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

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

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

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

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

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

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

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

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

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