الحصول على Driver SDK

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

قبل البدء

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

• توفُّر حزمة SDK للتنقّل
• فعِّل حزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل iOS في Google Cloud Console واحصل على مفتاح واجهة برمجة التطبيقات.

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

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

• يجب أن يعمل الجهاز الجوّال بنظام التشغيل iOS 14 أو إصدار أحدث.
• Apple Xcode الإصدار 15 أو إصدار أحدث

الحصول على إذن الوصول إلى Google Workspace

إذا كنت أحد عملاء Google Workspace، عليك تنفيذ الخطوات التالية:

1. أنشِئ مجموعة Workspace. لمزيد من المعلومات، يُرجى الاطِّلاع على مجموعة Workspace.

   على سبيل المثال، من أفضل الممارسات تسمية مجموعتك [e-mail] أثناء عملية الإعداد.

2. قدِّم الاسم إلى Google لإضافة مجموعة Workspace إلى قائمة مسموح بها. يمنح إمكانية الوصول إلى مستودعات CocoaPods الصحيحة.

3. تأكَّد من أنّ عناوين البريد الإلكتروني للمستخدمِين وعناوين البريد الإلكتروني لحساب الخدمة التي تحتاج إلى الوصول هي المدرجة في هذه القائمة.

إذا لم تتمكّن مؤسستك من إنشاء مجموعات Workspace، أرسِل إلى Google قائمة بعناوين البريد الإلكتروني لحسابات المستخدمين وحسابات الخدمات التي تحتاج إلى الوصول إلى هذه العناصر.

ملاحظة: تختلف مجموعات Workspace عن "مجموعات Google" التي تنتهي بـ @googlegroups.com لا تتوفّر سوى "مجموعات Workspace".

تسجيل الدخول باستخدام حزمة تطوير البرامج (SDK) في السحابة الإلكترونية

لتطوير التطبيقات على الجهاز، سجِّل الدخول باستخدام حزمة Cloud SDK. لمعرفة التفاصيل، يُرجى الاطّلاع على تثبيت gcloud CLI.

توضِّح الأمثلة التالية كيفية تسجيل الدخول باستخدام حزمة تطوير البرامج (SDK) للسحابة الإلكترونية.

gcloud

gcloud auth login

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

إعداد مضيفي التشغيل الآلي

بالنسبة إلى أنظمة التصميم أو الدمج المستمر، يمكنك إعداد مضيفات التشغيل الآلي استنادًا إلى في القائمة المتوفرة لطرق استخدام حساب الخدمة للمصادقة على Google APIs وخدماته. لمعرفة التفاصيل، يُرجى الاطّلاع على قسم حساب الخدمة. في صفحة طرق المصادقة في Google.

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

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

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

الحصول على Driver SDK

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

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
      

      في ما يلي مثال يتضمن الإصدارات الأولية والتجريبية حزمة تطوير البرامج (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

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

مهم: تفترض هذه التعليمات استخدام Xcode 15 أو إصدار أحدث، ولكن يجب أن تكون مشابهة في الإصدارات السابقة من Xcode

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

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

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

1. من Xcode، انتقِل إلى "ملف > حِزم > التحديث إلى أحدث إصدارات الحِزم".
2. للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (مستكشف المشاريع) للتحقّق من الحزمة وإصدارها.

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

لإزالة تثبيت Driver SDK الحالي، يدويًا، اتبع الخطوات التالية:

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

   • GoogleRidesharingDriver.xcframework

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

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

يوضح هذا الدليل كيفية إضافة XCFramework يدويًا الذي يحتوي على حزمة تطوير البرامج (SDK) لبرنامج التشغيل إلى مشروعك وضبط إعدادات الإصدار في Xcode

ملاحظة: من أفضل الممارسات استخدام Cocoapods لتثبيت حزمة تطوير البرامج (SDK) لبرنامج Driver كلما أمكن ذلك.

قبل اتّباع هذا الدليل، عليك إجراء ما يلي:

• نزِّل 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" الذي تم تنزيله إلى المستوى الأعلى. دليل مشروع Xcode الخاص بك. اختَر نسخ الملفات إذا طُلب منك ذلك.

7. اختَر مشروعك من Project Navigator، ثم اختَر هدف التطبيق.

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 عندما لكل من تصحيح الأخطاء والإصدار.

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

فحص ملف بيان الخصوصية في Apple

تشترط Apple تفاصيل خصوصية التطبيقات للتطبيقات المتوفّرة على App Store. يُرجى الانتقال إلى صفحة تفاصيل خصوصية Apple App Store لمعرفة آخر الأخبار ومزيد من المعلومات.

يتم تضمين ملف بيان الخصوصية من Apple في حِزمة الموارد لحزمة SDK. للتأكّد من تضمين "ملف بيان الخصوصية" وفحص محتواه، عليك إنشاء أرشيف لتطبيقك وإنشاء تقرير خصوصية من الأرشيف.

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

إعداد مشروع على Google Cloud Console