الحصول على Driver SDK

gcloud

gcloud auth login

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.

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

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

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

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 الذي يحتوي على Driver SDK إلى مشروعك يدويًا وضبط إعدادات الإصدار في Xcode.

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

• قم بتنزيل XCFramework، وهو حزمة ثنائية تستخدمها لتثبيت SDK لبرنامج التشغيل. يمكنك استخدام هذه الحزمة على منصات متعددة، بما في ذلك الأجهزة التي تستخدم شرائح 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 الذي تم تنزيله إلى دليل المستوى الأعلى في مشروع 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.

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