الحصول على Driver SDK

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

قبل البدء

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

• يجب أن تكون حزمة Navigation 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 API وخدماتها. لمعرفة التفاصيل، يُرجى الاطّلاع على قسم حساب الخدمة في صفحة "طرق المصادقة في Google".

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

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

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

الحصول على Driver SDK

ثبِّت حزمة تطوير البرامج (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) الخاصة ببرنامج التشغيل:

      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. لمزيد من المعلومات، يُرجى الاطّلاع على إصدارات Driver SDK لأجهزة iOS.

Swift Package Manager

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

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

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

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

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

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

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

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

1. من إعدادات ضبط مشروع Xcode، ابحث عن Frameworks, Libraries, and Embedded Content. استخدِم علامة الطرح(-) لإزالة الإطار التالي:

   • GoogleRidesharingDriver.xcframework

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

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

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

تنبيه: كأفضل ممارسة، استخدِم Cocoapods لتثبيت Driver SDK كلما أمكن ذلك.

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

5. لتثبيت حزمة تطوير البرامج (SDK) الخاصة بالسائقين، اسحب الملف GoogleRidesharingDriver.xcframework إلى مشروعك ضمن Frameworks, Libraries, and Embedded Content. إذا طُلب منك ذلك، اختَر نسخ العناصر.

6. اسحب الملف GoogleRidesharingDriver.bundle الذي تم تنزيله إلى دليل المستوى الأعلى لمشروع 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. اختَر مشروعك بدلاً من هدف محدّد، وافتح علامة التبويب الإعدادات (Build Settings). في قسم علامات الربط الأخرى، أضِف -ObjC لكل من تصحيح الأخطاء والإصدار.

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

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

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

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

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

إعداد مشروع في "وحدة تحكّم Google Cloud"