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

أداة إدارة حِزم Swift

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

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

1. افتح Xcode project أو workspace، ثم انتقِل إلى ملف > إضافة تبعيات الحزمة.
2. أدخِل https://github.com/googlemaps/ios-maps-sdk كعنوان URL، واضغط على مفتاح Enter لسحب الحزمة، ثم انقر على "إضافة حزمة".
3. لتثبيت version معيّن، اضبط حقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار و استخدام الخيار "الإصدار المحدّد". بعد الانتهاء، انقر على "إضافة حزمة".

لتعديل 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، انتقِل إلى "ملف > حِزم > التحديث إلى أحدث إصدارات الحِزم".
3. للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في 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, '15.0'

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