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

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

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

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

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

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

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

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

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

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

الحصول على الإصدار 13 من نظام التشغيل Android

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

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

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

الاختبار

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

تعديل

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

نشر

وقِّع حِزمة Android App Bundle أو حزمة 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. يمكنك إجراء هذه التعديلات عندما تكون مستعدًا، مع مراعاة متطلبات Google 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 أو محاكي. ركِّز على المناطق التي قد تؤثر فيها تغييرات السلوك في تطبيقك، وجرِّب وظائف تستخدم واجهات برمجة تطبيقات جديدة. تقديم ملاحظات بشأن المنصة وواجهة برمجة التطبيقات الإبلاغ عن أي مشاكل في النظام الأساسي أو واجهة برمجة التطبيقات أو حزمة SDK التابعة لجهة خارجية

آخر تعديل

بعد اكتمال واجهات برمجة تطبيقات Android 13، عدِّل targetSdkVersion وإعدادات الإصدار الأخرى مرة أخرى، وأدخِل أي تعديلات إضافية، واختَبر تطبيقك.

نشر

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

الحصول على حزمة تطوير البرامج (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 مفاتيح تبديل التوافق التي تسهّل اختبار تطبيقك من خلال تغييرات السلوك المستهدَفة. بالنسبة إلى التطبيق الذي يمكن تصحيح أخطاءه، تتيح لك مفاتيح التبديل إجراء ما يلي:

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

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