حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لإصدارات iOS

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

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

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

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

    المزايا:

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

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

    المزايا:

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

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

تثبيت

مدير حِزم Swift

يمكن تثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS عبر Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي حزمة SDK حالية من "خرائط Google" لتطبيقات iOS.

لإضافة حزمة SDK إلى مشروع جديد أو حالي، يُرجى اتّباع الخطوات التالية:

  1. افتح Xcode project أو workspace، ثم انتقِل إلى ملف > إضافة تبعيات الحزمة.
  2. أدخِل https://github.com/googlemaps/ios-maps-sdk كعنوان URL، واضغط على Enter لسحب الحزمة، ثم انقر على "Add Package".
  3. لتثبيت version محدّد، اضبط الحقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار واستخدام الخيار "Exact Version". بعد الانتهاء من التعديل، انقر على "Add Package" (إضافة حزمة).
  4. من نافذة اختيار منتجات الحِزم، تأكَّد من أنّه ستتم إضافة GoogleMaps وGoogleMapsBase وGoogleMapsCore إلى هدف main المحدّد. بعد الانتهاء من التعديل، انقر على "Add Package" (إضافة حزمة).
  5. للتحقّق من التثبيت، انتقِل إلى جزء General المستهدَف. في إطارات الأطر والمكتبات والمحتوى المضمَّن، من المفترض أن تظهر لك الحِزم المثبَّتة. يمكنك أيضًا عرض القسم "تبعيات الحزمة" في "Project Navigator" للتحقق من الحزمة وإصدارها.

لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:

  1. من Xcode، انتقل إلى "ملف > الحزم > التحديث إلى أحدث إصدارات الحزمة".
  2. للتحقّق من التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.

لإزالة حزمة تطوير البرامج (SDK) الحالية في "خرائط Google" لتطبيقات iOS التي تمت إضافتها باستخدام CocoaPods، اتّبِع الخطوات التالية:

  1. أغلِق مساحة عمل Xcode. افتح الوحدة الطرفية ونفِّذ الأمر التالي:
    sudo gem install cocoapods-deintegrate cocoapods-clean 
    pod deintegrate 
    pod cache clean --all
  2. عليك إزالة Podfile وPodfile.resolved وXcode workspace في حال عدم استخدامها لأي منتج آخر غير CocoaPods.

CocoaPods

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

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

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

platform :ios, '14.0'

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

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

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

مدير حِزم Swift

لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:

  1. من Xcode، انتقل إلى "ملف > الحزم > التحديث إلى أحدث إصدارات الحزمة".
  2. للتحقّق من التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.

كاكابود

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

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

يدوي

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

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