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

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

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

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

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

  المزايا:

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

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

  المزايا:

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

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

تثبيت

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

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

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

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

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

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

ليس من الضروري إجراء عملية نقل عند الانتقال إلى حزمة تطوير البرامج (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) الجديدة.