يعمل فريق "منصة خرائط Google" بانتظام على تحديث حِزم SDK بإضافة ميزات جديدة وإصلاح الأخطاء وتحسين الأداء. تقدّم هذه الصفحة إرشادات حول كيفية إدارة تبعياتك على حِزم SDK للأجهزة الجوّالة.
ما هو الإصدار الذي يجب الربط به؟
-
بالنسبة إلى التطبيقات بالغة الأهمية، يجب الربط بأحدث إصدار فرعي من رقم الإصدار الرئيسي الذي تستخدمه (X.*)، والترقية سنويًا إلى رقم الإصدار الرئيسي الجديد.
عند طرح إصدارات جديدة من تطبيقك على مدار العام، قد تبدأ في استخدام أحدث الإصدارات الفرعية من حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android. لن يتطلب ذلك إجراء تحديثات في تطبيقك لأنّ الإصدارات الفرعية الجديدة متوافقة مع الإصدارات السابقة.
المزايا:
- إذا اكتشفت مشاكل في حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android، سيتم توفير إصلاحات بطريقة متوافقة مع الأنظمة القديمة لمدة 12 شهرًا بعد الإصدار الأولي من رقم الإصدار الرئيسي، وفقًا لـ سياسة الدعم على الأجهزة الجوّالة. لن تحتاج إلى الترقية بشكل عاجل إلى إصدار غير متوافق من حزمة SDK للاستفادة من الإصلاحات.
- من السهل اعتماد أحدث التحسينات والميزات عندما يكون تطبيقك مبنيًا على أحدث إصدار.
- قد تتطلب التحديثات السنوية التزايدية إلى أحدث رقم إصدار رئيسي من حزمة تطوير البرامج (SDK) جهدًا أقل لتكييف تطبيقك وإعادة كتابته واختباره، مقارنةً بالتعامل مع التغييرات غير المتوافقة مع الإصدارات السابقة التي تم إدخالها في إصدارات رئيسية متعددة.
بالنسبة إلى التطبيقات غير الأساسية، يجب الربط بأي إصدار ثابت. عند تلقّي إشعار بإيقاف الإصدار الثابت، سيكون لديك 12 شهرًا لإتاحة رمز تطبيقك المعدَّل للمستخدمين.
المزايا:
- تقليل وتيرة أعمال الصيانة.
- تستمر الإصدارات الجديدة من تطبيقك في دعم أجهزة المستخدمين التي تعمل بأنظمة تشغيل أقدم للأجهزة الجوّالة لفترة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة SDK).
يتلقّى مالكو المشاريع الذين لديهم عناوين بريد إلكتروني تتم مراقبتها إشعارات استباقية بشأن التغييرات التي تؤثر في كل مشروع من مشاريعهم. يمكنك البقاء على اطّلاع على التحديثات الرئيسية وعمليات الإيقاف والتغييرات الأخرى.
تثبيت
في ملف build.gradle.kts أو build.gradle على مستوى التطبيق، يجب دائمًا تحديد
إصدار بدلاً من نطاق بادئة (+) أو latest لأنّ ذلك قد يؤدي
إلى عمليات إنشاء غير متوقعة وغير قابلة للتكرار. تلتزم حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android بنظام الترقيم الدلالي للإصدارات، وقد تتضمّن أرقام الإصدارات الرئيسية الجديدة تغييرات قد تؤدي إلى عطل. الحد الأدنى من مستوى واجهة برمجة التطبيقات المتوافق هو 23.
تحديد تبعية "خرائط Google" ضمن "خدمات Google Play" باستخدام بنية Gradle.
dependencies { // Maps SDK for Android implementation(libs.play.services.maps) }
يمكنك الاطّلاع على إرشادات إضافية بشأن إدارة نظام تحديد الإصدارات في خدمات Google Play.
الصيانة والترقية
يبحث "استوديو Android" تلقائيًا عن أحدث الإصدارات المتاحة ويقدّم تحذيرًا عند توفّر إصدار أحدث من إحدى التبعيات. للحدّ من الديون الفنية، يجب الترقية إلى أحدث إصدار متاح في أقرب وقت ممكن. إذا كنت بصدد الترقية إلى رقم إصدار رئيسي جديد، يُرجى الاطّلاع على ملاحظات الإصدار لمعرفة التغييرات غير المتوافقة مع الإصدارات السابقة وكيفية تعديل الرمز.
بالإضافة إلى التحقّق من توفّر إصدارات أحدث، يتلقّى مالكو مشاريع Google Cloud المشاريع رسائل إلكترونية بشأن التغييرات غير المتوافقة مع الإصدارات السابقة التي قد تؤثر في مشاريعهم. لتلقّي إشعار استباقي بشأن التغييرات غير المتوافقة مع الإصدارات السابقة، يجب تعيين دور المالك مع عنوان بريد إلكتروني تتم مراقبته لكل مشروع من مشاريعك.