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