يُحدِّث فريق "منصة خرائط Google" حِزم SDK بانتظام بميزات جديدة وإصلاحات للأخطاء تحسينات في الأداء. توفر هذه الصفحة إرشادات حول كيفية إدارة تبعياتك على حزم SDK للجوّال.
ما الإصدار المطلوب الربط به؟
-
بالنسبة إلى التطبيقات المهمة للمهام، يمكنك الربط بأحدث إصدار من النقاط من منصة الذي تستخدمه (X.*)، وستتم الترقية سنويًا إلى الإصدار الرئيسي الجديد.
عند طرح إصدارات جديدة من تطبيقك على مدار العام، يمكنك البدء في استخدام إصدارات النقاط الجديدة من حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS. سيؤدي هذا إلى لا تتطلّب تحديثات في تطبيقك لأنّ إصدارات النقاط الجديدة متوافقة مع الأنظمة القديمة.
المزايا:
- إذا اكتشفت مشاكل في حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS، سيتم توفير الحلول في متوافقة مع الإصدارات القديمة لمدة 12 شهرًا بعد الإصدار الأولي للإصدار الرئيسي، دعم الجوال . لن تحتاج إلى الترقية بشكل عاجل إلى إصدار غير متوافق من حزمة تطوير البرامج (SDK). للاستفادة من الإصلاحات.
- ويكون من السهل اعتماد أحدث التحسينات والميزات عندما يكون تطبيقك مبنيًا على أحدث إصدار.
- قد تتطلّب التحديثات الإضافية السنوية لأحدث إصدار رئيسي من حزمة تطوير البرامج (SDK) جهدًا أقل. لتعديل تطبيقك وإعادة كتابته واختباره، بدلاً من التعامل مع الإصدارات غير المتوافقة مع الإصدارات القديمة التغييرات التي تم إجراؤها عبر العديد من إصدارات الإصدارات الرئيسية.
بالنسبة إلى التطبيقات غير المهمة، يمكنك الربط بأي إصدار ثابت. عند تلقّي إيقاف لذلك الإصدار الثابت، سيكون أمامك 12 شهرًا لإتاحة رمز تطبيقك المحدَّث مستخدميك.
المزايا:
- أعمال صيانة أقل تكرارًا.
- تستمر الإصدارات الجديدة من تطبيقك في دعم المستخدمين أجهزة تعمل بإصدار قديم من أجهزة الجوّال الأنظمة لمدة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة SDK).
يتلقى مالكو المشروعات الذين لديهم عناوين بريد إلكتروني خاضعة للمراقبة إشعارات استباقية حول التغييرات التي على كل مشروع من مشروعاته. البقاء على اطّلاع بالتحديثات الرئيسية وعمليات الإيقاف نهائيًا والتغييرات الأخرى.
تثبيت
مدير حزم Swift
يمكن تثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS من خلال مدير حزم Swift لإضافة حزمة تطوير البرامج (SDK)، تأكَّد من أنّ لديك تمت إزالة أي حزمة تطوير برامج (SDK) حالية للخرائط لتبعيات iOS.
لإضافة حزمة تطوير البرامج (SDK) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
project
أوworkspace
، ثم انتقِل إلى File >. أضِف تبعيات الحزمة. - أدخِل https://github.com/googlemaps/ios-maps-sdk كعنوان URL، ثم اضغط على Enter. لسحب الحزمة، والنقر فوق "Add Package" (إضافة حزمة).
-
لتثبيت قاعدة
version
محدّدة، اضبط حقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. وبالنسبة للمشروعات الجديدة، نوصي بتحديد أحدث إصدار باستخدام "الإصدار الدقيق" الخيار. بعد اكتمال عملية النقل، انقر على "إضافة حزمة". -
من نافذة اختيار منتجات الحزمة، أثبِت صحة
GoogleMaps
(بالنسبة إلى الإصدارات الأقدم من 9.0.0، تحقَّق من صحته.GoogleMaps
وGoogleMapsBase
وGoogleMapsCore
) ستتم إضافتها إلى هدفmain
المحدد. بعد اكتمال عملية النقل، انقر على "إضافة حزمة". -
للتحقّق من عملية التثبيت، انتقِل إلى جزء
General
في استهدافك. من المفترَض أن تظهر الحِزَم المثبَّتة في أُطر العمل والمكتبات والمحتوى المضمَّن. يمكنك أيضًا عرض قسم "تبعيات الحزمة" قسم "مستكشف المشروع" للتحقق من الحزمة وإصدارها.
لتعديل package
لمشروع حالي، اتّبِع الخطوات التالية:
في حال الترقية من إصدار أقدم من 9.0.0، يجب إزالة التبعيات التالية:
GoogleMapsBase
وGoogleMapsCore
وGoogleMapsM4B
بعد الترقية. لا تقم بإزالة تبعيةGoogleMaps
لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات الإصدار 9.0.0:من إعدادات ضبط مشروع Xcode، ابحث عن Frameworks وLibraries والمحتوى المضمَّن استخدِم علامة الطرح(-) لإزالة إطار العمل التالي:
GoogleMapsBase
(للترقيات من الإصدارات السابقة على 9.0.0 فقط)GoogleMapsCore
(للترقيات من الإصدارات السابقة على 9.0.0 فقط)GoogleMapsM4B
(للترقيات من الإصدارات السابقة على 9.0.0 فقط)
- من Xcode، انتقل إلى "File >" (ملف >) الحزم > التحديث إلى أحدث إصدارات الحزمة".
- للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (أداة التنقّل في المشروع) للتحقق من الحزمة وإصدارها.
لإزالة حزمة تطوير البرامج (SDK) الحالية لخرائط Google لتبعيات iOS التي تمت إضافتها باستخدام
CocoaPods
، يُرجى اتّباع الخطوات التالية:
- أغلِق مساحة عمل Xcode. افتح المحطة الطرفية ونفِّذ الأمر التالي:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
إزالة
Podfile
وPodfile.resolved
و Xcodeworkspace
إذا كنت لا تستخدمهم لأي غرض آخر غير CocoaPods.
CocoaPods
حدد دائمًا رقم إصدار في التبعيات الخاصة بك بدلاً من استخدام عامل تشغيل متفائل
(~>
) لأنّ ذلك قد يؤدي إلى إصدارات غير متوقّعة وغير قابلة للتكرار. تشير رسالة الأشكال البيانية
تلتزم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS بالإصدارات الدلالية.
وإصدارات الإصدارات الرئيسية الجديدة تتضمن تغييرات قد تؤدي إلى أعطال.
مثال على تبعية Podfile باستخدام بنية Podfile:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.4.0' end
الصيانة والترقية
للحصول على آخر التحسينات، يجب البحث بانتظام عن الإصدارات الأحدث وتحديث الإصدار. والمواصفات. إذا كنت تعمل على تحديث رئيسي جديد، تحقَّق من ملاحظات الإصدار لمعرفة التغييرات غير المتوافقة مع الإصدارات القديمة وكيفية تعديل الرمز البرمجي.
مدير حزم Swift
لتعديل package
لمشروع حالي، اتّبِع الخطوات التالية:
في حال الترقية من إصدار أقدم من 9.0.0، يجب إزالة التبعيات التالية:
GoogleMapsBase
وGoogleMapsCore
وGoogleMapsM4B
بعد الترقية. لا تقم بإزالة تبعيةGoogleMaps
لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات الإصدار 9.0.0:من إعدادات ضبط مشروع Xcode، ابحث عن Frameworks وLibraries والمحتوى المضمَّن استخدِم علامة الطرح(-) لإزالة إطار العمل التالي:
GoogleMapsBase
(للترقيات من الإصدارات السابقة على 9.0.0 فقط)GoogleMapsCore
(للترقيات من الإصدارات السابقة على 9.0.0 فقط)GoogleMapsM4B
(للترقيات من الإصدارات السابقة على 9.0.0 فقط)
- من Xcode، انتقل إلى "File >" (ملف >) الحزم > التحديث إلى أحدث إصدارات الحزمة".
- للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (أداة التنقّل في المشروع) للتحقق من الحزمة وإصدارها.
كاكاوبودز
افتح نافذة طرفية وانتقِل إلى الدليل الذي يحتوي على
Podfile
:cd <path-to-project>
- شغِّل
pod outdated
لمعرفة ما إذا كان هناك إصدار أحدث من حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS متاح. - إذا تم العثور على إصدار أحدث من حزمة SDK، يجب تحديث
Podfile
باستخدام هذا الإصدار الجديد. راجِع تحديد إصدارات المجموعة. لمعرفة كيفية ضبط إصدار محدّد فيPodfile
. - تشغيل
pod update
- أجرِ أي تغييرات ضرورية كنتيجة للترقية. يمكنك الاطّلاع على ملاحظات الإصدار للاطّلاع على قائمة بالتغييرات في كل إصدار
- عليك تنظيف مشروعك وإعادة إنشائه عن طريق اختيار المنتج >. تنظيف ثم المنتج > إنشاء
التثبيت اليدوي
الحصول على الرابط لأحدث الملفات المصدر في تثبيت حزمة SDK.
بالإضافة إلى إجراء استطلاع حول الإصدارات الأحدث، يمكن لخدمة Google Cloud المشروع المالكون يتلقون رسائل إلكترونية بشأن التغييرات غير المتوافقة مع الإصدارات القديمة والتي قد تؤثر في مشاريعهم. إلى والحصول على إشعار استباقي حول التغييرات غير المتوافقة مع الإصدارات القديمة، تعيين دور المالك مع عنوان بريد إلكتروني يتم تتبّعه لكل مشروع من مشروعاتك.