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

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

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

أي إصدار يجب ربطه؟

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

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

  المزايا:

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

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

  المزايا:

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

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

تثبيت

Swift Package Manager

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

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

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

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

1. إذا كنت بصدد الترقية من إصدار أقدم من 9.0.0، عليك إزالة موارد الاعتمادية التالية: GoogleMapsBase وGoogleMapsCore وGoogleMapsM4B بعد الترقية. لا تُزِل الاعتمادية الخاصة بـ GoogleMaps. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات الإصدار 9.0.0.

   من إعدادات ضبط مشروع Xcode، ابحث عن الأطر والمكتبات والمحتوى المضمن. استخدِم علامة الطرح(-) لإزالة الإطار التالي:

   • GoogleMapsBase (للترقيات من إصدارات أقدم من 9.0.0 فقط)
   • GoogleMapsCore (للترقيات من إصدارات أقدم من 9.0.0 فقط)
   • GoogleMapsM4B (للترقيات من إصدارات أقدم من 9.0.0 فقط)
2. من Xcode، انتقِل إلى ملف (File) > الحِزم (Packages) > التحديث إلى آخر إصدارات الحِزم (Update to Latest Package Versions).
3. للتحقّق من التثبيت، انتقِل إلى قسم تبعيّات الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.

ملاحظة مهمة: في بعض الأحيان، لا يمكن حلّ العناصر أو قد تحدث أخطاء، وفي هذه الحالة، اختَر "ملف > الحزم > إعادة ضبط ذاكرة التخزين المؤقت للحزمة".

لإزالة موارد الاعتمادية الحالية لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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.

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

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

Swift Package Manager

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

التثبيت اليدوي

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

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