الحصول على Driver SDK

يوضّح هذا القسم كيفية التأكّد من استيفاء نظامك الحد الأدنى من المتطلبات، وإعداد مجموعة Workspace، والحصول على حزمة تطوير برامج (SDK) لبرنامج Driver.

قبل البدء

تتطلّب حزمة Driver SDK لنظام التشغيل iOS أن يستوفي تطبيقك المعايير التالية:

• توفُّر حزمة تطوير البرامج (SDK) للتنقّل
• فعِّل حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS في Google Cloud Console واحصل على مفتاح واجهة برمجة التطبيقات.

الاطّلاع على الحد الأدنى لمتطلبات النظام

اطّلِع على ملاحظات الإصدار لمعرفة الحدّ الأدنى للمتطلبات لإصدار حزمة تطوير برامج (SDK) واجهة برمجة التطبيقات للسائق الذي تستخدمه. اطّلِع على ملاحظات الإصدار.

• يجب أن يعمل الجهاز الجوّال بنظام التشغيل iOS 14 أو إصدار أحدث.
• الإصدار 15 من Xcode من Apple أو إصدار أحدث

الحصول على إذن الوصول إلى Google Workspace

إذا كنت عميل Google Workspace، اتّبِع الخطوات التالية:

1. أنشئ مجموعة Workspace. لمزيد من المعلومات، يُرجى الاطّلاع على مجموعة Workspace.

   على سبيل المثال، من أفضل الممارسات تسمية مجموعتك [e-mail] أثناء عملية الإعداد.

2. قدِّم الاسم إلى Google لإضافة مجموعة Workspace إلى قائمة مسموح بها تمنح إذن الوصول إلى مستودعات CocoaPods الصحيحة.

3. تأكَّد من تضمين عناوين البريد الإلكتروني للمستخدمين وعناوين البريد الإلكتروني لحسابات الخدمة التي تحتاج إلى الوصول في هذه القائمة.

إذا لم تتمكّن مؤسستك من إنشاء مجموعات Workspace، أرسِل إلى Google قائمة بعناوين البريد الإلكتروني لحسابات المستخدمين وحسابات الخدمات التي تحتاج إلى الوصول إلى هذه العناصر.

ملاحظة: مجموعات Workspace ليست مثل مجموعات Google التي تنتهي بالرموز @googlegroups.com. لا تتوفّر سوى مجموعات Workspace.

تسجيل الدخول باستخدام حزمة Cloud SDK

لتطوير التطبيقات على الجهاز، سجِّل الدخول باستخدام حزمة Cloud SDK. لمعرفة التفاصيل، يُرجى الاطّلاع على تثبيت gcloud CLI.

توضِّح الأمثلة التالية كيفية تسجيل الدخول باستخدام حزمة Cloud SDK.

gcloud

gcloud auth login

يجب استخدام عنوان بريد إلكتروني يكون عضوًا في مجموعة Workspace.

إعداد مضيفي عمليات التشغيل الآلي

بالنسبة إلى أنظمة الإنشاء أو الدمج المستمر، يمكنك إعداد مضيفي التشغيل الآلي استنادًا إلى القائمة المقدَّمة من طُرق استخدام حساب خدمة للمصادقة على Google APIs وخدماتها. لمعرفة التفاصيل، يُرجى الاطّلاع على قسم حساب الخدمة في صفحة "طرق المصادقة" على Google.

• إذا كانت العملية تعمل داخل بيئة Google Cloud، استخدِم ميزة رصد بيانات الاعتماد التلقائية. لمزيد من المعلومات، يُرجى الاطّلاع على اكتشاف بيانات الاعتماد التلقائي.

• بخلاف ذلك، يمكنك تخزين ملف مفتاح حساب الخدمة في موقع آمن على ملف نظم المضيف وضبط متغيّر البيئة GOOGLE_APPLICATION_CREDENTIALS بشكلٍ مناسب. لمزيد من التفاصيل، يُرجى الاطّلاع على GOOGLE_APPLICATION_CREDENTIALS.

يجب أن يكون عنوان البريد الإلكتروني لحساب الخدمة المرتبط ببيانات الاعتماد عضوًا في مجموعة Workspace.

الحصول على حزمة تطوير برامج (SDK) لتطبيق Driver

ثبِّت حزمة تطوير برامج (SDK) لبرنامج التشغيل وضبط إعداداتها.

CocoaPods

1. تثبيت أداة CocoaPods: افتح نافذة محطة طرفية وشغِّل الأمر التالي:

   sudo gem install cocoapods
   

   لمزيد من التفاصيل، يُرجى الرجوع إلى دليل بدء استخدام CocoaPods.

2. إنشاء ملف Podfile لحزمة Driver SDK: يمكنك استخدام ملف Podfile لتثبيت واجهة برمجة التطبيقات وتبعياتها.

   1. أنشئ ملفًا باسم Podfile في دليل مشروعك. يحدّد هذا الملف تبعيات مشروعك.

   2. عدِّل ملف Podfile وأضِف التبعيات. في ما يلي مثال يضمّ التبعيات:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      في ما يلي مثال يتضمّن مجموعتَي Alpha وBeta لحزمة تطوير البرامج (SDK) Driver 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
      

   3. حفظ Podfile: افتح وحدة طرفية وانتقِل إلى المجلد الذي يحتوي علىملف Podfile:

      cd <path-to-project>
      

3. تنفيذ الأمر pod install: سيؤدي هذا الأمر إلى تثبيت واجهات برمجة التطبيقات المحدّدة في ملف Podfile، بالإضافة إلى أيّ تبعات قد تكون لها.

   pod install
   

