يقدّم هذا المستند نظرة عامة على مراحل التطوير والاختبار المعتادة التي يمكن أن تساعدك في وضع خطة استعداد متوافقة بشكل جيد مع المخطط الزمني لإصدار الإصدار العلني للمنصة، ما يضمن تجربة رائعة للمستخدمين على Android 14.
مع كل إصدار من Android، نقدّم ميزات جديدة وتغييرات في السلوك بهدف جعل Android أكثر فائدة وأمانًا وأداءً. في العديد من الحالات، سيعمل تطبيقك على النحو المتوقّع مباشرةً بعد تثبيته، وفي حالات أخرى، قد تحتاج إلى تحديث تطبيقك للتكيّف مع التغييرات في النظام الأساسي.
يمكن للمستخدمين بدء تلقّي المنصة الجديدة فور طرح الرمز المصدر في AOSP (مشروع Android Open Source Project)، لذا من المهم أن تكون تطبيقاتك جاهزة وأن تحقّق الأداء المتوقّع للمستخدمين وأن تستفيد بشكل مثالي من الميزات وواجهات برمجة التطبيقات الجديدة للاستفادة إلى أقصى حد من المنصة الجديدة.
تتضمّن عملية نقل البيانات النموذجية مرحلتين يمكن أن تكونا متزامنتَين:
- ضمان توافق التطبيق (وفقًا للإصدار النهائي من Android 14)
- استهداف ميزات المنصة وواجهات برمجة التطبيقات الجديدة (في أقرب وقت ممكن بعد الإصدار النهائي)
التأكّد من التوافق مع Android 14
من المهم اختبار وظائف تطبيقك الحالي على الإصدار Android 14 لضمان تقديم تجربة رائعة للمستخدمين الذين يُجريون التحديث إلى أحدث إصدار من Android. يمكن أن تؤثر بعض التغييرات في النظام الأساسي في سلوك تطبيقك، لذا من المهم إجراء الاختبار مبكرًا وبدقة وإجراء أي تعديلات مطلوبة على تطبيقك.
يمكنك عادةً تعديل تطبيقك ونشر تحديث له بدون الحاجة إلى تغيير
targetSdkVersion
التطبيق. وبالمثل، لن تحتاج إلى استخدام واجهات برمجة تطبيقات جديدة أو
تغيير compileSdkVersion
للتطبيق، إلا أنّ ذلك قد يعتمد على طريقة
إنشاء تطبيقك ووظائف المنصة التي يستخدمها.
قبل بدء الاختبار، احرص على الاطّلاع على التغييرات المتعلّقة بالسلوك
في جميع التطبيقات. قد تؤثّر هذه التغييرات في تطبيقك، حتى إذا لم يتم
تغيير targetSdkVersion
.
وضِّع مثبّتًا لنظام Android 14 على جهازك أو نزِّل مثبّتًا لنظام Android في المحاكي.
راجِع التغييرات في سلوك النظام لتحديد الجوانب التي قد يتأثّر بها تطبيقك.
ثبِّت تطبيقك على جهازك أو المحاكي، ونفِّذ الاختبارات. ركِّز على التغييرات في سلوك النظام، واعمل على جميع مسارات التطبيق.
لا تجرِ سوى التغييرات المطلوبة على الرمز البرمجي للتكيّف مع التغيُّرات في السلوك أو لحلّ المشاكل. إعادة الترجمة والبناء باستخدام مستوى واجهة برمجة التطبيقات نفسه الذي كان يستهدفه تطبيقك في الأصل، بدون الحاجة إلى استهداف الإصدار 14 من نظام التشغيل Android
وقِّع حِزمة Android App Bundle أو حزمة APK المعدَّلة وحمِّلها وانشرها.
إجراء اختبار التوافق
في معظم الأحيان، يشبه اختبار التوافق مع 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 لاستهداف المنصة الجديدة.
أثناء التخطيط لعملك لتوفير التوافق الكامل مع الإصدار 14 من نظام التشغيل Android، راجِع تغييرات السلوك التي تؤثر في التطبيقات التي تستهدف الإصدار 14 من نظام التشغيل Android. وقد تؤدي هذه التغييرات في السلوك المستهدَف إلى حدوث مشاكل وظيفية عليك عندئذٍ معالجتها. في بعض الحالات، تتطلّب هذه التغييرات تطويرًا كبيرًا، لذلك ننصحك بالاطّلاع عليها ومعالجتها في أقرب وقت ممكن. للمساعدة في تحديد التغيُّرات المحدّدة في السلوك التي تؤثّر في تطبيقك، استخدِم مفتاحَي التبديل للتوافق لاختبار تطبيقك مع تفعيل التغييرات المحدّدة.
توضِّح الخطوات التالية كيفية توفير التوافق الكامل مع Android 14.
ثبِّت أحدث إصدار من إصدار Android Studio التجريبي لإنشاء التطبيقات باستخدام الإصدار 14 من Android. تأكَّد من توفُّر جهاز Android 14 أو
محاكي.
عدِّل إعدادات targetSdkVersion
وغيرها من إعدادات
الإصدار.
راجِع التغييرات في السلوك التي تنطبق على التطبيقات التي تستهدف الإصدار 14 من نظام التشغيل Android. حدِّد الجوانب التي قد يتأثّر بها تطبيقك، وخطِّط لكيفية دعمها.
إجراء التغييرات اللازمة على الرمز البرمجي والبنية لتتوافق مع التغييرات في خصوصية المستخدم في Android 14
يمكنك الاستفادة من واجهات برمجة تطبيقات Android 14 لإضافة ميزات و إمكانات جديدة إلى تطبيقاتك. إعادة الترجمة والربط لنظام التشغيل Android 14
يمكنك إجراء الاختبار على جهاز Android 14 أو جهاز محاكاة. ركِّز على المناطق التي قد تؤثر فيها تغييرات السلوك في تطبيقك، وجرِّب وظائف تستخدم واجهات برمجة تطبيقات جديدة. تقديم ملاحظات بشأن المنصة وواجهة برمجة التطبيقات الإبلاغ عن أي مشاكل في النظام الأساسي أو واجهة برمجة التطبيقات أو حزمة SDK التابعة لجهة خارجية
بعد اكتمال واجهات برمجة تطبيقات Android 14، عدِّل
targetSdkVersion
وإعدادات الإصدار الأخرى
مرة أخرى، وأدخِل أي تعديلات إضافية، واختَبر تطبيقك.
وقِّع حِزمة Android App Bundle أو حزمة APK المعدَّلة وحمِّلها وانشرها.
الحصول على حزمة تطوير البرامج (SDK) وتغيير الاستهداف وإنشاء التطبيقات باستخدام واجهات برمجة التطبيقات الجديدة
لبدء اختبار التوافق الكامل مع Android 14، استخدِم أحدث
إصدار تجريبي من "استوديو Android" لتنزيل "حزمة تطوير البرامج (SDK) لنظام Android 14"
وأي أدوات أخرى تحتاجها. بعد ذلك، عدِّل targetSdkVersion
و
compileSdkVersion
في تطبيقك وأعِد تجميعه. اطّلِع على دليل إعداد حزمة تطوير البرامج (SDK) للاطّلاع على مزيد من التفاصيل.
اختبار تطبيقك على Android 14
بعد تجميع التطبيق وتثبيته على جهاز يعمل بنظام التشغيل Android 14، ابدأ الاختبار للتأكّد من أنّ التطبيق يعمل بشكلٍ سليم عند استهداف نظام التشغيل Android 14. لا تنطبق بعض التغييرات في السلوك إلا عندما يستهدف تطبيقك المنصة الجديدة، لذا عليك مراجعة تلك التغييرات قبل البدء.
كما هو الحال مع اختبار التوافق الأساسي، عليك مراجعة جميع عمليات التنقّل والوظائف بحثًا عن المشاكل. ركِّز اختباراتك على التغييرات في السلوك للتطبيقات التي تستهدف الإصدار 14 من نظام التشغيل Android. ويُعدّ هذا الوقت مناسبًا أيضًا للتحقّق من امتثال تطبيقك لإرشادات الجودة الأساسية للتطبيقات وأفضل الممارسات المتعلّقة بالاختبار.
احرص على مراجعة واختبار استخدامات الواجهات غير المتاحة في حزمة SDK
التي قد تنطبق. انتبه إلى التحذيرات من logcat التي تُبرز عمليات الوصول هذه واستخدِم
طريقة StrictMode detectNonSdkApiUsage()
لرصدها
برمجيًا.
أخيرًا، احرص على اختبار المكتبات وحِزم SDK في تطبيقك بالكامل للتأكّد من أنّها تعمل على النحو المتوقّع على نظام التشغيل Android 14، واتّبِع أفضل الممارسات المتعلّقة بالخصوصية والأداء وتجربة المستخدم ومعالجة البيانات والأذونات. إذا صادفت مشكلة، حاوِل التحديث إلى أحدث إصدار من حزمة SDK أو تواصَل مع مطوّر حزمة SDK للحصول على المساعدة.
الاختبار باستخدام مفاتيح التبديل لتوافق التطبيق
يتضمّن Android 14 مفاتيح تبديل التوافق التي تسهّل اختبار تطبيقك من خلال تغييرات السلوك المستهدَفة. بالنسبة إلى التطبيق الذي يمكن تصحيح أخطاءه، تتيح لك مفاتيح التبديل إجراء ما يلي:
- اختبار التغييرات المستهدَفة بدون تغيير قيمة ملف APK الخاص بالتطبيق targetSdkVersion يمكنك استخدام مفاتيح التبديل لتفعيل تغييرات سلوك محدّدة مستهدفة بشكل إجباري من أجل تقييم تأثيرها في تطبيقك الحالي.
- ركِّز اختباراتك على تغييرات محدّدة فقط. بدلاً من الحاجة إلى معالجة جميع التغييرات المستهدَفة في آنٍ واحد، تتيح لك مفاتيح التبديل إيقاف جميع التغييرات المستهدَفة باستثناء التغييرات التي تريد اختبارها.
- إدارة مفاتيح التبديل من خلال adb يمكنك استخدام أوامر adb لتفعيل التغييرات التي يمكن التبديل بينها و إيقافها في بيئة الاختبار المبرمَج.
- تصحيح الأخطاء بشكل أسرع باستخدام معرّفات التغيير العادية لكل تغيير قابل للتبديل رقم تعريف واسم فريدَين يمكنك استخدامهما لتصحيح أخطاء السبب الأساسي بسرعة في ملف log الإخراج.
يمكن أن تساعدك مفاتيح التبديل أثناء الاستعداد لتغيير استهداف تطبيقك أو أثناء التطوير النشط لتوفير التوافق مع الإصدار 14 من نظام التشغيل Android. لمزيد من المعلومات، اطّلِع على تغييرات إطار عمل التوافق (Android 14).