يُجري فريق "منصة خرائط 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 رسائل إلكترونية حول التغييرات غير المتوافقة مع الأنظمة القديمة والتي قد تؤثر في مشاريعهم. لتلقّي إشعارات استباقية بشأن التغييرات غير المتوافقة مع الأنظمة القديمة، يمكنك تعيين دور المالك باستخدام عنوان بريد إلكتروني خاضع للمراقبة لكل مشروع من مشاريعك.