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

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

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

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

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

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

مراجعة الحد الأدنى لمتطلبات النظام

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

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

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

يمكنك تثبيت حزمة Consumer SDK وإعدادها باستخدام CocoaPods.

Swift Package Manager

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

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

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

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

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

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

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

لإزالة حزمة Consumer SDK الحالية المثبَّتة يدويًا، اتّبِع الخطوات التالية:

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

   • GoogleRidesharingConsumer.xcframework

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

استخدام CocoaPods

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

   sudo gem install cocoapods
   

   لمزيد من التفاصيل، يُرجى الرجوع إلى دليل بدء استخدام CocoaPods.

2. إنشاء ملف Podfile لحزمة Consumer 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 التي تحتوي على حزمة تطوير البرامج Consumer SDK إلى مشروعك يدويًا، وكيفية ضبط إعدادات الإصدار في Xcode.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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