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

استخدام Swift Package Manager

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

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

1. نزِّل أرشيف عيّنة التعليمات البرمجية من GitHub وفكّ ضغط الأرشيف. يمكنك بدلاً من ذلك استنساخ المستودع في دليل محلي:

   git clone https://github.com/googlemaps/google-maps-ios-utils.git

2. افتح نافذة طرفية، وانتقِل إلى الدليل الذي وسّعت فيه نطاق الملفات النموذجية، ثم انتقِل إلى دليل النماذج المناسب للغة التي تريد استخدامها:

   Swift

   cd google-maps-ios-utils/samples/SwiftDemoApp
   open SwiftDemoApp.xcodeproj

   Objective-C

   cd google-maps-ios-utils/samples/ObjCDemoApp
   open ObjCDemoApp.xcodeproj

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 = @"";