يعمل فريق "منصة خرائط Google" بانتظام على تحديث حِزم SDK بإضافة ميزات جديدة وإصلاح الأخطاء وتحسين الأداء. تقدّم هذه الصفحة إرشادات حول كيفية إدارة تبعياتك على حِزم SDK للأجهزة الجوّالة.
ما هو الإصدار الذي يجب الربط به؟
-
بالنسبة إلى التطبيقات بالغة الأهمية، ننصحك بالربط بأحدث إصدار فرعي من رقم الإصدار الرئيسي الذي تستخدمه (X.*)، والترقية سنويًا إلى رقم الإصدار الرئيسي الجديد.
عند طرح إصدارات جديدة من تطبيقك على مدار العام، قد تبدأ في استخدام إصدارات فرعية أحدث من Driver SDK لنظام التشغيل iOS. لن يتطلب ذلك إجراء تحديثات في تطبيقك لأنّ الإصدارات الفرعية الجديدة متوافقة مع الإصدارات السابقة.
المزايا:
- إذا اكتشفت مشاكل في Driver SDK لنظام التشغيل iOS، سيتم توفير إصلاحات بطريقة متوافقة مع الإصدارات السابقة لمدة 12 شهرًا بعد الإصدار الأولي من رقم الإصدار الرئيسي، وفقًا لـ سياسة الدعم على الأجهزة الجوّالة. لن تحتاج إلى الترقية بشكل عاجل إلى إصدار غير متوافق من حزمة SDK للاستفادة من الإصلاحات.
- من السهل اعتماد أحدث التحسينات والميزات عندما يكون تطبيقك مبنيًا على أحدث إصدار.
- قد تتطلب التحديثات السنوية الإضافية لأحدث رقم إصدار رئيسي من حزمة تطوير البرامج (SDK) جهدًا أقل لتكييف تطبيقك وإعادة كتابته واختباره، مقارنةً بالتعامل مع التغييرات غير المتوافقة مع الإصدارات السابقة التي تم إدخالها في إصدارات رئيسية متعددة.
بالنسبة إلى التطبيقات غير بالغة الأهمية، يمكنك الربط بأي إصدار ثابت. عند تلقّي إشعار بإيقاف الإصدار الثابت، سيكون لديك 12 شهرًا لإتاحة رمز تطبيقك المعدَّل للمستخدمين.
المزايا:
- انخفاض وتيرة أعمال الصيانة.
- تستمر الإصدارات الجديدة من تطبيقك في دعم أجهزة المستخدمين التي تعمل بأنظمة تشغيل أقدم للأجهزة الجوّالة لفترة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة SDK).
يتلقّى مالكو المشاريع الذين لديهم عناوين بريد إلكتروني خاضعة للمراقبة إشعارات استباقية بشأن التغييرات التي تؤثر في كل مشروع من مشاريعهم. يمكنك البقاء على اطّلاع على التحديثات الرئيسية وعمليات الإيقاف والتغييرات الأخرى.
تثبيت
ننصحك دائمًا بتحديد رقم إصدار في تبعياتك بدلاً من استخدام عامل التشغيل المتفائل (~>) لأنّ ذلك قد يؤدي إلى عمليات إنشاء غير متوقعة وغير قابلة للتكرار. تتّبع حزمة Driver 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
يمكن تثبيت Driver SDK من خلال Swift Package Manager. لإضافة حزمة SDK، تأكَّد من إزالة أي تبعيات حالية لحزمة Driver SDK.
لإضافة حزمة SDK إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح
projectأوworkspaceفي Xcode، ثم انتقِل إلى File > Add Package Dependencies. - أدخِل https://github.com/googlemaps/ios-driver-sdk كعنوان URL، واضغط على مفتاح الإدخال لجلب الحزمة، ثم انقر على "إضافة حزمة".
-
لتثبيت
versionمعيّن، اضبط الحقل قاعدة الاعتمادية على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار واستخدام الخيار "الإصدار الدقيق". بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة".
لتحديث package لمشروع حالي، اتّبِع الخطوات التالية:
- للتحقّق من عملية التثبيت، انتقِل إلى قسم موارد الاعتمادية للحزمة في مستكشف المشروع للتحقّق من الحزمة وإصدارها.
الصيانة والترقية
لإنشاء التطبيق باستخدام أحدث التحسينات، تحقَّق بانتظام من الإصدارات الأحدث وحدِّد مواصفات الإصدار. إذا كنت بصدد الترقية إلى رقم إصدار رئيسي جديد، اطّلِع على ملاحظات الإصدار لمعرفة التغييرات غير المتوافقة مع الإصدارات السابقة وكيفية تحديث الرمز.
Cocoapods
-
افتح نافذة طرفية وانتقِل إلى الدليل الذي يحتوي على
Podfile:cd <path-to-project>
- نفِّذ الأمر
pod outdatedلمعرفة ما إذا كان يتوفّر إصدار أحدث من Driver SDK لنظام التشغيل iOS. - إذا تم العثور على إصدار أحدث من حزمة SDK، حدِّث
Podfileبهذا الإصدار الجديد. راجِع تحديد إصدارات pod للتعرّف على كيفية ضبط إصدار معيّن فيPodfile. - نفِّذ الأمر
pod update. - أجرِ أي تغييرات ضرورية نتيجةً للترقية. راجِع ملاحظات الإصدار للاطّلاع على قائمة بالتغييرات في كل إصدار.
- نظِّف مشروعك وأعِد إنشائه من خلال النقر على المنتج > تنظيف ثم على المنتج > إنشاء
التثبيت اليدوي
يمكنك الحصول على رابط لأحدث ملفات المصدر في مقالة تثبيت حزمة SDK.
بالإضافة إلى التحقّق من الإصدارات الأحدث، يتلقّى مالكو مشاريع Google Cloud المشاريع رسائل إلكترونية بشأن التغييرات غير المتوافقة مع الإصدارات السابقة التي قد تؤثر في مشاريعهم. لتلقّي إشعار استباقي بشأن التغييرات غير المتوافقة مع الإصدارات السابقة، عليك منح دور المالك مع عنوان بريد إلكتروني خاضع للمراقبة لكل مشروع من مشاريعك.