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

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

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

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

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

    المزايا:

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

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

    المزايا:

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

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

تثبيت

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

dependencies {

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

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

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

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

إذا كنت بصدد الترقية من الإصدار 3.2.0 أو إصدار أقدم من حزمة تطوير البرامج Places SDK لنظام التشغيل Android

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

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

  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) الجديدة.