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

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

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

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

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

    المزايا:

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

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

    المزايا:

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

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

تثبيت

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

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

dependencies {
    implementation 'com.google.android.gms:play-services-maps:18.1.0'
    // ...
}

يمكنك الاطّلاع على إرشادات إضافية حول إدارة إصدارات خدمات Google Play.

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

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

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