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