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