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

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

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

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

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

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

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

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

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

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

اختبار توافق تطبيقك مع Android 17

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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