إعداد مشروع Xcode

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

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

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

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

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

Swift Package Manager

يمكن تثبيت حزمة تطوير البرامج (SDK) للتنقّل من خلال Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي تبعيات حالية لحزمة تطوير البرامج (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 Dependencies" (تبعيات الحزمة) في "Project Navigator" (متصفّح المشروع) للتحقّق من الحزمة وإصدارها.

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

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

لإزالة حزمة تطوير البرامج (SDK) للتنقّل الحالية المثبَّتة يدويًا على أجهزة 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 التالية إلى مشروعك ضمن الأطر والمكتبات والمحتوى المضمّن لتثبيت حزمتَي تطوير البرامج (SDK) لـ "خرائط 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 للاطّلاع على آخر الأخبار ومزيد من المعلومات.

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

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

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

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

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