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

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-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) الخاصة بـ Places API لنظام التشغيل iOS بنظام تحديد الإصدارات الدلالي، وتتضمّن الإصدارات الرئيسية الجديدة تغييرات مؤدية إلى عطل.

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

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

platform :ios, '16.0'

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