حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لإصدارات Android

اختيار النظام الأساسي: Android iOS JavaScript

يُحدِّث فريق "منصة خرائط Google" حِزم تطوير البرامج (SDK) بانتظام بميزات جديدة وإصلاحات للأخطاء وتحسينات في الأداء. توفر هذه الصفحة إرشادات حول كيفية إدارة التبعيات على حزم SDK للجوّال.

  • بالنسبة إلى التطبيقات الأساسية للمهام، اربط بأحدث إصدار من نقطة الإصدار الرئيسي الذي تستخدمه (X.*)، وأجرِ الترقية سنويًا إلى الإصدار الرئيسي الجديد.

    مع طرح إصدارات جديدة من تطبيقك على مدار العام، يمكنك البدء في استخدام إصدارات أحدث من حزمة تطوير البرامج (SDK) لـ "خرائط Google" للتطبيقات المتوافقة مع Android. لن يتطلّب هذا الإجراء إجراء تحديثات في تطبيقك لأنّ إصدارات النقاط الجديدة متوافقة مع الأنظمة القديمة.

    المزايا:

    • إذا اكتشفت مشاكل في حزمة تطوير البرامج (SDK) لـ "خرائط Google" لنظام التشغيل Android، سيتم تقديم الإصلاحات بطريقة متوافقة مع الأنظمة القديمة لمدة 12 شهرًا بعد الإصدار الأوّلي للإصدار الرئيسي، وفقًا لسياسة الدعم على الأجهزة الجوّالة. لن تحتاج إلى الترقية بشكل عاجل إلى إصدار incompatible من حزمة تطوير البرامج (SDK) للاستفادة من الإصلاحات.
    • يسهل استخدام آخر التحسينات والميزات عندما يكون تطبيقك مبنيًا على أحدث إصدار.
    • إنّ التحديثات السنوية المتزايدة لأحدث إصدار رئيسي من حزمة SDK قد تتطلّب جهدًا أقل لتعديل تطبيقك وإعادة كتابته واختباره، بدلاً من التعامل مع التغييرات غير المتوافقة مع الأنظمة القديمة التي يتم تقديمها في العديد من الإصدارات الرئيسية ضمن الإصدارات الرئيسية.

  • بالنسبة إلى التطبيقات غير المهمة، اربطها بأي إصدار ثابت. وعندما تتلقّى إشعارًا بالإيقاف النهائي لهذا الإصدار الذي تم إصلاحه، سيكون أمامك 12 شهرًا لإتاحة رمز التطبيق المعدّل للمستخدمين.

    المزايا:

    • أعمال صيانة أقل تكرارًا.
    • تستمر الإصدارات الجديدة من تطبيقك في دعم أجهزة المستخدمين التي تعمل بأنظمة تشغيل قديمة للأجهزة الجوّالة لمدة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة تطوير البرامج (SDK).

يتلقى مالكو المشروعات الذين لديهم عناوين بريد إلكتروني خاضعة للمراقبة إشعارات استباقية حول التغييرات التي تؤثر على كل مشروع من مشروعاتهم. ابقَ على اطّلاع على التحديثات الرئيسية وعمليات الإيقاف النهائي والتغييرات الأخرى.

تثبيت

في ملف build.gradle على مستوى التطبيق، حدِّد دائمًا إصدارًا بدلاً من نطاق البادئة (+) أو latest لأنّه قد يؤدي إلى إصدارات غير متوقّعة وغير قابلة للتكرار. تلتزم حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android بالإصدارات الدلالية، وقد تتضمن الإصدارات الرئيسية الجديدة تغييرات قد تؤدي إلى أعطال. الحد الأدنى لمستوى واجهة برمجة التطبيقات المعتمد هو 19.

تحديد تبعية "خرائط Google" ضمن خدمات Google Play باستخدام بنية Gradle.

dependencies {

    // Maps SDK for Android
    implementation 'com.google.android.gms:play-services-maps:18.2.0'
}

اطّلِع على إرشادات إضافية بشأن إدارة إصدارات خدمات Google Play.

الصيانة والترقية

يتحقّق "استوديو Android" تلقائيًا من توفُّر إصدارات أحدث متوفّرة ويقدّم تحذيرًا عند توفّر إصدار أحدث من الاعتمادية. للحدّ من الديون التقنية، عليك الترقية إلى أحدث إصدار متوفّر في أقرب وقت ممكن. في حال التحديث إلى إصدار رئيسي جديد، يمكنك الاطّلاع على ملاحظات الإصدار لمعرفة التغييرات غير المتوافقة مع الأنظمة القديمة ومعرفة كيفية تعديل الرموز البرمجية.

بالإضافة إلى الاستطلاعات بشأن الإصدارات الأحدث، يتلقّى مالكو المشاريع على Google Cloud رسائل إلكترونية حول التغييرات غير المتوافقة مع الإصدارات القديمة والتي قد تؤثر في مشاريعهم. لتلقّي إشعار استباقي بشأن التغييرات غير المتوافقة مع الأنظمة القديمة، يمكنك إسناد دور المالك إلى عنوان بريد إلكتروني يتم تتبُّعه لكل مشروع من مشروعاتك.