الحصول على 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

يمكن تثبيت حزمة تطوير برامج Driver SDK من خلال أداة إدارة حِزم Swift. لإضافة حزمة SDK، تأكَّد من أنّك أزلت أيّ تبعيات حالية لحزمة Driver 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 لبرنامج IDE Developer SDK إلى مشروعك وضبط إعدادات التصميم في Xcode.

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

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

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

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

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

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