الإعداد التجريبي

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

توضّح هذه الصفحة كيفية إعداد مكتبة الخدمات لحزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل iOS.

لتجربة هذه الأدوات، يمكنك تنفيذ أي مما يلي:

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

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

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

sudo gem install cocoapods

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

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

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

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

استخدام الملفات من 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.

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

في الحصول على مفتاح واجهة برمجة تطبيقات، عليك إنشاء مفتاح واجهة برمجة تطبيقات لتطبيقك. ويمكنك الآن إضافة هذا المفتاح إلى مشروع 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 للإصدار التجريبي، يمكنك اختيار الأداة المطلوب عرضها في التطبيق.
  • إذا كنت تشغّل إصدار Purpose-C للإصدار التجريبي، سيظهر لك الإصدار التجريبي من أداة تجميع العلامات. يمكنك بعد ذلك تعديل الإصدار التجريبي "الهدف من C" لتجربة كل أداة. اطّلِع على قسم إضافة أداة إلى تطبيقك أدناه لمزيد من المعلومات.

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

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

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

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

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '4.0.0'
  pod 'Google-Maps-iOS-Utils', '3.4.0'
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، ثم اختَر التالي).

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

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

إنشاء المشروع وتشغيله

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

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

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