يُجري فريق "منصة خرائط Google" تحديثات منتظمة على حزم تطوير البرامج (SDK) لإضافة ميزات جديدة وإصلاح الأخطاء وإجراء تحسينات على الأداء. تقدّم هذه الصفحة إرشادات حول كيفية إدارة التبعيات في حِزم تطوير البرامج (SDK) للأجهزة الجوّالة.
أي إصدار يجب ربطه؟
-
بالنسبة إلى التطبيقات ذات المهام الحرجة، يمكنك الربط بأحدث إصدار فرعي من رقم الإصدار الرئيسي الذي تستخدمه (X.*)، والترقية سنويًا إلى رقم الإصدار الرئيسي الجديد.
عند طرح إصدارات جديدة من تطبيقك على مدار العام، يمكنك البدء في استخدام إصدارات أحدث من حزمة تطوير البرامج (SDK) الخاصة بالسائق لنظام التشغيل iOS. ولن يتطلّب ذلك إجراء تحديثات في تطبيقك لأنّ الإصدارات الفرعية الجديدة متوافقة مع الأنظمة القديمة.
المزايا:
- إذا اكتشفت مشاكل في حزمة SDK للسائق على أجهزة iOS، سيتم توفير الإصلاحات بطريقة متوافقة مع الأنظمة القديمة لمدة 12 شهرًا بعد الإصدار الأولي من رقم الإصدار الرئيسي، وفقًا لسياسة الدعم على الأجهزة الجوّالة. لن تحتاج إلى الترقية بشكل عاجل إلى إصدار حزمة SDK غير متوافق للاستفادة من الإصلاحات.
- يسهل استخدام أحدث التحسينات والميزات عندما يكون تطبيقك مصمّمًا على أحدث إصدار.
- قد تتطلّب التحديثات السنوية المتزايدة لأحدث رقم إصدار رئيسي من حزمة تطوير البرامج (SDK) جهدًا أقل لتكييف تطبيقك وإعادة كتابته واختباره مقارنةً بالتعامل مع التغييرات غير المتوافقة مع الأنظمة القديمة التي يتم إدخالها في إصدارات رئيسية متعددة.
بالنسبة إلى التطبيقات غير المُهمّة، يمكنك الربط بأي إصدار تم إصلاحه. عندما تتلقّى إشعارًا بإيقاف الإصدار الثابت نهائيًا، سيكون لديك 12 شهرًا لإتاحة رمز التطبيق المحدَّث للمستخدمين.
المزايا:
- أعمال صيانة أقل تكرارًا
- تستمر الإصدارات الجديدة من تطبيقك في دعم أجهزة المستخدمين التي تعمل بأنظمة تشغيل أقدم للأجهزة الجوّالة لفترة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة تطوير البرامج (SDK)).
يتلقّى مالكو المشاريع الذين لديهم عناوين بريد إلكتروني خاضعة للمراقبة إشعارات استباقية بشأن التغييرات التي تؤثر في كل مشروع من مشاريعهم. البقاء على اطّلاع على آخر الأخبار حول التحديثات الرئيسية وعمليات الإيقاف والتغييرات الأخرى
تثبيت
يجب دائمًا تحديد رقم إصدار في التبعيات بدلاً من استخدام عامل تشغيل متفائل (~>) لأنّ ذلك قد يؤدي إلى إصدارات غير متوقعة وغير قابلة للتكرار. تلتزم حزمة تطوير البرامج (SDK) الخاصة بالسائق لنظام التشغيل iOS
بنظام تحديد الإصدارات الدلالي، وتتضمّن أرقام الإصدارات الرئيسية الجديدة
تغييرات قد تؤدي إلى عطل.
CocoaPods
في ما يلي مثال على تبعية Podfile باستخدام بنية Podfile:
source "https://github.com/CocoaPods/Specs.git"
target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
pod 'GoogleRidesharingDriver', '2.0.0'
end
Swift Package Manager
يمكن تثبيت حزمة تطوير البرامج (SDK) للسائق من خلال Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي تبعيات حالية لحزمة تطوير البرامج (SDK) للسائق.
لإضافة حزمة تطوير البرامج (SDK) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
project أوworkspace، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies). - أدخِل https://github.com/googlemaps/ios-driver-sdk كعنوان URL، واضغط على مفتاح Enter لسحب الحزمة، ثم انقر على "إضافة حزمة".
-
لتثبيت
versionمعيّن، اضبط الحقل قاعدة الاعتمادية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار واستخدام الخيار "الإصدار الدقيق". بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة". -
من نافذة اختيار منتجات الحزمة، تأكَّد من أنّه ستتم إضافة
GoogleRidesharingDriverإلى هدفmainالمحدّد. بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة". - للتحقّق من التثبيت، انتقِل إلى لوحة عام في الهدف. في الأطر والمكتبات والمحتوى المضمّن، من المفترض أن تظهر لك الحِزم المثبَّتة. يمكنك أيضًا الاطّلاع على قسم "Package Dependencies" (تبعيات الحزمة) في "Project Navigator" (متصفّح المشروع) للتحقّق من الحزمة وإصدارها.
لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:
- من Xcode، انتقِل إلى ملف (File) > الحِزم (Packages) > التحديث إلى آخر إصدارات الحِزم (Update to Latest Package Versions).
- للتحقّق من التثبيت، انتقِل إلى قسم تبعيّات الحزمة في Project Navigator للتحقّق من الحزمة وإصدارها.
الصيانة والترقية
للاستفادة من أحدث التحسينات، تحقَّق بانتظام من توفّر إصدارات أحدث وعدِّل مواصفات الإصدار الذي تستخدمه. إذا كنت بصدد التحديث إلى رقم إصدار رئيسي جديد، يُرجى الاطّلاع على ملاحظات الإصدار لمعرفة التغييرات غير المتوافقة مع الأنظمة القديمة وكيفية تعديل الرمز البرمجي.
Cocoapods
-
افتح وحدة طرفية وانتقِل إلى الدليل الذي يحتوي على
Podfile:cd <path-to-project>
- شغِّل
pod outdatedلمعرفة ما إذا كان يتوفّر إصدار أحدث من حزمة تطوير البرامج (SDK) لبرامج التشغيل لنظام التشغيل iOS. - إذا تم العثور على إصدار أحدث من حزمة SDK، يُرجى تحديث
Podfileبهذا الإصدار الجديد. يمكنك الاطّلاع على تحديد إصدارات pod لمعرفة كيفية ضبط إصدار معيّن فيPodfile. - شغِّل
pod update. - أدخِل أي تغييرات ضرورية نتيجة الترقية. يمكنك الاطّلاع على ملاحظات الإصدار للحصول على قائمة بالتغييرات في كل إصدار.
- نظِّف مشروعك وأعِد إنشاؤه من خلال اختيار المنتج (Product) > تنظيف (Clean) ثم المنتج (Product) > إنشاء (Build).
التثبيت اليدوي
احصل على رابط لأحدث ملفات المصدر في "تثبيت حزمة تطوير البرامج (SDK)".
بالإضافة إلى البحث عن الإصدارات الأحدث، يتلقّى مالكو المشاريع على Google Cloud رسائل إلكترونية حول التغييرات غير المتوافقة مع الأنظمة القديمة والتي قد تؤثر في مشاريعهم. لتلقّي إشعارات استباقية بشأن التغييرات غير المتوافقة مع الأنظمة القديمة، عليك تعيين دور المالك باستخدام عنوان بريد إلكتروني خاضع للمراقبة لكل مشروع من مشاريعك.