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

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

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

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

ما هو الإصدار الذي تريد الربط به؟

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

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

  المزايا:

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

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

  المزايا:

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

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

تثبيت

Swift Package Manager

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

ملاحظة مهمة: تفترض هذه التعليمات استخدام الإصدار 15 من Xcode أو إصدار أحدث، ولكن من المفترض أن تكون الخطوات مشابهة في الإصدارات السابقة من Xcode.

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

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

لتعديل 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. للتحقّق من عملية التثبيت، انتقِل إلى قسم متطلبات الحزمة في مستكشف المشاريع للتحقّق من الحزمة وإصدارها.

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

CocoaPods

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

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

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

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.1.0'
  pod 'GooglePlacesSwift', '10.1.0'
end

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

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

Swift Package Manager

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

1. للتحقّق من عملية التثبيت، انتقِل إلى قسم متطلبات الحزمة في مستكشف المشاريع للتحقّق من الحزمة وإصدارها.

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

Cocoapods

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

   cd <path-to-project>

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

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

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

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