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

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

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

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

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

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

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

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

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

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

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

أداة إدارة حِزم Swift

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

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

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

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

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

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

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

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

ملاحظة: من أفضل الممارسات استخدام IDE 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. اختَر مشروعك من "مستكشف المشاريع"، ثم اختَر هدف تطبيقك.

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