الإعداد والعرض التوضيحي

استخدام أداة إدارة حِزم Swift

1. إذا لم يكن لديك مشروع Xcode حتى الآن، أنشئ مشروعًا الآن واحفظه على جهازك. (إذا كنت مبتدئًا في تطوير تطبيقات iOS، أنشئ مشروعًا جديدًا واختَر نموذج تطبيقات iOS. في Xcode 11.7 أو الإصدارات الأقدم، أنشئ تطبيقًا مزوّدًا بشاشة واحدة.)
2. أضِف حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS كعنصر تابع. اطّلِع على تثبيت حزمة SDK لمعرفة الخيارات المتاحة.
3. في مشروع Xcode، انتقِل إلى ملف -> حِزم Swift -> إضافة تبعية حزمة.
4. في النافذة التي تظهر، أدخِل عنوان URL لمستودع "مكتبة الأدوات" لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS https://github.com/googlemaps/google-maps-ios-utils وانقر على التالي.
• في هذه المرحلة، قد يُطلب منك المصادقة باستخدام حسابك على GitHub. اتّبِع التعليمات لإنشاء رمز GitHub شخصي للوصول لمواصلة العملية.
5. في النافذة التالية، اختَر خيار الإصدار، ثم اختَر حتى الإصدار الرئيسي التالي من القائمة المنسدلة، وأدخِل أحدث إصدار من حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS Utility Library (على سبيل المثال، "6.0.0").
6. انقر على القائمة المنسدلة بجانب الإضافة إلى المشروع، واختَر مشروعك، ثمّ انقر على إضافة حزمة.

استخدام CocoaPods

1. إذا لم يكن لديك مشروع Xcode حتى الآن، أنشئ مشروعًا الآن واحفظه على جهازك. (إذا كنت مبتدئًا في تطوير تطبيقات iOS، أنشئ تطبيقًا لعرض ملف واحد).
2. إذا لم يكن لديك ملف pod لمشروعك، أنشئ ملفًا باسم Podfile في دليل مشروعك. يحدّد هذا الملف تبعيات مشروعك.
3. عدِّل ملف podfile الخاص بمشروعك وأضِف تبعية على ملف Google-Maps-iOS-Utils pod. في ما يلي مثال على الملحقات التي تحتاج إليها لأجل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS ومكتبة الأدوات:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
   end

4. شغِّل pod install.
5. أغلِق Xcode، ثم افتح (انقر مرّتين) على ملف .xcworkspace الخاص بمشروعك لتشغيل Xcode. من الآن فصاعدًا، عليك استخدام ملف .xcworkspace لفتح المشروع.

ملاحظة: تعتمد أداة تجميع العلامات على الشكل الرباعي، ولكن يمكنك استخدام الشكل الرباعي بدون تجميع العلامات. إذا كنت تريد استخدام أداة شجرة رباعية الأبعاد فقط، يمكنك تغيير pod 'Google-Maps-iOS-Utils' إلى 'Google-Maps-iOS-Utils/QuadTree' في ملف pod.

استخدام ملفات من GitHub

1. نزِّل أرشيف نماذج الرموز البرمجية من GitHub وفكِّ ضغط الأرشيف.
2. افتح نافذة طرفية وانتقِل إلى الدليل الذي وسّعت فيه ملفّات العيّنات، ثم تنقّل إلى دليل العيّنات المناسب للغة التي تريد استخدامها:
   • بالنسبة إلى Swift، يمكنك تنفيذ cd google-maps-ios-utils-master/samples/SwiftDemoApp
   • بالنسبة إلى Objective-C، يمكنك تنفيذ cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. نفِّذ الأمر التالي:
   

   pod install

4. أغلِق Xcode، ثم افتح (انقر مرّتين) على ملف .xcworkspace الخاص بمشروعك لتشغيل Xcode. من الآن فصاعدًا، عليك استخدام ملف .xcworkspace لفتح المشروع.

Swift

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

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

   import GoogleMaps

2. عدِّل السطر التالي لإضافة مفتاح واجهة برمجة التطبيقات بين علامتَي الاقتباس:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

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

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

   @import GoogleMaps;

2. عدِّل السطر التالي لإضافة مفتاح واجهة برمجة التطبيقات بين علامتَي الاقتباس:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";