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

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

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

   pod install

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

استخدام CocoaPods v1.6.1

1. افتح نافذة أوامر طرفية وثبِّت الإصدار 1.6.1:

   sudo gem install cocoapods -v1.6.1

2. جلب ملفات "خرائط Google" باستخدام Cocoapods:

   pod try Google-Maps-iOS-Utils

   اختَر إما Swift أو Purpose-C عند الطلب. يعمل CocoaPods على تعديل مستودعات المواصفات ثم يفتح الإصدار التجريبي في مشروع Xcode مؤقت باسم SwiftDemoApp.xcodeproj أو 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 = @"";

استخدام الكاكاو

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

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '13.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '7.4.0'
     pod 'Google-Maps-iOS-Utils', '4.2.2'
   end

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

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

استخدام قرطاج

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

   github "googlemaps/google-maps-ios-utils"

5. احفظ Cartfile.
6. في نافذة المحطة الطرفية، انتقِل إلى الدليل الذي يتضمّن Cartfile:
   

   cd <path-to-project>

7. شغِّل أمر التحديث:
   

   carthage update --platform iOS

   
   سيؤدي ذلك إلى تثبيت واجهات برمجة التطبيقات المُحدَّدة في Cartfile، إلى جانب أي تبعيات قد تكون متوفرة لها.
8. في "الباحث"، في دليل المشروع، انتقِل إلى ملفات إطار العمل التي تم تنزيلها ضمن Carthage/Build/iOS.
9. أضِف حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS إلى مشروعك من خلال سحب الحِزم التالية إلى مشروعك. (اختَر نسخ العناصر عند الحاجة، يُرجى استخدام الإصدار نفسه كما هو موضّح أعلاه.)
   • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
   • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
   يجب أن يتضمّن عملاء خطة Premium أيضًا GoogleMaps-x.x.x/M4B/Frameworks/GoogleMapsM4B.framework.
10. انقر بزر الماوس الأيمن على GoogleMaps.framework في المشروع، واختَر إظهار في الباحث.
11. اسحب Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle من مجلد Resources إلى مشروعك. تأكّد من عدم اختيار نسخ العناصر إلى مجلد المجموعة المقصودة عندما يُطلب منك ذلك.
12. اختَر مشروعك من Project Navigator (أداة التنقّل) واختَر هدف التطبيق.
13. افتح علامة التبويب إصدار المراحل لاستهداف تطبيقك، وضمن ربط البرنامج الثنائي بالمكتبات، أضِف أُطر العمل التالية:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

14. اختَر مشروعك بدلاً من هدف محدّد، وافتح علامة التبويب Settings Settings (إعدادات الإصدار). في قسم علامات الروابط الأخرى، أضِف -ObjC. في حال عدم ظهور هذه الإعدادات، يمكنك تغيير الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.

استخدام مدير الحزم Swift

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