4. فتح مشروعك في Xcode: أغلِق Xcode، ثم افتح (انقر مرّتين) ملف xcworkspace .الخاص بمشروعك لتشغيل Xcode. لفتح المشروع لاحقًا، استخدِم ملف xcworkspace.

   ملاحظة: يمكنك تنفيذ pod outdated بشكل دوري لرصد ما إذا كان هناك إصدار أحدث من حزمة SDK. لمزيد من المعلومات، يُرجى الاطّلاع على حزمة تطوير برامج (SDK) لبرامج تشغيل الإصدارات من نظام التشغيل iOS.

أداة إدارة حِزم Swift

يمكن تثبيت حزمة تطوير برامج (SDK) لبرنامج التشغيل من خلال أداة Swift Package Manager. لإضافة حزمة SDK، تأكَّد من أنّك أزلت أيّ ملحقات حالية لحزمة SDK الخاصة بالسائق.

ملاحظة مهمة: تستند هذه التعليمات إلى استخدام Xcode 15 أو إصدار أحدث، ولكن من المفترض أن تكون مشابهة للإصدارات السابقة من Xcode.

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

1. افتح Xcode project أو workspace، ثم انتقِل إلى ملف > إضافة تبعيات الحزمة.
2. أدخِل https://github.com/googlemaps/ios-driver-sdk كعنوان URL، واضغط على مفتاح Enter لسحب الحزمة، ثم انقر على "إضافة حزمة".
3. لتثبيت version معيّن، اضبط حقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار و استخدام الخيار "الإصدار المحدّد". بعد الانتهاء، انقر على "إضافة حزمة".

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

1. للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (مستكشف المشاريع) للتحقّق من الحزمة وإصدارها.

ملاحظة مهمة: في بعض الأحيان، لا يمكن حلّ العناصر أو قد تحدث أخطاء. في هذه الحالة، اختَر "ملف > الحِزم > إعادة ضبط ذاكرة التخزين المؤقت للحِزم".

لإزالة حزمة Driver SDK الحالية المثبَّتة يدويًا، اتّبِع الخطوات التالية:

1. من إعدادات ضبط مشروع Xcode، ابحث عن الإطارات المرجعية والمكتبات والمحتوى المضمّن. استخدِم علامة الطرح(-) لإزالة الإطار التالي:

   • GoogleRidesharingDriver.xcframework

2. من الدليل ذي المستوى الأعلى لمشروع Xcode، أزِل حِزمة GoogleRidesharingDriver.

التثبيت اليدوي

يعرض هذا الدليل كيفية إضافة حزمة XCFramework يدويًا التي تحتوي على IDE SDK إلى مشروعك وضبط إعدادات التصميم في Xcode.

ملاحظة: من أفضل الممارسات استخدام Cocoapods لتثبيت حزمة تطوير البرامج (SDK) لبرنامج Driver كلما أمكن ذلك.

قبل اتّباع هذا الدليل، يُرجى تنفيذ ما يلي:

• نزِّل XCFramework، وهي حزمة ثنائية تستخدمها لتثبيت IDE لبرنامج IDE. يمكنك استخدام هذه الحزمة على منصات متعددة، بما في ذلك الأجهزة التي تستخدم شرائح Apple silicon.

• ثبِّت حزمة تطوير البرامج (SDK) للتنقّل.

اتّبِع الخطوات التالية لتثبيت حزمة تطوير البرامج (SDK) لبرنامج Driver يدويًا:

1. نزِّل حِزمة SDK الثنائية والموارد:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. فكِّ ضغط الملفات المضغوطة للوصول إلى XCFramework والموارد.

3. ابدأ Xcode وافتح مشروعًا حاليًا أو أنشئ مشروعًا جديدًا. إذا كنت مستخدمًا جديدًا لنظام التشغيل iOS، أنشئ مشروعًا جديدًا واختَر نموذج تطبيق iOS.

4. إذا كانت مجموعة المشاريع لا تحتوي على مجموعة "إطارات عمل"، أنشئ مجموعة "إطارات عمل".

5. لتثبيت حزمة تطوير برامج (SDK) لبرنامج التشغيل، اسحب ملف GoogleRidesharingDriver.xcframework إلى مشروعك ضمن الإطارات والمراجع والمحتوى المضمّن. اختَر نسخ العناصر إذا طُلب منك ذلك.

6. اسحب GoogleRidesharingDriver.bundle الذي تم تنزيله إلى directory الدرجة العليا من مشروع Xcode. اختَر نسخ العناصر إذا طُلب منك ذلك.

7. اختَر مشروعك من "مستكشف المشاريع"، ثم اختَر ملف شخصي لتطبيقك.

8. افتح علامة التبويب مراحل الإنشاء، وفي ربط الثنائي بالمكتبات، أضِف الإطارات البرمجية والمكتبات التالية إذا لم تكن متوفّرة:

   • 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

9. اختَر مشروعك بدلاً من هدف محدّد، وافتح علامة التبويب إعدادات الإصدار. في قسم رموز ربط أخرى، أضِف -ObjC لكل من debugging وrelease.

   إذا لم تكن هذه الإعدادات مرئية، غيِّر الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.

فحص ملف بيان الخصوصية في Apple

تشترط Apple تقديم تفاصيل خصوصية التطبيقات على App Store. يُرجى الانتقال إلى صفحة "تفاصيل الخصوصية" في Apple App Store للاطّلاع على آخر الأخبار والمزيد من المعلومات.

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

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

ضبط مشروع في Google Cloud Console