بعد تفعيل الفوترة وإنشاء مفتاح واجهة برمجة التطبيقات، يمكنك إعداد مشروع Xcode الذي تستخدمه لتطوير تطبيقك.
تتوفّر ملاحظات الإصدار لكل إصدار.
الخطوة 1: تثبيت البرنامج المطلوب
لإنشاء مشروع باستخدام حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" للتطبيقات المتوافقة مع iOS، يجب توفّر ما يلي:
- الإصدار 26.0 من Xcode أو إصدار أحدث
الخطوة 2: إنشاء مشروع Xcode وتثبيت حزمة تطوير برامج الأماكن لأجهزة iOS
Swift Package Manager
يمكن تثبيت حزمة تطوير برامج الأماكن لأجهزة iOS من خلال Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي تبعيات حالية لحزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" للتطبيقات المتوافقة مع iOS.
لإضافة حزمة تطوير البرامج (SDK) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
project أوworkspace، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies). - أدخِل https://github.com/googlemaps/ios-places-sdk كعنوان URL، واضغط على مفتاح Enter لسحب الحزمة، ثم انقر على "إضافة حزمة".
-
لتثبيت
versionمعيّن، اضبط الحقل قاعدة الاعتمادية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار واستخدام الخيار "الإصدار الدقيق". بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة". - من نافذة اختيار منتجات الحزمة، تأكَّد من أنّه ستتم إضافة
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. - للتحقّق من التثبيت، انتقِل إلى لوحة عامة في الهدف. في الأطر والمكتبات والمحتوى المضمّن، من المفترض أن تظهر لك الحِزم المثبَّتة. يمكنك أيضًا الاطّلاع على قسم تبعيات الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.
لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:
-
من 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. - للتحقّق من التثبيت، انتقِل إلى قسم تبعية الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.
لإزالة حزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" للتطبيقات المتوافقة مع iOS المثبَّتة يدويًا، اتّبِع الخطوات التالية:
-
من إعدادات ضبط مشروع Xcode، ابحث عن الأطر والمكتبات
والمحتوى المضمن. استخدِم علامة الطرح(-) لإزالة الإطارات التالية:
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
من دليل المستوى الأعلى لمشروع Xcode، أزِل حزمة
GooglePlaces.
التثبيت اليدوي
يوضّح هذا الدليل كيفية إضافة XCFrameworks التي تحتوي على حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS إلى مشروعك يدويًا، وكيفية ضبط إعدادات الإصدار في Xcode. XCFramework هي حزمة ثنائية يمكنك استخدامها على منصات متعددة، بما في ذلك الأجهزة التي تستخدم معالج Apple. يمكنك اختيار إضافة حزمة Places SDK لنظام التشغيل iOS أو حزمة Places Swift SDK لنظام التشغيل iOS أو كليهما.
- نزِّل الملفات الثنائية وملفات الموارد التالية لحزمة SDK:
- في حال تثبيت حزمة Places Swift SDK لنظام التشغيل iOS، ثبِّت الملفات التالية:
- استخرِج الملفات للوصول إلى XCFramework والموارد.
- افتح Xcode وافتح مشروعًا حاليًا أو أنشئ مشروعًا جديدًا. إذا كنت مبتدئًا في تطوير تطبيقات iOS، أنشئ مشروعًا جديدًا واختَر نموذج تطبيق iOS.
- أزِل أي حزم من "خرائط Google" من الإصدارات السابقة من مشروعك.
-
افتح علامة التبويب عام. اسحب XCFramework التالي إلى مشروعك
ضمن الأطر والمكتبات والمحتوى المضمّن. احرص على اختيار عدم التضمين:
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
انسخ
GooglePlaces.bundleمن GooglePlacesResources الذي نزّلته إلى الدليل ذي المستوى الأعلى لمشروع Xcode. احرص على اختيار نسخ العناصر إلى مجلد المجموعة الوجهة عندما يُطلب منك ذلك.
في حال تثبيت حزمة Places Swift SDK، انسخGooglePlacesSwift.bundleمن GooglePlacesSwiftResources التي نزّلتها إلى الدليل ذي المستوى الأعلى لمشروع Xcode. احرص على اختيار نسخ العناصر إلى مجلد المجموعة الوجهة عندما يُطلب منك ذلك. - اختَر مشروعك من "مستكشف المشروع" (Project Navigator)، ثم اختَر هدف تطبيقك.
-
افتح علامة التبويب مراحل الإنشاء (Build Phases). في ربط الملفات الثنائية بالمكتبات (Link Binary with Libraries)، أضِف أُطر العمل والمكتبات التالية:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
اختَر مشروعك، بدلاً من هدف محدّد، وافتح علامة التبويب إعدادات الإصدار. في قسم Linking - General -> Other Linker Flags، أضِف
-ObjCإلى "Debug" و "Release". إذا لم تظهر هذه الإعدادات، غيِّر الفلتر في شريط إعدادات الإصدار من أساسي إلى الكل.
الخطوة 3: إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك
في الأمثلة التالية، استبدِل YOUR_API_KEY بمفتاح واجهة برمجة التطبيقات.
أضِف مفتاح واجهة برمجة التطبيقات إلى 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 Privacy Manifest
تتطلّب Apple تفاصيل خصوصية التطبيقات على App Store. يُرجى الانتقال إلى صفحة تفاصيل الخصوصية في متجر تطبيقات Apple للاطّلاع على آخر التحديثات ومزيد من المعلومات.
يتم تضمين ملف Apple Privacy Manifest في حزمة الموارد الخاصة بحزمة تطوير البرامج (SDK). للتأكّد من تضمين ملف بيان الخصوصية وفحص محتواه، أنشِئ أرشيفًا لتطبيقك وأنشِئ تقرير خصوصية من الأرشيف.
الخطوات التالية
- ابدأ بكتابة الرمز البرمجي. ننصحك بالبدء بتنفيذ تطبيق أوّلي يحصل على المكان الحالي للمستخدم.
- بعد ضبط مشروعك، يمكنك استكشاف نماذج التطبيقات.
- استخدام ميزة "التحقّق من التطبيق" لتأمين مفتاح واجهة برمجة التطبيقات