إعداد مشروع Xcode

بعد تفعيل الفوترة وإنشاء مفتاح لواجهة برمجة التطبيقات، يصبح بإمكانك إعداد مشروع Xcode الذي تستخدمه لتطوير تطبيقك.

تتوفّر ملاحظات الإصدار لكل إصدار.

الخطوة 1: تثبيت البرنامج المطلوب

لإنشاء مشروع باستخدام حزمة تطوير برامج الأماكن لأجهزة iOS، تحتاج إلى:

• Xcode الإصدار 26.0 أو الإصدارات الأحدث

الخطوة 2: إنشاء مشروع Xcode وتثبيت حزمة تطوير برامج الأماكن لأجهزة iOS

Swift Package Manager

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

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

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

   إذا كنت بصدد تعديل Google Places Swift من عنوان URL المتوقّف على GitHub

   ملاحظة مهمة: تم تغيير عنوان URL على GitHub للوصول إلى Google Places Swift بدءًا من الإصدار 0.3.0. إذا كنت بصدد تعديل إصدار من GooglePlacesSwift تم الوصول إليه من خلال عنوان URL القديم، https://github.com/googlemaps/ios-places-swift-sdk، عليك إزالته من قسم موارد الاعتمادية للحزمة في Xcode.

5. للتأكّد من عملية التثبيت، انتقِل إلى لوحة عام الخاصة بالهدف. في الأطر والمكتبات والمحتوى المضمّن، من المفترض أن تظهر الحِزم المثبَّتة. يمكنك أيضًا الاطّلاع على قسم موارد الاعتمادية للحزمة في مستكشف المشروع للتأكّد من الحزمة وإصدارها.

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

1. من Xcode، انتقِل إلى ملف > الحِزم > تعديل إلى أحدث إصدارات الحزمة (File > Packages > Update To Latest Package Versions).

   إذا كنت بصدد تعديل Google Places Swift من عنوان URL المتوقّف على GitHub

   ملاحظة مهمة: تم تغيير عنوان URL على GitHub للوصول إلى Google Places Swift بدءًا من الإصدار 0.3.0. إذا كنت بصدد تعديل إصدار من GooglePlacesSwift تم الوصول إليه من خلال عنوان URL القديم، https://github.com/googlemaps/ios-places-swift-sdk، عليك إزالته من قسم موارد الاعتمادية للحزمة في Xcode.

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

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

لإزالة حزمة تطوير برامج الأماكن لأجهزة iOS المثبَّتة يدويًا، اتّبِع الخطوات التالية:

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

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

يوضّح هذا الدليل كيفية إضافة XCFrameworks التي تحتوي على حزمة تطوير برامج الأماكن لأجهزة iOS وحزمة تطوير برامج الأماكن لأجهزة iOS المستندة إلى لغة Swift إلى مشروعك يدويًا، وكيفية ضبط إعدادات الإصدار في Xcode. ‫XCFramework هي حزمة ثنائية يمكنك استخدامها على منصات متعددة، بما في ذلك الأجهزة التي تستخدم معالج Apple. يمكنك اختيار إضافة حزمة تطوير برامج الأماكن لأجهزة iOS أو حزمة تطوير برامج الأماكن لأجهزة iOS المستندة إلى لغة Swift أو كليهما.

1. نزِّل ملفات SDK الثنائية وملفات الموارد التالية:
   • GooglePlaces
   • GooglePlacesResources
2. إذا كنت بصدد تثبيت حزمة تطوير برامج الأماكن لأجهزة iOS المستندة إلى لغة Swift، ثبِّت الملفات التالية:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. استخرِج الملفات للوصول إلى XCFramework والموارد.
4. شغِّل Xcode وافتح مشروعًا حاليًا أو أنشِئ مشروعًا جديدًا. إذا كنت جديدًا على تطوير تطبيقات iOS، أنشِئ مشروعًا جديدًا واختَر نموذج تطبيق iOS.
5. أزِل أي حِزم خرائط من الإصدارات السابقة من مشروعك.
6. افتح علامة التبويب عام. اسحب XCFramework التالية إلى مشروعك ضمن الأطر والمكتبات والمحتوى المضمّن. احرص على اختيار عدم التضمين:
   • GooglePlaces.xcframework
   إذا كنت بصدد تثبيت حزمة تطوير برامج الأماكن لأجهزة iOS المستندة إلى لغة Swift، اسحب XCFramework التالية إلى مشروعك ضمن الأطر والمكتبات والمحتوى المضمّن. احرص على اختيار عدم التضمين:
   • GooglePlacesSwift.xcframework
