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

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

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

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

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

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

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

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

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

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

Swift Package Manager

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

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

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

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

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

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

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

    • 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.

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

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

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

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

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

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

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

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

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

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

  6. لتثبيت حزمة Consumer SDK، اسحب ملف GoogleRidesharingConsumer.xcframework إلى مشروعك ضمن Frameworks, Libraries, and Embedded Content. إذا طُلب منك ذلك، اختَر نسخ العناصر.

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

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

  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