الإصدارات

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختَر النظام الأساسي: Android iOS JavaScript

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

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

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

    المزايا:

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

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

    المزايا:

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

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

تثبيت

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

استخدام الكاكاو

مثال على تبعية Podfile باستخدام البنية Podfile:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '7.1.0'
end

استخدام قرطاج

مثال على تبعية Cartfile باستخدام بنية Cartfile:

binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1

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

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

استخدام Cocoapods

  1. افتح نافذة طرفية وانتقِل إلى الدليل الذي يحتوي على Podfile:

    cd <path-to-project>
  2. شغِّل pod outdated لمعرفة ما إذا كان إصدار أحدث من حزمة تطوير البرامج (SDK) للخرائط متوفّر لنظام التشغيل iOS.
  3. في حال العثور على إصدار أحدث من حزمة تطوير البرامج (SDK)، يُرجى تحديث Podfile باستخدام هذا الإصدار الجديد. راجِع تحديد إصدارات اللوحات للتعرّف على كيفية ضبط إصدار معيّن من Podfile.
  4. شغِّل pod update.
  5. أدخِل أي تغييرات ضرورية نتيجةً للترقية. يمكنك الاطّلاع على ملاحظات الإصدار للحصول على قائمة بالتغييرات في كل إصدار.
  6. يمكنك محو مشروعك وإعادة تصميمه عن طريق اختيار Product > Clean ثم Product > Build.

استخدام قرطاج

  1. افتح نافذة طرفية وانتقِل إلى الدليل الذي يحتوي على Podfile:

    cd <path-to-project>
  2. شغِّل carthage outdated لمعرفة ما إذا كان يتوفّر إصدار أحدث من"SDK للخرائط"لنظام التشغيل iOS.
  3. في حال العثور على إصدار أحدث من حزمة تطوير البرامج (SDK)، يُرجى تحديث Cartfile باستخدام هذا الإصدار الجديد. اطّلِع على متطلبات الإصدار للتعرّف على كيفية ضبط إصدار محدّد في Cartfile.
  4. شغِّل carthage update.
  5. أدخِل أي تغييرات ضرورية نتيجةً للترقية. يمكنك الاطّلاع على ملاحظات الإصدار للحصول على قائمة بالتغييرات في كل إصدار.
  6. يمكنك محو مشروعك وإعادة تصميمه عن طريق اختيار Product > Clean ثم Product > Build.

مطالبة يدوية

احصل على الرابط المؤدي إلى أحدث الملفات المصدر عند تثبيت حزمة تطوير البرامج (SDK).

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