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

Swift Package Manager

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

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

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

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

1. من Xcode، انتقِل إلى ملف > الحِزم > التحديث إلى آخر إصدارات الحِزم (File > Packages > Update To Latest Package Versions).
2. للتحقّق من التثبيت، انتقِل إلى قسم تبعية الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.

لإزالة حزمة تطوير البرامج (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.

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

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

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

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

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

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

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

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

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