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

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

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

عروض توضيحية لحزمة تطوير البرامج (SDK)

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

اتّبِع هذه الخطوات لتثبيت التطبيق التجريبي "خرائط Google" SDK لنظام التشغيل 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

   استخدام CocoaPods v1.6.1

   1. إذا لم تكن لديك أداة CocoaPods، يمكنك تثبيت الإصدار 1.6.1 على نظام التشغيل macOS من خلال تنفيذ الأمر التالي من الوحدة الطرفية. لمعرفة التفاصيل، يُرجى الاطّلاع على دليل البدء في استخدام CocoaPods.
      هناك مشكلة معروفة في 'pod try' في إصدار CocoaPods 1.8.1 والإصدارات الأحدث. إذا كنت تريد استرجاع الملفات باستخدام Cocoapods، ننصحك باستخدام الإصدار 1.6.1 من CocoaPods. ويمكنك بدلاً من ذلك تنزيل نماذج الملفات من GitHub.

      sudo gem install cocoapods -v1.6.1

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

      pod try GoogleMaps

      اختَر إما Swift أو Purpose-C عند الطلب. يعمل CocoaPods على تعديل مستودعات المواصفات ثم يفتح الإصدار التجريبي في مشروع Xcode مؤقت باسم SwiftDemoApp.xcodeproj أو ObjCDemoApp.xcodeproj.

2. في Xcode، اضغط على زر التجميع لإنشاء المخطط الحالي ثم تشغيله. ينتج عن الإصدار خطأ، يُطلب منك فيه إدخال مفتاح واجهة برمجة التطبيقات في ملف SDKConstants.swift لـ Swift أوSDKDemoAPIKey.h لملف Purpose-C.
3. إذا لم يكن لديك مفتاح واجهة برمجة تطبيقات بعد، اتّبِع التعليمات لإعداد مشروع على Google Cloud Console والحصول على مفتاح لواجهة برمجة التطبيقات. عند ضبط المفتاح في Cloud Console، يمكنك تحديد معرِّف حزمة تطبيقك لضمان إمكانية استخدام المفتاح فقط في تطبيقك. رقم تعريف الحزمة التلقائي لتطبيق عيّنات حزم تطوير البرامج (SDK) هو com.example.GoogleMapsDemos.
4. يُرجى تعديل ملف SDKConstants.swift لـ Swift أوSDKDemoAPIKey.h لهدف 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. حدِّد أحد الخيارات المعروضة، لتجربة إحدى ميزات حزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل iOS.
8. إذا طُلب منك السماح لتطبيق GoogleMapsDemos بالوصول إلى موقعك الجغرافي، اختَر السماح.

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

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