الحصول على 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 يدويًا التي تحتوي على IDE 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 الذي تم تنزيله إلى directory الدرجة العليا من مشروع 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.

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