إعداد مشروع Xcode

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. من نافذة اختيار منتجات الحزمة، تأكَّد من أنّه ستتم إضافة 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.

1. من إعدادات ضبط مشروع Xcode، ابحث عن الأطر والمكتبات والمحتوى المضمن. استخدِم علامة الطرح (-) لإزالة الإطار التالي:
   • GoogleMaps
   • GoogleMapsBase (لعمليات التثبيت الأقدم من الإصدار 9.2.0 فقط)
   • GoogleMapsCore (لعمليات التثبيت الأقدم من الإصدار 9.2.0 فقط)
   • GoogleMapsM4B (لعمليات التثبيت الأقدم من الإصدار 9.0.0 فقط)
2. من الدليل ذي المستوى الأعلى لمشروع Xcode، أزِل حزمة GoogleMaps.

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

يوضّح هذا الدليل كيفية إضافة XCFrameworks التي تحتوي على حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS إلى مشروعك يدويًا، وكيفية ضبط إعدادات الإصدار في Xcode. ‫XCFramework هي حزمة ثنائية يمكنك استخدامها على منصات متعددة، بما في ذلك الأجهزة التي تستخدم معالج Apple.

1. نزِّل الملفات الثنائية وملفات الموارد التالية لحزمة SDK:
   • GoogleMaps
   • GoogleMapsResources
2. استخرِج الملفات للوصول إلى حِزم XCFrameworks والموارد.
3. إذا لم يكن لديك مشروع Xcode حتى الآن، يمكنك إنشاء مشروع الآن وحفظه على جهازك. إذا كنت مبتدئًا في تطوير تطبيقات iOS:
   1. أنشِئ مشروعًا جديدًا.
   2. اختَر نموذج iOS > App (تطبيق iOS).
   3. على شاشة خيارات المشروع:
      1. أدخِل اسم المشروع.
      2. سجِّل قيمة حقل معرّف الحزمة. يمكنك استخدام هذه القيمة لفرض قيود على مفتاح واجهة برمجة التطبيقات أدناه.
      3. اضبط واجهة المشروع على Storyboard.
      4. اضبط اللغة على Swift أو Objective-C.
4. افتح علامة التبويب عام. اسحب XCFrameworks التالية إلى مشروعك ضمن الأطر والمكتبات والمحتوى المضمّن. احرص على اختيار عدم التضمين:
   • GoogleMaps.xcframework
5. انسخ GoogleMaps.bundle من GoogleMapsResources الذي نزّلته إلى الدليل ذي المستوى الأعلى لمشروع Xcode. احرص على اختيار نسخ العناصر إلى مجلد المجموعة الوجهة عندما يُطلب منك ذلك.
6. اختَر مشروعك من "مستكشف المشروع" (Project Navigator)، ثم اختَر هدف تطبيقك.
7. افتح علامة التبويب مراحل الإنشاء (Build Phases) الخاصة بهدف تطبيقك. في ربط الملفات الثنائية بالمكتبات (Link Binary with Libraries)، أضِف أُطر العمل والمكتبات التالية:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework (فقط في حال استخدام OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. اختَر مشروعك بدلاً من هدف معيّن، وافتح علامة التبويب إعدادات الإصدار (Build Settings). في قسم Linking - General -> Other Linker Flags، أضِف -ObjC إلى "Debug" و "Release". إذا لم تظهر هذه الإعدادات، غيِّر الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.

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

Swift

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.swift على النحو التالي:

1. أضِف عبارة الاستيراد التالية:

   import GoogleMaps

2. أضِف ما يلي إلى طريقة application(_:didFinishLaunchingWithOptions:)، باستخدام مفتاح واجهة برمجة التطبيقات:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. إذا كنت تستخدم أيضًا Places API، أضِف مفتاحك مرة أخرى كما هو موضّح هنا:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.m على النحو التالي:

1. أضِف عبارة الاستيراد التالية:

   @import GoogleMaps;

2. أضِف ما يلي إلى طريقة application:didFinishLaunchingWithOptions:، باستخدام مفتاح واجهة برمجة التطبيقات:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. إذا كنت تستخدم أيضًا Places API، أضِف مفتاحك مرة أخرى كما هو موضّح هنا:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];