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

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

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

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

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.

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

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

قبل اتّباع هذا الدليل، عليك إجراء ما يلي:

• نزِّل 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. اختَر مشروعك من Project Navigator واختر هدف تطبيقك.

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 لكل من وضعَي تصحيح الأخطاء والإصدار.

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