الحصول على Driver SDK

gcloud

gcloud auth login

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.

Swift Package Manager

يمكن تثبيت حزمة تطوير البرامج (SDK) للسائق من خلال Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي تبعيات حالية لحزمة تطوير البرامج (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 Dependencies" (تبعيات الحزمة) في "Project Navigator" (متصفّح المشروع) للتحقّق من الحزمة وإصدارها.

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

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

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

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

   • GoogleRidesharingDriver.xcframework

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

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

يوضّح هذا الدليل كيفية إضافة XCFramework التي تحتوي على حزمة تطوير البرامج (SDK) للسائق إلى مشروعك يدويًا، وكيفية ضبط إعدادات الإصدار في Xcode.

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

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

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

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

1. نزِّل الملف الثنائي لحزمة تطوير البرامج (SDK) ومواردها:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

5. لتثبيت حزمة تطوير البرامج (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). في قسم Other Linker Flags (علامات الرابط الأخرى)، أضِف -ObjC لكلّ من تصحيح الأخطاء والإصدار.

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