7. انسخ GooglePlaces.bundle من GooglePlacesResources الذي نزّلته إلى دليل المستوى الأعلى لمشروع Xcode. احرص على اختيار نسخ العناصر إلى مجلد مجموعة الوجهة عند ظهور الرسالة.
   
   إذا كنت بصدد تثبيت حزمة تطوير برامج الأماكن لأجهزة iOS المستندة إلى لغة Swift، انسخ GooglePlacesSwift.bundle من GooglePlacesSwiftResources الذي نزّلته إلى دليل المستوى الأعلى لمشروع Xcode. احرص على اختيار نسخ العناصر إلى مجلد مجموعة الوجهة عند ظهور الرسالة.
8. اختَر مشروعك من "مستكشف المشروع"، ثم اختَر هدف تطبيقك.
9. افتح علامة التبويب مراحل الإنشاء. في ربط الملفات الثنائية بالمكتبات (Link Binary with Libraries)، أضِف أُطر العمل والمكتبات التالية:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. اختَر مشروعك بدلاً من هدف معيّن، وافتح علامة التبويب إعدادات الإنشاء. في قسم الربط - عام - > علامات الرابط الأخرى ، أضِف -ObjC إلى "تصحيح الأخطاء" و"الإصدار". إذا لم تظهر هذه الإعدادات، غيِّر الفلتر في شريط إعدادات الإنشاء من أساسي إلى الكل.

الخطوة 3: إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك

في الأمثلة التالية، استبدِل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات.

GooglePlacesSwift

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.swift على النحو التالي:

• أضِف عبارة الاستيراد التالية:

  import GooglePlacesSwift

• أضِف ما يلي إلى طريقة application(_:didFinishLaunchingWithOptions:) ، مع استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.swift على النحو التالي:

• أضِف عبارة الاستيراد التالية:

  import GooglePlaces

• أضِف ما يلي إلى طريقة application(_:didFinishLaunchingWithOptions:) ، مع استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

أضِف مفتاح واجهة برمجة التطبيقات إلى AppDelegate.m على النحو التالي:

• أضِف عبارة الاستيراد التالية:

  @import GooglePlaces;

• أضِف ما يلي إلى طريقة application:didFinishLaunchingWithOptions: ، مع استبدال YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

الخطوة 4 (اختيارية): فحص ملف بيان خصوصية Apple

ملاحظة: يكون ما يلي ذا صلة عند نشر تطبيقك على المتجر الإلكتروني.

تتطلّب Apple تفاصيل خصوصية التطبيق للتطبيقات على App Store. انتقِل إلى صفحة تفاصيل خصوصية التطبيق على Apple App Store للاطّلاع على آخر الأخبار ومزيد من المعلومات.

يتم تضمين ملف بيان خصوصية Apple في حزمة الموارد لحزمة SDK. للتأكّد من تضمين ملف بيان الخصوصية وفحص محتوياته، أنشِئ أرشيفًا لتطبيقك وأنشِئ تقريرًا عن الخصوصية من الأرشيف.

الخطوات التالية

• ابدأ كتابة الرمز. ننصحك بالبدء بتنفيذ تطبيق أساسي يحصل على المكان الحالي للمستخدم.
• بعد ضبط مشروعك، يمكنك استكشاف الـ تطبيقات النموذجية.
• استخدِم ميزة التحقّق من التطبيق لتأمين مفتاح واجهة برمجة التطبيقات.