إعداد مشروع Xcode

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

تتوفّر ملاحظات الإصدار لكل إصدار.

الخطوة 1: تثبيت البرامج المطلوبة

لإنشاء مشروع باستخدام حزمة تطوير البرامج للتنقّل على أجهزة iOS، يجب تنزيل وتثبيت ما يلي:

  • Xcode الإصدار 26.0 أو إصدار أحدث

الخطوة 2: إنشاء مشروع Xcode وتثبيت حزمة تطوير البرامج للتنقّل

Swift Package Manager

يمكن تثبيت حزمة تطوير البرامج للتنقّل من خلال Swift Package Manager. لإضافة حزمة تطوير البرامج، تأكَّد من إزالة أيّ تبعيات حالية لحزمة تطوير البرامج للتنقّل.

لإضافة حزمة تطوير البرامج إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:

  1. افتح Xcode project أو workspace، ثمّ انتقِل إلى File > Add Package Dependencies.
  2. أدخِل https://github.com/googlemaps/ios-navigation-sdk كعنوان URL، واضغط على مفتاح الإدخال لجلب الحزمة، ثمّ انقر على "إضافة حزمة".
  3. لتثبيت version معيّن، اضبط الحقل قاعدة الاعتمادية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار واستخدام الخيار "الإصدار الدقيق". بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة".
  4. من النافذة اختيار منتجات الحزمة ، تأكَّد من أنّه سيتمّ إضافة GoogleNavigation إلى هدفك main المحدّد. بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة".
  5. للتأكّد من التثبيت، انتقِل إلى لوحة عام الخاصة بالهدف. ضمن الأطر والمكتبات والمحتوى المضمّن ، يجب أن تظهر الحِزم المثبَّتة. يمكنك أيضًا عرض قسم "موارد الاعتمادية للحزمة" في "مستكشف المشروع" للتأكّد من الحزمة وإصدارها.

لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:

  1. من Xcode، انتقِل إلى ملف > الحِزم > التحديث إلى آخر إصدارات الحِزم (File > Packages > Update To Latest Package Versions).
  2. للتأكّد من التثبيت، انتقِل إلى قسم موارد الاعتمادية للحزمة في مستكشف المشروع للتأكّد من الحزمة وإصدارها.

لإزالة حزمة تطوير البرامج للتنقّل على أجهزة iOS المثبَّتة يدويًا، اتّبِع الخطوات التالية:
  1. من إعدادات ضبط مشروع Xcode، ابحث عن الأطر والمكتبات، والمحتوى المضمّن. استخدِم علامة الطرح(-) لإزالة الإطار التالي:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. من دليل المستوى الأعلى لمشروع Xcode، أزِل حزمة GoogleMaps.

التثبيت اليدوي

يوضّح هذا الدليل كيفية إضافة XCFrameworks التي تحتوي على حزمة تطوير البرامج للتنقّل على أجهزة iOS، وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS إلى مشروعك يدويًا، وكيفية ضبط إعدادات الإصدار في Xcode. ‫XCFramework هي حزمة ثنائية يمكنك استخدامها على منصات متعدّدة، بما في ذلك الأجهزة التي تستخدم شريحة تعريف M1

اتّبِع الخطوات التالية لتثبيت XCFrameworks لحزمة تطوير البرامج للتنقّل على أجهزة iOS، وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS:

  1. نزِّل الملفات الثنائية وملفات الموارد التالية لحزمة تطوير البرامج:
  2. شغِّل Xcode وافتح مشروعًا حاليًا أو أنشئ مشروعًا جديدًا. إذا كنت جديدًا على iOS، أنشئ مشروعًا جديدًا واختَر الـ نموذج تطبيق iOS.
  3. أزِل كلّ المراجع الحالية إلى "خرائط Google" و"التنقّل" و"الأماكن" من المشروع.
  4. اسحب XCFrameworks التالية إلى مشروعك ضمن الأطر والمكتبات والمحتوى المضمّن لتثبيت كلّ من حزمتَي تطوير البرامج بالاستناد إلى بيانات "خرائط Google" و"التنقّل" (عندما يُطلب منك ذلك، انقر على نسخ العناصر إذا لزم الأمر):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. اسحب GoogleMaps.bundle من GoogleMapsResources الذي نزّلته إلى دليل المستوى الأعلى لمشروع Xcode. عندما يُطلب منك ذلك، تأكَّد من اختيار نسخ العناصر إذا لزم الأمر.
  6. اسحب GoogleNavigation.bundle من GoogleNavigationResources الذي نزّلته إلى دليل المستوى الأعلى لمشروع Xcode. عندما يُطلب منك ذلك، تأكَّد من اختيار نسخ العناصر إلى مجلد مجموعة الوجهة.
  7. اختَر مشروعك من "مستكشف المشروع"، ثمّ اختَر هدف تطبيقك.
  8. افتح علامة التبويب مراحل الإصدار ، وضِمن ربط الملفات الثنائية بالمكتبات (Link Binary with Libraries)، أضِف أُطر العمل والمكتبات التالية:
    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CarPlay.framework
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • MapKit.framework
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • Security.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • UserNotifications.framework
    • WebKit.framework
  9. في هدف تطبيقك، اختَر علامة التبويب الإمكانات، فعِّل أوضاع التشغيل في الخلفية، ثمّ فعِّل الأوضاع التالية:
    • الصوت وAirPlay و"نافذة ضمن النافذة"
    • إشعار بشأن الموقع الجغرافي
  10. اختَر مشروعك بدلاً من هدف معيّن، وافتح علامة التبويب Build Settings. في قسم علامات الرابط الأخرى (Other Linker Flags)، أضِف ‑ObjC لكلّ من تصحيح الأخطاء والإصدار. إذا لم تظهر هذه الإعدادات، غيِّر الفلتر في الـ شريط إعدادات الإصدار من أساسي إلى الكلّ.
  11. افتح Info.plist وأضِف أزواج المفتاح/القيمة التالية:
    • المفتاح: NSLocationWhenInUseUsageDescription (الخصوصية - وصف استخدام الموقع الجغرافي أثناء الاستخدام)
      القيمة: "يحتاج هذا التطبيق إلى إذن لاستخدام موقعك الجغرافي من أجل اتجاهات مفصّلة."
    • المفتاح: NSLocationAlwaysAndWhenInUseUsageDescription (الخصوصية - وصف استخدام الموقع الجغرافي دائمًا وأثناء الاستخدام)
      القيمة: "يحتاج هذا التطبيق إلى إذن لاستخدام موقعك الجغرافي من أجل اتجاهات مفصّلة."

الخطوة 3: إضافة مفتاح واجهة برمجة التطبيقات إلى المشروع

توضّح لك الأمثلة التالية كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى مشروعك في Xcode:

Swift

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.swift على النحو التالي:

  1. أضِف عبارات الاستيراد التالية: 
    import GoogleMaps
import GoogleNavigation
  2. أضِف ما يلي إلى طريقة application(_:didFinishLaunchingWithOptions:): 
    GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.m على النحو التالي:

  1. أضِف عبارات الاستيراد التالية: 
    @import GoogleMaps;
@import GoogleNavigation;
  2. أضِف ما يلي إلى طريقة application:didFinishLaunchingWithOptions:: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

الخطوة 4 (اختيارية): فحص ملف بيان الخصوصية من Apple

تتطلّب Apple تفاصيل خصوصية التطبيق للتطبيقات على App Store. انتقِل إلى صفحة تفاصيل الخصوصية في متجر تطبيقات Apple للاطّلاع على آخر الأخبار والمزيد من المعلومات.

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

إذا كنت أحد عملاء "خدمات التنقّل"

إذا كنت أحد عملاء "خدمات التنقّل"، يمكنك التعرّف على الفوترة في مستندات "خدمات التنقّل". لمزيد من المعلومات عن تسجيل المعاملات، يُرجى الاطّلاع على مقالة إعداد الفوترة. للتعرّف على كيفية إضافة أرقام تعريف المعاملات إلى عملية تنفيذ حزمة تطوير البرامج للتنقّل، يُرجى الاطّلاع على مقالة ربط استخدام خدمتك بمعاملات "خدمات التنقّل".

الخطوات التالية

بعد الحصول على مفتاح واجهة برمجة تطبيقات ومشروع Xcode، يمكنك إنشاء التطبيقات وتشغيلها. توفّر حزمة تطوير البرامج للتنقّل على أجهزة iOS أدلة تعليمية يمكن أن تساعدك في البدء. لمزيد من التفاصيل، يُرجى الاطّلاع على ما يلي: