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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

توضّح الخطوات التالية كيفية توفير الدعم الكامل لنظام Android 15.

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

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

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

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

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

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

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

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

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

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

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