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

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

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

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

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

    المزايا:

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

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

    المزايا:

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

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

تثبيت

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

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" تلقائيًا من الإصدارات الأحدث المتوفّرة ويعرض تحذيرًا عند توفُّر إصدار أحدث من التبعية. للحدّ من الديون التقنية، عليك الترقية إلى أحدث إصدار متوفّر في أقرب وقت ممكن. إذا كنت بصدد التحديث إلى إصدار رئيسي جديد، راجِع ملاحظات الإصدار للاطّلاع على التغييرات غير المتوافقة مع الأنظمة القديمة ومعرفة كيفية تعديل الرموز البرمجية.

بالإضافة إلى استطلاع الرأي حول الإصدارات الأحدث، يتلقى مالكو المشروعات على 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.3.0'
      }

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

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

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