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

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

ملاحظة: يتم تحديد ميزات Places SDK لنظام التشغيل iOS المتاحة في تطبيقك من خلال مجموعة من رقم إصدار حزمة SDK الذي تحدّده في إعدادات تطبيقك وواجهات برمجة التطبيقات المفعَّلة في مفتاح واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة اختيار إصدار حزمة SDK.

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

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

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

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

  المزايا:

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

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

  المزايا:

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

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

تثبيت

Swift Package Manager

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

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

1. افتح Xcode project‏ أو workspace، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies).
2. أدخِل https://github.com/googlemaps/ios-places-sdk كعنوان URL، واضغط على مفتاح Enter لسحب الحزمة، ثم انقر على "إضافة حزمة".
3. لتثبيت version معيّن، اضبط الحقل قاعدة الاعتمادية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار واستخدام الخيار "الإصدار الدقيق". بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة".
4. من نافذة اختيار منتجات الحزمة، تأكَّد من أنّه ستتم إضافة GooglePlaces أو GooglePlacesSwift أو كليهما إلى الهدف الرئيسي المحدّد. بعد إتمام الخطوة السابقة، انقر على إضافة حزمة.

   في حال تحديث Google Places Swift من عنوان URL المتوقّف نهائيًا على GitHub

   ملاحظة مهمة: تم تغيير عنوان URL على GitHub للوصول إلى Google Places Swift بدءًا من الإصدار 0.3.0. إذا كنت بصدد تحديث إصدار من GooglePlacesSwift تم الوصول إليه من خلال عنوان URL القديم، https://github.com/googlemaps/ios-places-swift-sdk، عليك إزالته من قسم تبعيات الحزمة في Xcode.

5. للتحقّق من التثبيت، انتقِل إلى لوحة عام في الهدف. في الأطر والمكتبات والمحتوى المضمّن، من المفترض أن تظهر لك الحِزم المثبَّتة. يمكنك أيضًا الاطّلاع على قسم تبعيات الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.

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

1. من Xcode، انتقِل إلى ملف (File) > الحِزم (Packages) > التحديث إلى آخر إصدارات الحِزم (Update to Latest Package Versions).

   في حال تحديث Google Places Swift من عنوان URL المتوقّف نهائيًا على GitHub

   ملاحظة مهمة: تم تغيير عنوان URL على GitHub للوصول إلى Google Places Swift بدءًا من الإصدار 0.3.0. إذا كنت بصدد تحديث إصدار من GooglePlacesSwift تم الوصول إليه من خلال عنوان URL القديم، https://github.com/googlemaps/ios-places-swift-sdk، عليك إزالته من قسم تبعيات الحزمة في Xcode.

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

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

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

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

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 رسائل إلكترونية حول التغييرات غير المتوافقة مع الأنظمة القديمة والتي قد تؤثر في مشاريعهم. لتلقّي إشعارات استباقية بشأن التغييرات غير المتوافقة مع الأنظمة القديمة، عليك تعيين دور المالك باستخدام عنوان بريد إلكتروني خاضع للمراقبة لكل مشروع من مشاريعك.