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

اختَر النظام الأساسي: Android iOS

توضّح هذه الصفحة كيفية إعداد مكتبة الأدوات المساعدة لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS.

لتجربة هذه الأدوات المساعدة، يمكنك إجراء أي مما يلي:

تثبيت CocoaPods اختياريًا

تتوفّر مكتبة الأدوات على شكل مجموعة CocoaPods باسم Google-Maps-iOS-Utils. CocoaPods هي مديرة تعتمد على التبعية المفتوحة المصدر لمشروعات Swift وObjective-C Cocoa.

إذا لم يسبق لك تثبيت أداة CocoaPods، يمكنك تثبيتها على نظام التشغيل macOS من خلال تنفيذ الأمر التالي من الوحدة الطرفية:

sudo gem install cocoapods

لمعرفة التفاصيل، يُرجى الاطّلاع على دليل البدء في CocoaPods.

تثبيت التطبيق التجريبي وتشغيله

تتضمن مكتبة الأدوات تطبيقًا تجريبيًا يمكنك تثبيته ثم تجربة كل أداة مساعدة.

يمكنك تثبيت التطبيق التجريبي باستخدام إحدى الطريقتَين التاليتَين:

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

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

استخدام الإصدار 1.6.1 من CocoaPods

  1. افتح نافذة طرفية وثبِّت الإصدار 1.6.1: 
    sudo gem install cocoapods -v1.6.1
  2. استرجاع ملفات "خرائط Google" باستخدام Cocoapods: 
    pod try Google-Maps-iOS-Utils

    اختر إما Swift أو Objective-C عندما يُطلب منك ذلك. تعمل CocoaPods على تعديل مستودعات المواصفات الخاصة بك، ثم تفتح العرض التوضيحي في مشروع Xcode مؤقت باسم SwiftDemoApp.xcodeproj أو ObjCDemoApp.xcodeproj.

إضافة مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي

في الحصول على مفتاح واجهة برمجة تطبيقات، يمكنك إنشاء مفتاح واجهة برمجة تطبيقات لتطبيقك. ويمكنك الآن إضافة هذا المفتاح إلى مشروع Xcode للتطبيق التجريبي.

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

إنشاء التطبيق التجريبي وتشغيله

بعد إضافة مفتاح واجهة برمجة التطبيقات، يمكنك إنشاء المشروع وتشغيله:

  • إذا كنت تقوم بتشغيل إصدار Swift من العرض التوضيحي، فيمكنك تحديد الأداة المساعدة لعرضها في التطبيق.
  • في حال تشغيل الإصدار Objective-C من العرض التوضيحي، سترى عرضًا توضيحيًا لأداة تجميع العلامات. يمكنك بعد ذلك تعديل إصدار Objective-C من العرض التوضيحي لتجربة كل أداة مساعدة. راجع قسم إضافة أداة مساعدة إلى تطبيقك أدناه لمزيد من المعلومات.

تثبيت مكتبة الأدوات كمشروع Xcode

اتبع هذه الخطوات لإضافة مكتبة الأدوات إلى مساحة عمل Xcode:

استخدام CocoaPods

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

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

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

  1. ثبِّت قرطاج. تتوفر عدة طرق، لذلك راجِع ملف README بقرطاج لمعرفة الخطوات الدقيقة.
  2. إذا لم يكن لديك مشروع Xcode حتى الآن، يمكنك إنشاء مشروع الآن وحفظه على جهازك المحلي. (إذا كنت حديث العهد بتطوير تطبيقات iOS، أنشئ مشروعًا جديدًا واختَر نموذج تطبيق iOS. في Xcode 11.7 أو الإصدارات الأقدم، أنشئ تطبيق عرض فردي).
  3. أنشئ ملفًا باسم Cartfile في دليل مشروعك. يحدد هذا الملف تبعيات مشروعك.
  4. عدِّل Cartfile وأضِف حزمة تطوير البرامج (SDK) لـ "خرائط Google" لمكتبة الأدوات التي توفّرها iOS:
    github "googlemaps/google-maps-ios-utils"
  5. احفظ Cartfile.
  6. في نافذة طرفية، انتقِل إلى الدليل الذي يحتوي على Cartfile:
    cd <path-to-project>
  7. شغِّل الأمر update:
    carthage update --platform iOS

    سيؤدي ذلك إلى تثبيت واجهات برمجة التطبيقات المحدَّدة في Cartfile، بالإضافة إلى أي تبعيات قد تكون لديك.
  8. في Finder (الباحث)، وفي دليل مشروعك، انتقِل إلى ملفات إطار العمل التي تم تنزيلها ضمن Carthage/Build/iOS.
  9. أضف حزمة تطوير البرامج للخرائط (SDK) للخرائط إلى أطر عمل 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
  10. انقر بزر الماوس الأيمن على GoogleMaps.framework في مشروعك، واختَر إظهار في Finder (الباحث).
  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. اختَر مشروعك بدلاً من هدف محدّد، وافتح علامة التبويب إعدادات الإنشاء. في القسم علامات رابط أخرى، أضِف -ObjC. إذا لم تظهر هذه الإعدادات، عليك تغيير الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.

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

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

إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك

راجِع إعداد مشروع Xcode للحصول على تعليمات حول إنشاء مفتاح واجهة برمجة التطبيقات وإضافته إلى مشروع Xcode لديك.

بناء المشروع وإدارته

بعد إضافة مفتاح واجهة برمجة التطبيقات، يمكنك إنشاء المشروع وتشغيله.

إضافة أداة مساعدة إلى تطبيقك

اطلع على وثائق كل أداة للحصول على مزيد من المعلومات حول استخدامها في تطبيقك: