إعداد مشروع Xcode

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

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

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

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

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

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

Swift Package Manager

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

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

  1. افتح Xcode project‏ أو workspace، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies).
  2. أدخِل https://github.com/googlemaps/ios-navigation-sdk كعنوان URL، واضغط على Enter لجلب الحزمة، ثم انقر على "إضافة حزمة".
  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. نزِّل ملفات SDK الثنائية وملفات الموارد التالية:
  2. شغِّل Xcode وافتح مشروعًا حاليًا أو أنشئ مشروعًا جديدًا. إذا كنت جديدًا على نظام التشغيل iOS، أنشئ مشروعًا جديدًا واختَر نموذج تطبيق iOS.
  3. أزِل جميع مراجع "خرائط Google" و"التنقّل" و"الأماكن" الحالية من المشروع.
  4. اسحب XCFrameworks التالية إلى مشروعك ضمن الأطر والمكتبات والمحتوى المضمّن لتثبيت حزمتَي تطوير البرامج بالاستناد إلى بيانات "خرائط Google" و"التنقّل" (عندما يُطلب منك ذلك، اختَر نسخ العناصر إذا لزم الأمر):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. اسحب GoogleMaps.bundle من GoogleMapsResources الذي نزّلته إلى دليل المستوى الأعلى في مشروع Xcode. عندما يُطلب منك ذلك، تأكَّد من وضع علامة في المربّع بجانب نسخ العناصر إذا لزم الأمر.
  6. اسحب GoogleNavigation.bundle من GoogleNavigationResources الذي نزّلته إلى دليل المستوى الأعلى في مشروع Xcode. عندما يُطلب منك ذلك، تأكَّد من وضع علامة في مربّع الاختيار نسخ العناصر إلى مجلد المجموعة الوجهة.
  7. اختَر مشروعك من "مستكشف المشروع" (Project Navigator)، ثم اختَر هدف تطبيقك.
  8. افتح علامة التبويب مراحل الإنشاء (Build Phases)، ثم أضِف أُطر العمل والمكتبات التالية في ربط الملفات الثنائية بالمكتبات (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. اختَر مشروعك بدلاً من هدف محدّد، وافتح علامة التبويب إعدادات الإنشاء. في قسم علامات ربط أخرى، أضِف ‑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 App Store للاطّلاع على آخر الأخبار والمزيد من المعلومات.

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

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

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

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

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