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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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