بعد تفعيل ميزة الفوترة وإنشاء مفتاح واجهة برمجة التطبيقات، ستكون مستعدًا لإعداد مشروع Xcode الذي تستخدمه لتطوير تطبيقك.
تتوفّر ملاحظات الإصدار لكل إصدار.
الخطوة 1: تثبيت البرنامج المطلوب
لإنشاء مشروع باستخدام حزمة تطوير البرامج للتنقّل على أجهزة iOS، عليك تنزيل وتثبيت ما يلي:
- Xcode الإصدار 15.0 أو إصدار أحدث
الخطوة 2: إنشاء مشروع Xcode وتثبيت حزمة تطوير البرامج (SDK) لنظام التنقّل
أداة إدارة حِزم Swift
يمكن تثبيت حزمة تطوير البرامج (SDK) لميزة التنقّل باتّجاهات مفصّلة من خلال أداة Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي عناصر تابعة حالية لحزمة Navigation SDK.
لإضافة حزمة تطوير البرامج إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
project
أوworkspace
، ثم انتقِل إلى ملف > إضافة تبعيات الحزمة. - أدخِل https://github.com/googlemaps/ios-navigation-sdk كعنوان URL، واضغط على مفتاح Enter لسحب الحزمة، ثم انقر على "إضافة حزمة".
-
لتثبيت
version
معيّن، اضبط حقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار و استخدام الخيار "الإصدار المحدّد". بعد الانتهاء، انقر على "إضافة حزمة".
لتعديل package
لمشروع حالي، اتّبِع الخطوات التالية:
- للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (مستكشف المشاريع) للتحقّق من الحزمة وإصدارها.
-
من إعدادات ضبط مشروع Xcode، ابحث عن الإطارات والكتب المرجعية
والمحتوى المضمّن. استخدِم علامة الطرح(-) لإزالة الإطار التالي:
GoogleMaps.xcframework
GoogleNavigation.xcframework
-
من الدليل ذي المستوى الأعلى لمشروع Xcode، أزِل حِزمة
GoogleMaps
.
التثبيت اليدوي
يوضّح هذا الدليل كيفية إضافة حِزم XCFrameworks يدويًا التي تتضمّن حزمة تطوير البرامج للتنقّل على أجهزة iOS وحزمة تطوير البرامج لتطبيق "خرائط Google" على أجهزة iOS إلى مشروعك وضبط إعدادات الإنشاء في Xcode. XCFramework هي حزمة ثنائية يمكنك استخدامها على أنظمة أساسية متعددة، بما في ذلك الأجهزة التي تستخدم مجموعة شرائح M1.
اتّبِع الخطوات التالية لتثبيت حزمة XCFrameworks لحزمة تطوير البرامج للتنقّل على أجهزة iOS وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لأجهزة iOS:
- نزِّل ملفات SDK الثنائية وملفات الموارد التالية:
- افتح Xcode وافتَح مشروعًا حاليًا أو أنشئ مشروعًا جديدًا. إذا كنت مبتدئًا في استخدام نظام التشغيل iOS، أنشئ مشروعًا جديدًا واختَر نموذج تطبيق iOS.
- أزِل جميع الإشارات الحالية إلى "خرائط Google" و"التنقّل" و"الأماكن" من المشروع.
- اسحب حِزم XCFrameworks التالية إلى مشروعك ضمن
الإطارات والكتب والملفات المضمّنة لتثبيت حِزم SDK لكل من "خرائط Google"
و"التنقّل" (اختَر نسخ العناصر إذا لزم الأمر عندما يُطلب منك ذلك):
GoogleMaps.xcframework
GoogleNavigation.xcframework
- اسحب
GoogleMaps.bundle
من GoogleMapsResources الذي نزّلته إلى الدليل الأعلى لمشروع Xcode. عند ظهور طلب، تأكَّد من اختيار نسخ العناصر إذا لزم الأمر. - اسحب
GoogleNavigation.bundle
من GoogleNavigationResources الذي نزّلته إلى الدليل الأعلى لمشروع Xcode. تأكَّد من اختيار نسخ العناصر إلى مجلد المجموعة الوجهة عندما يُطلب منك ذلك. - اختَر مشروعك من "مستكشف المشاريع"، ثم اختَر هدف تطبيقك.
- افتح علامة التبويب مراحل الإنشاء، وفي
ربط الثنائي بالمكتبات، أضِف الإطارات والمكتبات التالية:
Accelerate.framework
AudioToolbox.framework
AVFoundation.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
Metal.framework
OpenGLES.framework
QuartzCore.framework
Security.framework
SystemConfiguration.framework
UIKit.framework
UserNotifications.framework
WebKit.framework
- في استهداف تطبيقك، اختَر علامة التبويب الإمكانات،
وفعِّل الأوضاع التي تعمل في الخلفية، ثم فعِّل الأوضاع التالية:
- الصوت وAirPlay و"نافذة ضمن النافذة"
- تعديلات الموقع الجغرافي
- اختَر مشروعك بدلاً من هدف محدّد، وافتح علامة التبويب إعدادات
البناء. في قسم رموز ربط أخرى،
أضِف
‑ObjC
لكل من تصحيح الأخطاء والإصدار. إذا لم تكن هذه الإعدادات مرئية، غيِّر الفلتر في عمود إعدادات الإصدار من أساسي إلى الكل. - افتح
Info.plist
وأضِف أزواج المفتاح/القيمة التالية:- المفتاح:
NSLocationWhenInUseUsageDescription
(الخصوصية - وصف استخدام الموقع الجغرافي أثناء الاستخدام)
القيمة: "يحتاج هذا التطبيق إلى إذن لاستخدام موقعك الجغرافي للتنقّل من خلال التوجيهات." - المفتاح:
NSLocationAlwaysAndWhenInUseUsageDescription
(الخصوصية - وصف استخدام الموقع الجغرافي في كل الأوقات وعند الاستخدام)
القيمة: "يحتاج هذا التطبيق إلى إذن لاستخدام موقعك الجغرافي للتنقّل من خلال التوجيهات."
- المفتاح:
CocoaPods
تتوفّر حزمة تطوير البرامج للتنقّل على أجهزة iOS كمجموعة CocoaPods. CocoaPods هو أداة مفتوحة المصدر لإدارة الملحقات لمشاريع Swift وObjective-C Cocoa.
إذا لم تكن تمتلك أداة CocoaPods، يمكنك تثبيتها على نظام التشغيل macOS من خلال تشغيل الأمر التالي من وحدة التحكّم الطرفية. لمعرفة التفاصيل، يُرجى الاطّلاع على دليل بدء استخدام CocoaPods.
sudo gem install cocoapods
أنشئ Podfile
لحزمة تطوير البرامج Navigation SDK لنظام التشغيل iOS واستخدِم
ذلك لتثبيت واجهة برمجة التطبيقات وتبعياتها:
- إذا لم يكن لديك مشروع Xcode حتى الآن، أنشئ مشروعًا الآن واحفظه على
جهازك. إذا كنت مبتدئًا في تطوير تطبيقات iOS:
- أنشئ مشروعًا جديدًا.
- اختَر iOS > التطبيق.
- في شاشة خيارات المشروع:
- أدخِل اسم المشروع.
- سجِّل قيمة حقل معرّف الحزمة. يمكنك استخدام هذه القيمة لتقييد مفتاح واجهة برمجة التطبيقات أدناه.
- اضبط واجهة المشروع على مخطّط القصة.
- اضبط اللغة على Swift أو Objective-C.
- أنشئ ملفًا باسم
Podfile
في دليل مشروعك. يحدِّد هذا الملف تبعيات مشروعك. - عدِّل
Podfile
وأضِف التبعيات مع الإصدارات. في ما يلي مثال يتضمّن التبعية التي تحتاج إليها لأجل حزمة تطوير البرامج للتنقّل على أجهزة iOS: # Cocoapods install reference # احرص على تشغيلsource 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleNavigation', '9.2.0' end
pod outdated
بانتظام لرصد الإصدارات الأحدث. إذا لزم الأمر، يمكنك الترقية إلى أحدث إصدار. - احفظ
Podfile
. افتح وحدة طرفية وانتقِل إلى الدليل الذي يحتوي على
Podfile
:cd <path-to-project>
نفِّذ الأمر
pod install
. يؤدي ذلك إلى تثبيت واجهات برمجة التطبيقات المحدّدة فيPodfile
، بالإضافة إلى أي تبعيات.pod install
أغلِق Xcode، ثم افتح (انقر مرّتين) على ملف
.xcworkspace
الخاص بمشروعك لتشغيل Xcode. من الآن فصاعدًا، يجب استخدام ملف.xcworkspace
لفتح المشروع.
لتعديل واجهة برمجة التطبيقات لمشروع حالي، اتّبِع الخطوات التالية:
- افتح وحدة تحكّم طرفية وانتقِل إلى دليل المشروع الذي يحتوي على
Podfile
. - نفِّذ الأمر
pod update
. يؤدي ذلك إلى تحديث جميع واجهات برمجة التطبيقات المحدّدة فيPodfile
إلى أحدث إصدار.
الخطوة 3: إضافة مفتاح واجهة برمجة التطبيقات إلى المشروع
توضّح الأمثلة التالية كيفية إضافة مفتاح واجهة برمجة التطبيقات إلى مشروعك في Xcode:
Swift
أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.swift
على النحو التالي:
- أضِف عبارات الاستيراد التالية:
import GoogleMaps import GoogleNavigation
- أضِف ما يلي إلى طريقة
application(_:didFinishLaunchingWithOptions:)
:GMSServices.provideAPIKey("YOUR_API_KEY")
Objective-C
أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.m
على النحو التالي:
- أضِف عبارات الاستيراد التالية:
@import GoogleMaps; @import GoogleNavigation;
- أضِف ما يلي إلى طريقة
application:didFinishLaunchingWithOptions:
:[GMSServices provideAPIKey:@"YOUR_API_KEY"];
الخطوة 4 (اختيارية): فحص ملف بيان الخصوصية من Apple
تشترط Apple تقديم تفاصيل خصوصية التطبيقات على App Store. يُرجى الانتقال إلى صفحة "تفاصيل الخصوصية" في Apple App Store للاطّلاع على آخر الأخبار والمزيد من المعلومات.
يتم تضمين ملف بيان الخصوصية من Apple في حِزمة الموارد لحزمة SDK. للتأكّد من تضمين ملف بيان الخصوصية وفحص محتوياته، أنشئ أرشيفًا لتطبيقك وأنشئ تقرير خصوصية من الأرشيف.
إذا كنت أحد عملاء "خدمات النقل"
إذا كنت أحد عملاء "خدمات الجوّال"، يمكنك الاطّلاع على معلومات عن الفوترة في مستندات "خدمات الجوّال". لمزيد من المعلومات عن تسجيل المعاملات، يُرجى الاطّلاع على مقالة إعداد الفوترة. للتعرّف على كيفية إضافة أرقام تعريف المعاملات إلى عملية تنفيذ حزمة تطوير البرامج (SDK) لميزة التنقّل، اطّلِع على مقالة ربط استخدامك للخدمة بمعاملات "التنقّل".
الخطوات التالية
بعد أن أصبح لديك مفتاح واجهة برمجة تطبيقات ومشروع Xcode، يمكنك إنشاء التطبيقات وتشغيلها. توفّر حزمة تطوير البرامج للتنقّل على أجهزة iOS أدلة تعليمية يمكنها مساعدتك في البدء. لمزيد من التفاصيل، يُرجى الاطّلاع على: