الحصول على Driver SDK

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

قبل البدء

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

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

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

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

• يجب أن يعمل الجهاز الجوّال بنظام التشغيل iOS 16 أو إصدار أحدث.
• الإصدار 26 أو الإصدارات الأحدث من 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. لمعرفة التفاصيل، يُرجى الاطّلاع على قسم حساب الخدمة في صفحة "طرق المصادقة في Google".

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

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

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

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

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

CocoaPods

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

   sudo gem install cocoapods
   

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

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

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

   2. عدِّل ملف 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
      

   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 Package Manager

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

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

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

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

1. من Xcode، انتقِل إلى ملف (File) > حِزم (Packages) > التحديث إلى آخر إصدارات الحِزم (Update To Latest Package Versions).
2. للتحقّق من التثبيت، انتقِل إلى قسم تبعية الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.

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

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

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

   • GoogleRidesharingDriver.xcframework

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

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

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

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

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

• نزِّل XCFramework، وهي حزمة ثنائية تستخدمها لتثبيت حزمة تطوير البرامج (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 تفاصيل خصوصية التطبيقات على متجر التطبيقات. يمكنك الانتقال إلى صفحة "تفاصيل الخصوصية" في Apple App Store للاطّلاع على آخر الأخبار والمزيد من المعلومات.

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

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

إعداد مشروع في Google Cloud Console