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

مدير حزم Swift

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

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

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

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

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

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

1. من إعدادات ضبط مشروع Xcode، ابحث عن Frameworks، المكتبات والمحتوى المضمَّن استخدِم علامة الطرح(-) لإزالة الإطار التالي:

   • 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. اختَر مشروعك من "مستكشف المشاريع"، ثم اختَر ملف شخصي لتطبيقك.

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

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