الحصول على حزمة تطوير البرامج (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 أو إصدار أحدث.
• يجب أن يكون لديك Apple Xcode الإصدار 26 أو إصدار أحدث.

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

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

Swift Package Manager

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

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

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

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

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

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

لإزالة حزمة تطوير البرامج (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). لمزيد من المعلومات، يُرجى الاطّلاع على إصدارات حزمة تطوير البرامج (SDK) للمستهلكين في ملاحظات إصدار حزمة تطوير البرامج (SDK) للمستهلكين.

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

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

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

قبل اتّباع هذا الدليل، نفِّذ ما يلي:

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

• ثبِّت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" .

1. نزِّل الملف الثنائي والموارد لحزمة تطوير البرامج (SDK):

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

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

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

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

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

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

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

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

9. افتح علامة التبويب مراحل الإنشاء، وفي ربط الملفات الثنائية بالمكتبات، أضِف أُطر العمل والمكتبات التالية إذا لم تكن متوفّرة من قبل:

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

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

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

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

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

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

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