يُجري فريق "منصة خرائط Google" تحديثات منتظمة على حِزم SDK تتضمّن ميزات جديدة وإصلاحات للأخطاء وتحسينات على الأداء. تقدّم هذه الصفحة إرشادات حول كيفية إدارة التبعيات على حِزم تطوير البرامج (SDK) للأجهزة الجوّالة.
ما هو الإصدار الذي تريد الربط به؟
-
بالنسبة إلى التطبيقات ذات الأهمية البالغة، يجب الربط بأحدث إصدار ثانوي من رقم الإصدار الرئيسي الذي تستخدمه (X.*)، والترقية سنويًا إلى رقم الإصدار الرئيسي الجديد.
عند طرح إصدارات جديدة من تطبيقك على مدار العام، يمكنك البدء في استخدام إصدارات أحدث من حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS. ولن يتطلّب ذلك إجراء تحديثات في تطبيقك لأنّ إصدارات النقاط الجديدة متوافقة مع الإصدارات السابقة.
المزايا:
- في حال رصدت مشاكل في حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS، سيتم توفير إصلاحات بطريقة متوافقة مع الأنظمة القديمة لمدة 12 شهرًا بعد الإصدار الأوّلي من رقم الإصدار الرئيسي، وذلك وفقًا لسياسة دعم الأجهزة الجوّالة. لن تحتاج إلى الترقية بشكل عاجل إلى إصدار غير متوافق من حزمة SDK للاستفادة من الإصلاحات.
- يمكنك الاستفادة بسهولة من أحدث التحسينات والميزات عندما يكون تطبيقك مبنيًا على أحدث إصدار.
- قد تتطلّب التحديثات السنوية التزايدية إلى أحدث رقم إصدار رئيسي من حزمة تطوير البرامج (SDK) مجهودًا أقل للتكيّف مع تطبيقك وإعادة كتابته واختباره، مقارنةً بالتعامل مع التغييرات غير المتوافقة مع الإصدارات السابقة التي تم إدخالها في عدة أرقام إصدارات رئيسية.
بالنسبة إلى التطبيقات غير المهمة، يمكنك تقديم رابط إلى أي إصدار تم إصلاحه. عند تلقّي إشعار بإيقاف الإصدار الثابت نهائيًا، سيكون لديك 12 شهرًا لإتاحة رمز تطبيقك المعدَّل للمستخدمين.
المزايا:
- انخفاض في أعمال الصيانة المتكررة
- تستمر الإصدارات الجديدة من تطبيقك في توفير الدعم لأجهزة المستخدمين التي تعمل بأنظمة تشغيل أقدم للأجهزة الجوّالة لفترة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة تطوير البرامج (SDK)).
يتلقّى "مالكو المشاريع" الذين لديهم عناوين بريد إلكتروني يتم تتبّعها إشعارات استباقية بشأن التغييرات التي تؤثر في كل مشروع من مشاريعهم. البقاء على اطّلاع على التحديثات الرئيسية وعمليات الإيقاف النهائي والتغييرات الأخرى
تثبيت
Swift Package Manager
يمكن تثبيت حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS من خلال Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي تبعيات حالية لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS.
لإضافة حزمة SDK إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
project أوworkspace، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies). - أدخِل https://github.com/googlemaps/ios-maps-sdk كعنوان URL، واضغط على Enter لجلب الحزمة، ثم انقر على "إضافة حزمة".
-
لتثبيت
versionمعيّن، اضبط الحقل قاعدة الاعتمادية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار واستخدام الخيار "الإصدار الدقيق". بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة". -
من نافذة اختيار منتجات الحزمة، تأكَّد من أنّه سيتم إضافة
GoogleMaps(بالنسبة إلى الإصدارات الأقدم من 9.0.0، تأكَّد من إضافةGoogleMapsوGoogleMapsBaseوGoogleMapsCore) إلى هدفmainالمحدّد. بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة". - للتحقّق من عملية التثبيت، انتقِل إلى لوحة الإعدادات العامة الخاصة بالهدف. في الأطر والمكتبات والمحتوى المضمّن، يجب أن تظهر الحِزم المثبَّتة. يمكنك أيضًا الاطّلاع على قسم "توابع الحزمة" في "مستكشف المشاريع" للتحقّق من الحزمة وإصدارها.
لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:
إذا كنت بصدد الترقية من إصدار أقدم من 9.0.0، عليك إزالة موارد الاعتمادية التالية:
GoogleMapsBaseوGoogleMapsCoreوGoogleMapsM4Bبعد الترقية. لا تُزِل الاعتمادية الخاصة بـGoogleMaps. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات الإصدار 9.0.0.من إعدادات ضبط مشروع Xcode، ابحث عن الأطر والمكتبات والمحتوى المضمّن. استخدِم علامة الطرح(-) لإزالة إطار العمل التالي:
GoogleMapsBase(للترقية من إصدارات أقدم من 9.0.0 فقط)GoogleMapsCore(للترقية من إصدارات أقدم من 9.0.0 فقط)GoogleMapsM4B(للترقية من إصدارات أقدم من 9.0.0 فقط)
- من Xcode، انتقِل إلى ملف > الحِزم > التحديث إلى أحدث إصدارات الحِزم (File > Packages > Update To Latest Package Versions).
- للتحقّق من عملية التثبيت، انتقِل إلى قسم متطلبات الحزمة في مستكشف المشاريع للتحقّق من الحزمة وإصدارها.
لإزالة موارد الاعتمادية الحالية لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS التي تمت إضافتها باستخدام
CocoaPods، اتّبِع الخطوات التالية:
- أغلِق مساحة عمل Xcode. افتح الوحدة الطرفية ونفِّذ الأمر التالي:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
أزِل
PodfileوPodfile.resolvedوworkspaceفي Xcode إذا كنت لا تستخدمها لأي غرض آخر غير CocoaPods.
الصيانة والترقية
للاستفادة من أحدث التحسينات، تحقَّق بانتظام من توفّر إصدارات أحدث وعدِّل مواصفات الإصدار. إذا كنت بصدد التحديث إلى رقم إصدار رئيسي جديد، راجِع ملاحظات الإصدار لمعرفة التغييرات غير المتوافقة مع الإصدارات السابقة وكيفية تعديل الرمز البرمجي.
Swift Package Manager
لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:
- للتحقّق من عملية التثبيت، انتقِل إلى قسم متطلبات الحزمة في مستكشف المشاريع للتحقّق من الحزمة وإصدارها.
التثبيت اليدوي
يمكنك الحصول على رابط لأحدث ملفات المصدر في مقالة تثبيت حزمة تطوير البرامج (SDK).
بالإضافة إلى البحث عن إصدارات أحدث، يتلقّى مالكو المشاريع على Google Cloud رسائل إلكترونية بشأن التغييرات غير المتوافقة مع الإصدارات القديمة والتي قد تؤثّر في مشاريعهم. للحصول على إشعار استباقي بشأن التغييرات غير المتوافقة مع الإصدارات السابقة، عليك تعيين دور المالك مع عنوان بريد إلكتروني يتم تتبّعه لكل مشروع من مشاريعك.