يصف هذا القسم كيفية التحقق من أنّ نظامك يستوفي الحدّ الأدنى من المتطلبات. إعداد مجموعة Workspace والحصول على حزمة تطوير البرامج (SDK) لبرنامج التشغيل.
قبل البدء
تتطلب حزمة Driver SDK لنظام التشغيل iOS استيفاء تطبيقك للمعايير التالية:
- توفُّر حزمة SDK للتنقّل
- فعِّل حزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل iOS في Google Cloud Console واحصل على مفتاح واجهة برمجة التطبيقات.
التحقُّق من الحد الأدنى من متطلبات النظام
راجِع ملاحظات الإصدار لمعرفة الحدّ الأدنى من متطلبات إصدار التطبيق. حزمة تطوير البرامج (SDK) لبرنامج التشغيل التي تستخدمها يُرجى الاطّلاع على ملاحظات الإصدار.
- يجب أن يعمل الجهاز الجوّال بنظام التشغيل iOS 14 أو إصدار أحدث.
- Apple Xcode الإصدار 15 أو إصدار أحدث
الوصول إلى حسابك على Google Workspace
إذا كنت أحد عملاء Google Workspace، عليك تنفيذ الخطوات التالية:
أنشِئ مجموعة Workspace. لمزيد من المعلومات، يُرجى الاطِّلاع على مجموعة Workspace.
كإحدى أفضل الممارسات مثلاً، أضِف اسمًا لمجموعتك
google-maps-platform-sdk-users@workspacedomain.com
أثناء عملية الإعداد.قدِّم الاسم إلى Google لإضافة مجموعة Workspace إلى قائمة مسموح بها. يمنح إمكانية الوصول إلى مستودعات CocoaPods الصحيحة.
تأكَّد من أنّ عناوين البريد الإلكتروني للمستخدمِين وعناوين البريد الإلكتروني لحساب الخدمة التي تحتاج إلى الوصول هي المدرجة في هذه القائمة.
إذا لم تتمكّن مؤسستك من إنشاء مجموعات Workspace، أرسِل قائمة إلى Google. من رسائل البريد الإلكتروني الخاصة بحساب المستخدم والخدمة التي تحتاج إلى الوصول إلى هذه العناصر.
تسجيل الدخول باستخدام حزمة تطوير البرامج (SDK) في السحابة الإلكترونية
بالنسبة إلى التطوير المحلي، سجِّل الدخول باستخدام حزمة تطوير البرامج (SDK) للسحابة الإلكترونية. لمعرفة التفاصيل، يُرجى الاطّلاع على تثبيت gcloud CLI.
توضِّح الأمثلة التالية كيفية تسجيل الدخول باستخدام حزمة تطوير البرامج (SDK) للسحابة الإلكترونية.
gcloud
gcloud auth login
يجب استخدام عنوان بريد إلكتروني يكون عضوًا في مجموعة Workspace.
إعداد مضيفي التشغيل الآلي
بالنسبة إلى أنظمة التصميم أو الدمج المستمر، يمكنك إعداد مضيفات التشغيل الآلي استنادًا إلى في القائمة المتوفرة لطرق استخدام حساب الخدمة للمصادقة على Google APIs وخدماته. لمعرفة التفاصيل، يُرجى الاطّلاع على قسم حساب الخدمة. في صفحة طرق المصادقة في Google.
في حال إجراء العملية داخل بيئة Google Cloud، استخدِم الكشف التلقائي عن بيانات الاعتماد. لمزيد من المعلومات، يُرجى الاطّلاع على الاكتشاف التلقائي لبيانات الاعتماد.
بخلاف ذلك، يمكنك تخزين ملف مفتاح حساب الخدمة في موقع آمن على نظام ملفات المضيف وتعيين GOOGLE_APPLICATION_CREDENTIALS متغير البيئة بشكل مناسب. لمزيد من التفاصيل، يُرجى الاطّلاع على GOOGLE_APPLICATION_CREDENTIALS.
يجب أن يكون البريد الإلكتروني لحساب الخدمة المرتبط ببيانات الاعتماد عضوًا في مجموعة Workspace.
الحصول على Driver SDK
ثبِّت حزمة Driver SDK واضبطها.
CocoaPods
تثبيت أداة CocoaPods: افتح نافذة طرفية وشغِّل ما يلي: الأمر.
sudo gem install cocoapods
لمزيد من التفاصيل، راجِع دليل بدء استخدام CocoaPods.
إنشاء ملف Podfile لحزمة Driver SDK: يمكنك استخدام Podfile لتثبيت. واجهة برمجة التطبيقات وتبعياتها.
أنشئ ملفًا باسم "
Podfile
" في دليل مشروعك. يحدد هذا الملف تبعيات مشروعك.قم بتحرير Podfile وأضف التبعيات الخاصة بك. فيما يلي مثال التبعيات:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
في ما يلي مثال يتضمن الإصدارات الأولية والتجريبية لمجموعة حزمة تطوير البرامج (SDK) لبرنامج التشغيل كعناصر تابعة:
source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git" source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
حفظ Podfile: افتح نافذة طرفية وانتقِل إلى المجلد الذي يتضمن ملف Podfile:
cd <path-to-project>
تشغيل الأمر pod install: سيؤدي هذا الأمر إلى تثبيت واجهات برمجة التطبيقات. المحددة في Podfile، إلى جانب أي تبعيات قد تكون موجودة.
pod install
فتح مشروعك في Xcode: أغلِق Xcode ثم افتحه. انقر مرّتين على ملف xcworkspace الخاص بمشروعك لتشغيل Xcode. للفتح المشروع لاحقًا، استخدم ملف .xcworkspace.
مدير حزم Swift
يمكن تثبيت Driver SDK من خلال مدير حزم Swift لإضافة حزمة تطوير البرامج (SDK)، تأكَّد من أنّ لديك إزالة أي تبعيات حالية لحزمة تطوير البرامج (SDK) لبرنامج التشغيل.
لإضافة حزمة تطوير البرامج (SDK) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
project
أوworkspace
، ثم انتقِل إلى File >. أضِف تبعيات الحزمة. - أدخِل https://github.com/googlemaps/ios-driver-sdk كعنوان URL واضغط على Enter. لسحب الحزمة، والنقر فوق "Add Package" (إضافة حزمة).
-
لتثبيت قاعدة
version
محدّدة، اضبط حقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. وبالنسبة للمشروعات الجديدة، نوصي بتحديد أحدث إصدار باستخدام "الإصدار الدقيق" الخيار. بعد اكتمال عملية النقل، انقر على "إضافة حزمة". -
من نافذة اختيار منتجات الحزمة، تأكَّد من إضافة
GoogleRidesharingDriver
إلى هدفmain
المحدد. بعد اكتمال عملية النقل، انقر على "إضافة حزمة". -
للتحقّق من عملية التثبيت، انتقِل إلى جزء
General
في استهدافك. من المفترَض أن تظهر الحِزَم المثبَّتة في أُطر العمل والمكتبات والمحتوى المضمَّن. يمكنك أيضًا عرض قسم "تبعيات الحزمة" قسم "مستكشف المشروع" للتحقق من الحزمة وإصدارها.
لتعديل package
لمشروع حالي، اتّبِع الخطوات التالية:
في حال الترقية من إصدار أقدم من 9.0.0، يجب إزالة التبعيات التالية:
GoogleMapsBase
وGoogleMapsCore
وGoogleMapsM4B
بعد الترقية. لا تقم بإزالة تبعيةGoogleMaps
لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات الإصدار 9.0.0:من إعدادات ضبط مشروع Xcode، ابحث عن Frameworks وLibraries والمحتوى المضمَّن استخدِم علامة الطرح(-) لإزالة إطار العمل التالي:
GoogleMapsBase
(للترقيات من الإصدارات السابقة على 9.0.0 فقط)GoogleMapsCore
(للترقيات من الإصدارات السابقة على 9.0.0 فقط)GoogleMapsM4B
(للترقيات من الإصدارات السابقة على 9.0.0 فقط)
- من Xcode، انتقل إلى "File >" (ملف >) الحزم > التحديث إلى أحدث إصدارات الحزمة".
- للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (أداة التنقّل في المشروع) للتحقق من الحزمة وإصدارها.
لإزالة العناصر الاعتمادية الحالية لـ Driver SDK التي تمت إضافتها باستخدام
CocoaPods
، يُرجى اتّباع الخطوات التالية:
- أغلِق مساحة عمل Xcode. افتح المحطة الطرفية ونفِّذ الأمر التالي:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
إزالة
Podfile
وPodfile.resolved
و Xcodeworkspace
إذا كنت لا تستخدمهم لأي غرض آخر غير CocoaPods.
لإزالة تثبيت Driver SDK الحالي، يدويًا، اتبع الخطوات التالية:
من إعدادات ضبط مشروع Xcode، ابحث عن Frameworks، المكتبات والمحتوى المضمَّن استخدِم علامة الطرح
(-)
لإزالتها إطار العمل التالي:GoogleRidesharingDriver.xcframework
من دليل المستوى الأعلى لمشروع Xcode، أزِل حزمة
GoogleRidesharingDriver
.
التثبيت اليدوي
يوضح هذا الدليل كيفية إضافة XCFramework يدويًا الذي يحتوي على حزمة تطوير البرامج (SDK) لبرنامج التشغيل إلى مشروعك وضبط إعدادات الإصدار في Xcode
قبل اتّباع هذا الدليل، عليك إجراء ما يلي:
قم بتنزيل XCFramework، وهو حزمة ثنائية تستخدمها لتثبيت SDK لبرنامج التشغيل. يمكنك استخدام هذه الحزمة على عدة منصات، بما في ذلك الأجهزة التي تستخدم Apple silicon
ثبِّت حزمة SDK للتنقل.
نفِّذ الخطوات التالية لتثبيت حزمة تطوير البرامج (SDK) لبرنامج التشغيل يدويًا:
تنزيل البرنامج الثنائي لحزمة SDK والموارد:
فك ضغط الملفات المضغوطة للوصول إلى XCFramework والموارد.
ابدأ Xcode وافتح مشروعًا حاليًا أو أنشئ مشروعًا. إذا كنت جديد على iOS، أنشئ مشروعًا جديدًا وحدد نموذج تطبيق iOS.
إذا لم تكن مجموعة المشاريع تحتوي على مجموعة إطارات عمل، يمكنك إنشاؤها.
لتثبيت Driver SDK، اسحب ملف واحد (
GoogleRidesharingDriver.xcframework
) إلى مشروعك ضمن أُطر العمل والمكتبات والمحتوى المضمَّن: إذا طُلب منك ذلك، اختَر نسخ العناصر.اسحب "
GoogleRidesharingDriver.bundle
" الذي تم تنزيله إلى المستوى الأعلى. دليل مشروع Xcode الخاص بك. اختَر نسخ الملفات إذا طُلب منك ذلك.اختَر مشروعك من Project Navigator، ثم اختَر هدف التطبيق.
افتح علامة التبويب مراحل التصميم، وفي ربط النظام الثنائي بالمكتبات، أضِف أُطر العمل والمكتبات التالية إذا لم تكن موجودة بالفعل:
Accelerate.framework
AudioToolbox.framework
AVFoundation.framework
CoreData.framework
CoreGraphics.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libxml2.tbd
libz.tbd
LocalAuthentication.framework
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
WebKit.framework
اختر مشروعك بدلاً من هدف محدد، وافتح زر إنشاء الإعدادات في القسم علامات الروابط الأخرى، أضِف
-ObjC
عندما تصحيح الأخطاء والإصدار.إذا لم تكن هذه الإعدادات مرئية، فغيّر في شريط إعدادات التصميم من أساسي إلى الكل.
فحص ملف بيان الخصوصية في Apple
تشترط Apple تفاصيل خصوصية التطبيقات للتطبيقات المتوفّرة على App Store. يُرجى الانتقال إلى صفحة تفاصيل خصوصية Apple App Store لمعرفة آخر الأخبار ومزيد من المعلومات.
يتم تضمين ملف بيان الخصوصية من Apple في حزمة الموارد لحزمة تطوير البرامج (SDK). للتأكّد من تضمين "ملف بيان الخصوصية" وفحص محتواه، عليك إنشاء أرشيف لتطبيقك وإنشاء تقرير خصوصية من الأرشيف.