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

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

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

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

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

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

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

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

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

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

الحصول على Android 13

يمكنك تثبيت نسخة نظام التشغيل Android 13 على جهازك أو تنزيل نسخة نظام للمحاكي.

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

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

الاختبار

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

تعديل

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

نشر

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الاختبار

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

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

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

نشر

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

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

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

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

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

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

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

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

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

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

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

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