لمتابعة الرحلات عند الطلب في تطبيقات المستهلكين على أجهزة iOS، استخدِم حزمة SDK للمستهلكين. لمزيد من المعلومات عن التالي ومقدمة حول الرحلات باستخدام مشاركة الرحلة، ارجع متابعة رحلة في نظام iOS
لإعداد حزمة تطوير البرامج (SDK) الخاصة بالمستهلك من أجل تطبيق المستهلك لنظام التشغيل iOS، اتبع الخطوات التالية:
- التحقُّق من الحد الأدنى لمتطلبات النظام.
- الحصول على حزمة تطوير البرامج (SDK) للمستهلكين
- افحص ملف بيان الخصوصية في Apple.
- إعداد مشروع على Google Cloud Console:
- الحصول على الرموز المميزة للمصادقة
- إعداد حزمة تطوير البرامج (SDK) للمستهلكين
التحقُّق من الحد الأدنى من متطلبات النظام
راجِع ملاحظات الإصدار لمعرفة الحدّ الأدنى من متطلبات إصدار التطبيق. حزمة SDK للمستهلك التي تستخدمها يُرجى الاطّلاع على ملاحظات الإصدار.
- يجب أن يعمل الجهاز الجوّال بنظام التشغيل iOS 14 أو إصدار أحدث.
- Apple Xcode الإصدار 15 أو إصدار أحدث
الحصول على حزمة تطوير البرامج (SDK) الخاصة بالمستهلك
يمكنك تثبيت حزمة تطوير البرامج (SDK) الخاصة بالمستهلك وإعدادها باستخدام CocoaPods.
مدير حزم Swift
يمكن تثبيت حزمة SDK للمستهلكين عبر مدير حزم Swift لإضافة حزمة تطوير البرامج (SDK)، تأكَّد من أنّ لديك قد تمت إزالة أي تبعيات حالية لحزمة تطوير البرامج (SDK) للمستهلكين.
لإضافة حزمة تطوير البرامج (SDK) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
project
أوworkspace
، ثم انتقِل إلى File >. أضِف تبعيات الحزمة. - أدخِل https://github.com/googlemaps/ios-consumer-sdk كعنوان URL واضغط على Enter. لسحب الحزمة، والنقر فوق "Add Package" (إضافة حزمة).
-
لتثبيت قاعدة
version
محدّدة، اضبط حقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. وبالنسبة للمشروعات الجديدة، نوصي بتحديد أحدث إصدار باستخدام "الإصدار الدقيق" الخيار. بعد اكتمال عملية النقل، انقر على "إضافة حزمة". -
من نافذة اختيار منتجات الحزمة، تأكَّد من إضافة
GoogleRidesharingConsumer
إلى هدف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 (أداة التنقّل في المشروع) للتحقق من الحزمة وإصدارها.
لإزالة الموارد الاعتمادية الحالية لحزمة تطوير البرامج (SDK) للمستهلكين التي تمت إضافتها باستخدام
CocoaPods
، يُرجى اتّباع الخطوات التالية:
- أغلِق مساحة عمل Xcode. افتح المحطة الطرفية ونفِّذ الأمر التالي:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
إزالة
Podfile
وPodfile.resolved
و Xcodeworkspace
إذا كنت لا تستخدمهم لأي غرض آخر غير CocoaPods.
لإزالة حِزمة تطوير البرامج (SDK) الحالية للمستهلك يدويًا، اتبع الخطوات التالية:
من إعدادات ضبط مشروع Xcode، ابحث عن Frameworks، المكتبات والمحتوى المضمَّن استخدِم علامة الطرح
(-)
لإزالتها إطار العمل التالي:GoogleRidesharingConsumer.xcframework
من دليل المستوى الأعلى لمشروع Xcode، أزِل حزمة
GoogleRidesharingConsumer
.
استخدام CocoaPods
تثبيت أداة CocoaPods: افتح نافذة طرفية ثم قم بتشغيل الأمر التالي:
sudo gem install cocoapods
لمزيد من التفاصيل، يُرجى الرجوع إلى دليل بدء استخدام CocoaPods
إنشاء ملف Podfile لحزمة تطوير البرامج (SDK) الخاصة بالمستهلك: أنت استخدام Podfile لتثبيت واجهة برمجة التطبيقات وتبعياتها.
أنشئ ملفًا باسم "
Podfile
" في دليل مشروعك. هذا الملف وتحدد تبعيات مشروعك.قم بتحرير Podfile وأضف التبعيات الخاصة بك. إليك مثال يتضمن التبعيات:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingConsumer' end
حفظ Podfile: افتح نافذة طرفية وانتقِل إلى المجلد الذي يحتوي على ملف Podfile:
cd <path-to-project>
تشغيل الأمر pod install: يؤدي هذا الأمر إلى تثبيت واجهات برمجة التطبيقات. المحددة في Podfile، إلى جانب أي تبعيات قد تكون موجودة.
pod install
فتح مشروعك في Xcode: أغلِق Xcode ثم افتحه (بالنقر مرّتين) ملف .xcworkspace لمشروعك لإطلاق Xcode. لفتح المشروع لاحقًا، استخدم ملف .xcworkspace.
التثبيت اليدوي
يوضح هذا الدليل كيفية إضافة XCFramework يدويًا الذي يحتوي على حزمة SDK للمستهلك إلى مشروعك وضبط إعدادات الإصدار في Xcode
قبل اتّباع هذا الدليل، عليك إجراء ما يلي:
قم بتنزيل XCFramework، وهو حزمة ثنائية تستخدمها لتثبيت حزمة SDK للمستهلكين يمكنك استخدام هذه الحزمة على عدة منصات، بما في ذلك الأجهزة باستخدام شريحة M1.
تثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google"
تنزيل البرنامج الثنائي لحزمة SDK والموارد:
فك ضغط الملفات المضغوطة للوصول إلى XCFramework والموارد.
ابدأ Xcode وافتح مشروعًا أو أنشئه. إذا كنت مستخدمًا جديدًا لنظام التشغيل iOS، إنشاء مشروع جديد واختيار نموذج تطبيق iOS.
إذا لم تكن مجموعة المشاريع تحتوي على مجموعة إطارات عمل، يمكنك إنشاؤها.
اسحب ملف
gRPCCertificates.bundle
الذي تم تنزيله إلى المستوى الأعلى. دليل مشروع Xcode الخاص بك. اختَر نسخ الملفات إذا طُلب منك ذلك.لتثبيت حزمة SDK للمستهلكين، اسحب ملف واحد (
GoogleRidesharingConsumer.xcframework
) إلى مشروعك ضمن أُطر العمل والمكتبات والمحتوى المضمَّن: إذا طُلب منك ذلك، اختَر نسخ العناصر.اسحب "
GoogleRidesharingConsumer.bundle
" الذي تم تنزيله إلى دليل المستوى الأعلى لمشروع Xcode. إذا طُلب منك ذلك، اختَر نسخ العناصر.اختَر مشروعك من Project Navigator، ثم اختَر هدف التطبيق.
افتح علامة التبويب مراحل التصميم وفي ربط النظام الثنائي بالمكتبات، تضيف أطر العمل والمكتبات التالية إذا لم تكن موجودة بالفعل حاليًا:
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
Metal.framework
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
اختر مشروعك بدلاً من هدف محدد، وافتح علامة التبويب إعدادات الإصدار في القسم علامات الروابط الأخرى، إضافة
-ObjC
لكل من تصحيح الأخطاء والإصدار.إذا لم تكن هذه الإعدادات مرئية، يمكنك تغيير الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.
فحص ملف بيان الخصوصية في Apple
تشترط Apple تفاصيل خصوصية التطبيقات للتطبيقات المتوفّرة على App Store. يُرجى الانتقال إلى صفحة تفاصيل خصوصية Apple App Store للاطّلاع على آخر الأخبار والمعلومات.
يتم تضمين ملف بيان الخصوصية من Apple في حزمة الموارد لحزمة تطوير البرامج (SDK). للتأكّد من تضمين "ملف بيان الخصوصية" وفحص محتواه، عليك إنشاء أرشيف لتطبيقك وإنشاء تقرير خصوصية من الأرشيف.