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

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

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

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

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

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

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

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

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

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

الحصول على Android 14

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

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

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

الاختبار

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

تعديل

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

نشر

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الاختبار

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

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

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

نشر

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

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

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

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

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

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

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

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

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

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

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

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