نظرة عامة على نماذج الرموز

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

استخدام الإصدارات التجريبية لحزمة تطوير البرامج (SDK)

يتوفّر التطبيق التجريبي لحزمة تطوير البرامج (SDK) لحزمة تطوير البرامج (SDK) لـ "خرائط Google" لأجهزة iOS باعتباره أرشيفًا للتنزيل من GitHub وكمجموعة CocoaPods. CocoaPods هي مديرة اعتمادية مفتوحة المصدر لمشروعات Swift وTarget-C Cocoa.

اتبع الخطوات التالية لتثبيت واستخدام الإصدار التجريبي من حزمة SDK لـ "خرائط Google" لنظام التشغيل iOS.

1. يمكنك الحصول على نماذج الملفات باستخدام إحدى الطريقتَين التاليتَين:
   

   من GitHub مباشرةً

   1. نزِّل أرشيف نموذج الرموز من GitHub وافتَح ملفات الأرشيف.
   2. افتح نافذة طرفية، وانتقِل إلى الدليل الذي وسّعت فيه نماذج الملفات، وتوغّل في دليل "خرائط Google":
      

      Swift

      cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-main/GoogleMaps

   3. نفِّذ الأوامر التالية:
      

      Swift

      pod install
      open GoogleMapsSwiftDemos.xcworkspace

      Objective-C

      pod install
      open GoogleMapsDemos.xcworkspace

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

   1. إذا لم تكن لديك أداة CocoaPods، يجب تثبيت الإصدار 1.6.1 على نظام التشغيل macOS من خلال تنفيذ الأمر التالي من الوحدة الطرفية. لمعرفة التفاصيل، يُرجى الاطّلاع على دليل البدء في CocoaPods.

      sudo gem install cocoapods -v1.6.1

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

      pod try GoogleMaps

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

2. في Xcode، اضغط على زر التحويل لإنشاء المخطط الحالي ثم شغِّله. ينتج عن الإصدار خطأ يُطلب منك إدخال مفتاح واجهة برمجة التطبيقات في ملف SDKConstants.swift الخاص بـ Swift أو ملف SDKDemoAPIKey.h لـ FALSE-C.
3. إذا لم يكن لديك مفتاح واجهة برمجة تطبيقات حتى الآن، اتّبِع instructions لإعداد مشروع على Google Cloud Console واحصل على مفتاح واجهة برمجة التطبيقات. عند ضبط المفتاح على Cloud Console، يمكنك تحديد معرّف حزمة تطبيقك لضمان أنّ تطبيقك فقط هو مَن يمكنه استخدام المفتاح. معرّف الحزمة التلقائي لنماذج حِزم SDK هو com.example.GoogleMapsDemos.
4. عدِّل ملف SDKConstants.swift الخاص بـ Swift أو ملف SDKDemoAPIKey.h الخاص بـ FALSE-C والصِق مفتاح واجهة برمجة التطبيقات الخاص بك في تعريف الثبات apiKey أو kAPIKey. مثال:

   Swift

   static let apiKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

5. أزِل السطر التالي، لأنه يُستخدم لتسجيل المشكلة التي يحددها المستخدم:

   Swift

   #error (Register for API Key and insert here. Then delete this line.”)

   Objective-C

   #error Register for API Key and insert here.

6. بناء المشروع وإدارته. ستظهر نافذة مُحاكي نظام التشغيل iOS تعرض قائمة بالعروض التوضيحية لحزمة تطوير البرامج (SDK) للخرائط.
7. حدِّد أحد الخيارات المعروضة لتجربة إحدى ميزات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS.
8. إذا طُلب منك السماح لتطبيق Google MapsDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.

استخدِم مقتطفات الرمز من دليل مطوِّر البرامج.

تتضمّن كل صفحة في دليل المطوِّر مقتطفات رمز توضّح ميزة معيّنة في واجهة برمجة التطبيقات. على سبيل المثال، يمكنك الاطّلاع على أدلة كائنات الخرائط والعلامات والأشكال والصفحات الأخرى في هذا الدليل.