يعدّل فريق Google Maps Platform حزم تطوير البرامج (SDK) بانتظام من خلال إضافة ميزات جديدة وإصلاح الأخطاء وتحسينات على الأداء. تقدّم هذه الصفحة إرشادات حول كيفية إدارة التبعيات في حِزم تطوير البرامج (SDK) للأجهزة الجوّالة.
ما هو الإصدار الذي تريد الربط به؟
-
بالنسبة إلى التطبيقات المهمة، يمكنك الربط بأحدث إصدار من الإصدار الرئيسي (X.*) الذي تستخدمه، والترقية سنويًا إلى الإصدار الرئيسي الجديد.
عند طرح إصدارات جديدة من تطبيقك على مدار العام، يمكنك بدء استخدام إصدارات أحدث من حزمة Places SDK لنظام التشغيل iOS. لن يتطلب ذلك إجراء تعديلات على تطبيقك لأنّ إصدارات النقاط الجديدة متوافقة مع الإصدارات القديمة.
المزايا:
- إذا رصدت مشاكل في حزمة تطوير برامج "الأماكن" لأجهزة iOS، سيتم توفير إصلاحات بطريقة متوافقة مع الإصدارات القديمة لمدة 12 شهرًا بعد الإصدار الأولي للإصدار الرئيسي، وفقًا لسياسة دعم الأجهزة الجوّالة. ولن تحتاج إلى الترقية بشكل عاجل إلى إصدار غير متوافق من حزمة SDK للاستفادة من الإصلاحات.
- من السهل استخدام أحدث التحسينات والميزات عندما يكون تطبيقك مبنيًا على أحدث إصدار.
- قد تتطلّب التحديثات السنوية المتزايدة لأحدث إصدار رئيسي من حزمة SDK جهدًا أقل في تكييف تطبيقك وإعادة كتابته واختباره، مقارنةً بمعالجة التغييرات التي لا تتوافق مع الإصدارات القديمة والتي يتم إجراؤها على مستوى إصدارات رئيسية متعددة.
بالنسبة إلى التطبيقات غير المُهمّة، يمكنك إضافة رابط إلى أي إصدار تم إصلاحه. عند تلقّي إشعار بشأن إيقاف استخدام هذا الإصدار الثابت، سيكون لديك 12 شهرًا لإتاحة رمز التطبيق المعدَّل للمستخدمين.
المزايا:
- أعمال صيانة أقل تكرارًا
- تظل الإصدارات الجديدة من تطبيقك متوافقة مع أجهزة المستخدمين التي تعمل بأنظمة تشغيل قديمة للأجهزة الجوّالة لفترة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة SDK).
يتلقّى مالكو المشاريع الذين لديهم عناوين بريد إلكتروني خاضعة للتتبّع إشعارات استباقية بشأن التغييرات التي تؤثر في كل مشروع من مشاريعهم. الاطّلاع على أخبار حول التحديثات الرئيسية وعمليات الإيقاف النهائي والتغييرات الأخرى
تثبيت
أداة إدارة حِزم Swift
يمكن تثبيت حزمة تطوير برامج "الأماكن" لنظام التشغيل iOS من خلال أداة Swift Package Manager. لإضافة حزمة تطوير البرامج، تأكَّد من أنّك أزلت أيّ تبعيات حالية لحزمة تطوير برامج "الأماكن" لنظام التشغيل iOS.
لإضافة حزمة تطوير البرامج إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
projectأوworkspace، ثم انتقِل إلى ملف > إضافة تبعيات الحزمة. - أدخِل https://github.com/googlemaps/ios-places-sdk كعنوان URL، واضغط على مفتاح Enter لسحب الحزمة، ثم انقر على "إضافة حزمة".
-
لتثبيت
versionمعيّن، اضبط حقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار و استخدام الخيار "الإصدار المحدّد". بعد الانتهاء، انقر على "إضافة حزمة". - من نافذة اختيار منتجات الحزمة، تأكّد من أنّه سيتمّ إضافة
GooglePlacesأوGooglePlacesSwiftأو كليهما إلى الاستهداف الرئيسي المحدّد. بعد الانتهاء، انقر على إضافة حزمة.في حال تعديل Google Places Swift
ملاحظة مهمة: تغيّر عنوان URL على GitHub للوصول إلى Google Places Swift بدءًا من الإصدار 0.3.0. إذا كنت بصدد تحديث إصدار من GooglePlacesSwift تم الوصول إليه من خلال عنوان URL القديم،
https://github.com/googlemaps/ios-places-swift-sdk، عليك إزالته من قسم "التبعيات في الحزمة" في Xcode. - للتحقّق من عملية التثبيت، انتقِل إلى لوحة الإعدادات العامة لهدفك. في قسم الإطارات والمراجع والمحتوى المضمّن، من المفترض أن تظهر لك الحِزم المثبَّتة. يمكنك أيضًا الاطّلاع على قسم تبعيات الحزمة في Project Navigator (مستكشف المشاريع) للتحقّق من الحزمة وإصدارها. يعرض Xcode إصدار GitHub الذي يتطابق مع إصدار GooglePlaces (على سبيل المثال 9.2.0) ولكنّه لا يتطابق مع إصدار GooglePlacesSwift (على سبيل المثال 0.3.0).
لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:
-
من Xcode، انتقِل إلى "ملف > حِزم > التحديث إلى أحدث إصدارات الحِزم".
في حال تعديل Google Places Swift
ملاحظة مهمة: تغيّر عنوان URL على GitHub للوصول إلى Google Places Swift بدءًا من الإصدار 0.3.0. إذا كنت بصدد تحديث إصدار من GooglePlacesSwift تم الوصول إليه من خلال عنوان URL القديم،
https://github.com/googlemaps/ios-places-swift-sdk، عليك إزالته من قسم "التبعيات في الحزمة" في Xcode. - للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (مستكشف المشاريع) للتحقّق من الحزمة وإصدارها.
CocoaPods
حدِّد دائمًا رقم إصدار في التبعيات بدلاً من استخدام عامل تشغيل متفائل
(~>) لأنّ ذلك قد يؤدي إلى إنشاءات غير متوقّعة وغير قابلة للتكرار. تلتزم
حزمة تطوير برامج "الأماكن" لأجهزة iOS بالتسمية الدلالية للإصدارات،
وتتضمّن إصدارات الإصدارات الرئيسية الجديدة تغييرات قد تؤدي إلى حدوث أعطال.
مثال على الاعتماد على Podfile باستخدام بنية Podfile:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GooglePlaces', '9.2.0' pod 'GooglePlacesSwift', '0.3.0' end
الصيانة والترقية
لاستخدام أحدث التحسينات، تحقَّق بانتظام من توفّر إصدارات أحدث وعدِّل مواصفات الإصدار. إذا كنت بصدد التحديث إلى إصدار رئيسي جديد، اطّلِع على ملاحظات الإصدار لمعرفة التغييرات غير المتوافقة مع الإصدارات القديمة وكيفية تعديل الرمز البرمجي.
أداة إدارة حِزم Swift
لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:
- للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (مستكشف المشاريع) للتحقّق من الحزمة وإصدارها.
Cocoapods
افتح وحدة طرفية وانتقِل إلى الدليل الذي يحتوي على
Podfile:cd <path-to-project>
- شغِّل
pod outdatedلمعرفة ما إذا كان يتوفّر إصدار أحدث من حزمة تطوير برامج "الأماكن" لنظام التشغيل iOS. - إذا تم العثور على إصدار أحدث من حزمة SDK، عليك تحديث
Podfileباستخدام هذا الإصدار الجديد. اطّلِع على مقالة تحديد إصدارات وحدات pod للتعرّف على كيفية ضبط إصدار معيّن فيPodfile. - شغِّل
pod update. - أدخِل أي تغييرات ضرورية نتيجة الترقية. يمكنك الاطّلاع على ملاحظات الإصدار للحصول على قائمة بالتغييرات في كل إصدار.
- يمكنك تنظيف مشروعك وإعادة إنشائه من خلال اختيار المنتج > تنظيف ثم المنتج > إنشاء.
التثبيت اليدوي
احصل على رابط أحدث ملفات المصدر في قسم "تثبيت حزمة تطوير البرامج (SDK)".
بالإضافة إلى الاستطلاعات بشأن الإصدارات الأحدث، يتلقّى أصحاب projects في Google Cloud رسائل إلكترونية بشأن التغييرات غير المتوافقة مع الإصدارات القديمة التي قد تؤثر في مشاريعهم. لتلقّي إشعارات استباقية بشأن التغييرات غير المتوافقة مع الإصدارات القديمة، عليك منح دور المالك باستخدام عنوان بريد إلكتروني خاضع للتتبّع لكل مشروع من مشاريعك.