حزمة تطوير برامج الأماكن لإصدارات Android

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

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

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

ما هو الإصدار الذي يجب الربط به؟

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

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

  المزايا:

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

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

  المزايا:

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

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

تثبيت

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

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:5.1.1")
}

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

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

ملاحظة: الحد الأدنى لمستوى واجهة برمجة التطبيقات المطلوب لإصدار 19.0.x من حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android هو المستوى 23 من واجهة برمجة التطبيقات Android ("Marshmallow"؛ Android 6.0) أو مستوى أعلى.

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

إذا كنت بصدد الترقية من الإصدار 3.2.0 أو إصدار أقدم من "حزمة تطوير برامج الأماكن لأجهزة Android"

لا يلزم نقل البيانات عند الانتقال إلى حزمة SDK الجديدة. ما عليك سوى إجراء ما يلي:

1. تفعيل واجهة برمجة التطبيقات Places API (الجديدة) على مفتاح واجهة برمجة التطبيقات المستخدَم في تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة استخدام مفاتيح واجهة برمجة التطبيقات.

2. في قسم dependencies من ملف build.gradle على مستوى الوحدة، يجب تعديل الاعتمادية places وإضافة الاعتمادية kotlin-bom:

     dependencies {
         implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
         implementation 'com.google.android.libraries.places:places:3.5.0'
     }

   لمزيد من المعلومات عن الاعتمادية kotlin-bom، يُرجى الاطّلاع على مقالة استخدام أحدث إصدار من kotlin-stdlib في التبعيات المتعدية.

3. يجب تعديل تطبيقك الحالي لاستدعاء الطريقة الجديدة Places.initializeWithNewPlacesApiEnabled() لتهيئة تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تهيئة عميل Places API.

ستستمر تطبيقاتك الحالية في العمل بدون تغيير، ولكن يمكنك الآن الاستفادة من جميع ميزات حزمة SDK الجديدة.