الحصول على Driver SDK

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

قبل البدء

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

• يجب أن تكون حزمة Navigation SDK متوفّرة.
• فعِّل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS في وحدة تحكّم Google Cloud واحصل على مفتاح واجهة برمجة التطبيقات.

مراجعة الحد الأدنى لمتطلبات النظام

راجِع ملاحظات الإصدار لمعرفة الحد الأدنى من المتطلبات لإصدار Driver SDK الذي تستخدمه. يُرجى الاطّلاع على ملاحظات الإصدار.

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

الوصول إلى حسابك على 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

ثبِّت حزمة 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 الخاصة بحزمة تطوير البرامج 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. لمزيد من المعلومات، يُرجى الاطّلاع على إصدارات Driver SDK لنظام التشغيل iOS.

Swift Package Manager

يمكن تثبيت Driver SDK من خلال Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي تبعيات حالية لحزمة Driver SDK.

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

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

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

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework

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

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

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

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

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

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

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

7. اختَر مشروعك من "مستكشف المشروع" (Project Navigator)، ثم اختَر هدف تطبيقك.

8. افتح علامة التبويب مراحل الإنشاء (Build Phases)، ثم أضِف أُطر العمل والمكتبات التالية إلى ربط الملفات الثنائية بالمكتبات (Link Binary with Libraries) إذا لم تكن متوفّرة:

   • 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"