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