الحصول على Driver SDK

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

قبل البدء

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

• يجب أن تكون لديك حزمة Navigation SDK.
• يجب تفعيل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS في Google Cloud Console والحصول على مفتاح واجهة برمجة التطبيقات.

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

يُرجى الاطّلاع على ملاحظات الإصدار لمعرفة الحد الأدنى من المتطلبات لإصدار Driver SDK الذي تستخدمه. راجع ملاحظات الإصدار.

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

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

إذا كنت أحد عملاء Google Workspace، يُرجى اتّباع الخطوات التالية:

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

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

2. يُرجى تزويد Google باسم مجموعة Workspace لإضافتها إلى قائمة مسموح بها تمنح إذن الوصول إلى مستودعات CocoaPods الصحيحة.

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

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

ملاحظة: لا تتطابق مجموعات Workspace مع مجموعات Google التي تنتهي بـ @googlegroups.com لا يمكن استخدام سوى مجموعات Workspace.

تسجيل الدخول باستخدام Cloud SDK

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

تعرض الأمثلة التالية كيفية تسجيل الدخول باستخدام Cloud SDK.

gcloud

gcloud auth login

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

إعداد مضيفي الأتمتة

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

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

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

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

الحصول على Driver SDK

يُرجى تثبيت Driver SDK وضبطه.

CocoaPods

1. تثبيت أداة CocoaPods: يُرجى فتح نافذة المحطة الطرفية وتنفيذ الأمر التالي.

   sudo gem install cocoapods
   

   لمزيد من التفاصيل، يُرجى الرجوع إلى دليل CocoaPods Get Started.

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
      

      إليك مثال يتضمّن مجموعات إعلانات ألفا وبيتا لحزمة 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.

   ملاحظة: يُرجى تنفيذ الأمر pod outdated بشكل دوري لرصد توفّر إصدار أحدث من حزمة SDK. لمزيد من المعلومات، يُرجى الاطّلاع على إصدارات Driver SDK لنظام التشغيل iOS.

Swift Package Manager

يمكن تثبيت Driver SDK من خلال Swift Package Manager. لإضافة حزمة SDK، يُرجى التأكّد من إزالة أي ملفات تابعة حالية لحزمة Driver SDK.

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

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

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

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

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

لإزالة حزمة Driver SDK الحالية المثبَّتة يدويًا، يُرجى اتّباع الخطوات التالية:

1. من إعدادات ضبط مشروع Xcode، يُرجى البحث عن الأطر والمكتبات والمحتوى المضمّن (Frameworks, Libraries, and Embedded Content). يُرجى استخدام علامة الطرح(-) لإزالة الإطار التالي:

   • GoogleRidesharingDriver.xcframework

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

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

يوضّح هذا الدليل كيفية إضافة XCFramework الذي يحتوي على Driver SDK إلى مشروعك يدويًا، وكيفية ضبط إعدادات الإصدار في Xcode.

تنبيه: ننصحك باستخدام Cocoapods لتثبيت Driver SDK كلما أمكن ذلك كأفضل ممارسة.

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

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

• يُرجى تثبيت حزمة Navigation SDK.

يُرجى اتّباع الخطوات التالية لتثبيت Driver SDK يدويًا:

1. يُرجى تنزيل الملف الثنائي والموارد لحزمة SDK:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

5. لتثبيت Driver SDK، يُرجى سحب ملف GoogleRidesharingDriver.xcframework إلى مشروعك ضمن الأطر والمكتبات والمحتوى المضمّن (Frameworks, Libraries, and Embedded Content). إذا طُلب منك ذلك، يُرجى اختيار نسخ العناصر (Copy items).

6. يُرجى سحب GoogleRidesharingDriver.bundle الذي تم تنزيله إلى دليل المستوى الأعلى لمشروع Xcode. إذا طُلب منك ذلك، يُرجى اختيار نسخ العناصر (Copy items).

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 لكل من وضعَي التصحيح والإصدار.

   إذا لم تظهر هذه الإعدادات، يُرجى تغيير الفلتر في شريط إعدادات الإنشاء (Build Settings) من أساسي (Basic) إلى الكل (All).

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

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

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

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

ضبط مشروع في Google Cloud Console