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

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

تصف هذه الصفحة كيفية إعداد مكتبة الخدمات العامة لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS

لتجربة هذه البرامج، يمكنك تنفيذ أحد الإجراءَين التاليَين:

إضافة حزمة تطوير البرامج (SDK) لـ "خرائط Google" لمكتبة تطبيقات iOS إلى مشروع Xcode

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

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

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

استخدام CocoaPods

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

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

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

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

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

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

استخدام أداة في تطبيقك

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

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

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

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

استخدام الملفات من 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 لفتح المشروع.

استخدام الإصدار 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 للعرض التوضيحي لتجربة كل أداة مساعدة. يُرجى الاطّلاع على القسم إضافة أداة إلى تطبيقك أدناه لمعرفة مزيد من المعلومات.