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

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

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

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

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

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

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

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

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

الحصول على حزمة Consumer SDK

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

Swift Package Manager

يمكن تثبيت حزمة Consumer SDK من خلال Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي تبعيات حالية لحزمة Consumer SDK.

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

1. افتح Xcode project أو workspace، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة.
2. أدخِل https://github.com/googlemaps/ios-consumer-sdk كعنوان URL، واضغط على مفتاح الإدخال لجلب الحزمة، وانقر على "إضافة حزمة".
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. لمزيد من المعلومات، يُرجى الاطّلاع على إصدارات حزمة Consumer SDK في ملاحظات إصدار حزمة Consumer SDK.

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

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

تنبيه: كأفضل ممارسة، استخدِم Cocoapods لتثبيت حزمة Consumer 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. لتثبيت حزمة Consumer SDK، اسحب ملف GoogleRidesharingConsumer.xcframework إلى مشروعك ضِمن الأطر والمكتبات والمحتوى المضمّن. إذا طُلب منك ذلك، اختَر نسخ العناصر.

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

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

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

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

مراجعة ملف بيان خصوصية Apple

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

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

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

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