الحصول على حزمة تطوير البرامج (SDK) للمستهلكين لنظام التشغيل iOS

اختيار النظام الأساسي: Android‏ iOS‏ JavaScript‏

لمتابعة الرحلات عند الطلب في تطبيقات المستهلكين على أجهزة iOS، استخدِم حزمة تطوير البرامج (SDK) للمستهلك. لمزيد من المعلومات ومقدمة حول تتبُّع الرحلات، يُرجى الاطّلاع على تتبُّع رحلة في iOS.

للاطّلاع على أمثلة، يمكنك مراجعة نماذج تطبيقات iOS أو النماذج المجمّعة.

لإعداد حزمة تطوير البرامج (SDK) للمستهلك في تطبيق المستهلك على iOS، اتّبِع الخطوات التالية:

1. التحقّق من الحدّ الأدنى لمتطلبات النظام
2. الحصول على حزمة تطوير البرامج (SDK) للمستهلك
3. فحص ملف بيان الخصوصية من Apple
4. إعداد مشروع في Google Cloud Console
5. الحصول على رموز المصادقة
6. إعداد حزمة تطوير البرامج (SDK) للمستهلك

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

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

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

الحصول على حزمة تطوير البرامج (SDK) للمستهلك

يمكنك تثبيت حزمة تطوير البرامج (SDK) للمستهلك وضبطها باستخدام CocoaPods.

Swift Package Manager

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

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

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

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

1. من Xcode، انتقِل إلى ملف > الحِزم > التحديث إلى آخر إصدارات الحِزم (File > Packages > Update To Latest Package Versions).
2. للتحقّق من التثبيت، انتقِل إلى قسم تبعية الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.

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

لإزالة حزمة تطوير البرامج (SDK) الحالية للمستهلك المثبَّتة يدويًا، اتّبِع الخطوات التالية:

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

   • GoogleRidesharingConsumer.xcframework

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

استخدام 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 'GoogleRidesharingConsumer'
      end
      

   3. احفظ ملف Podfile: افتح وحدة تحكّم وانتقِل إلى المجلد الذي يحتوي على ملف Podfile:

      cd <path-to-project>
      

3. تشغيل الأمر pod install: يؤدي هذا الأمر إلى تثبيت واجهات برمجة التطبيقات المحدّدة في ملف Podfile، بالإضافة إلى أي موارد اعتمادية قد تكون مرتبطة بها.

   pod install
   

4. افتح مشروعك في Xcode: أغلِق Xcode ثم افتح (انقر مرّتين) ملف ‎ .xcworkspace الخاص بمشروعك لتشغيل Xcode. لفتح المشروع لاحقًا، استخدِم ملف ‎ .xcworkspace.

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

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

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

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

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

• نزِّل XCFramework، وهي حزمة ثنائية تستخدمها لتثبيت "حزمة تطوير البرامج (SDK) للمستهلك". يمكنك استخدام هذه الحزمة على منصات متعددة، بما في ذلك الأجهزة التي تستخدم شريحة M1.

• ثبِّت حزمة تطوير البرامج (SDK) لـ "خرائط Google".

1. نزِّل الملف الثنائي لحزمة SDK ومواردها:

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

3. افتح Xcode وافتح مشروعًا أو أنشئه. إذا كنت جديدًا في نظام iOS، فأنشئ مشروعًا جديدًا وحدد قالب تطبيق iOS.

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

5. اسحب ملف gRPCCertificates.bundle الذي تم تنزيله إلى الدليل ذي المستوى الأعلى لمشروع Xcode. اختَر نسخ العناصر إذا طُلب منك ذلك.

6. لتثبيت حزمة تطوير البرامج (SDK) للمستهلك، اسحب ملف GoogleRidesharingConsumer.xcframework إلى مشروعك ضمن الأطر والمكتبات والمحتوى المضمّن. اختَر نسخ العناصر إذا طُلب منك ذلك.

7. اسحب ملف GoogleRidesharingConsumer.bundle الذي تم تنزيله إلى الدليل ذي المستوى الأعلى لمشروع Xcode. اختَر نسخ العناصر إذا طُلب منك ذلك.

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

9. افتح علامة التبويب مراحل الإنشاء (Build Phases)، وفي ربط الملفات الثنائية بالمكتبات (Link Binary with Libraries)، أضِف أُطر العمل والمكتبات التالية إذا لم تكن موجودة:

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. اختَر مشروعك، بدلاً من هدف محدّد، وافتح علامة التبويب إعدادات الإصدار (Build Settings). في قسم Other Linker Flags، أضِف -ObjC لكل من تصحيح الأخطاء والإصدار.

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

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

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

يتم تضمين ملف Apple Privacy Manifest في حزمة الموارد لحزمة SDK. للتأكّد من تضمين ملف بيان الخصوصية وفحص محتواه، أنشِئ أرشيفًا لتطبيقك وأنشِئ تقرير خصوصية من الأرشيف.

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

ضبط مشروع على Google Cloud Console