حزمة تطوير البرامج (SDK) لبرنامج التشغيل لإصدارات iOS

يُحدِّث فريق "منصة خرائط Google" حِزم SDK بانتظام بميزات جديدة وإصلاحات للأخطاء تحسينات في الأداء. توفر هذه الصفحة إرشادات حول كيفية إدارة تبعياتك على حزم SDK للجوّال.

ما الإصدار المطلوب الربط به؟

• بالنسبة إلى التطبيقات المهمة للمهام، يمكنك الربط بأحدث إصدار من النقاط من منصة الذي تستخدمه (X.*)، وستتم الترقية سنويًا إلى الإصدار الرئيسي الجديد.

  عند طرح إصدارات جديدة من تطبيقك على مدار العام، يمكنك البدء في استخدام إصدارات النقاط الجديدة من Driver SDK لنظام التشغيل iOS. سيؤدي هذا إلى لا تتطلّب تحديثات في تطبيقك لأنّ إصدارات النقاط الجديدة متوافقة مع الأنظمة القديمة.

  المزايا:

  • إذا اكتشفت مشاكل في Driver SDK لنظام التشغيل iOS، سيتم توفير الإصلاحات في متوافقة مع الإصدارات القديمة لمدة 12 شهرًا بعد الإصدار الأولي للإصدار الرئيسي، دعم الجوال . لن تحتاج إلى الترقية بشكل عاجل إلى إصدار غير متوافق من حزمة تطوير البرامج (SDK). للاستفادة من الإصلاحات.
  • ويكون من السهل اعتماد أحدث التحسينات والميزات عندما يكون تطبيقك مبنيًا على أحدث إصدار.
  • قد تتطلّب التحديثات الإضافية السنوية لأحدث إصدار رئيسي من حزمة تطوير البرامج (SDK) جهدًا أقل. لتعديل تطبيقك وإعادة كتابته واختباره، بدلاً من التعامل مع الإصدارات غير المتوافقة مع الإصدارات القديمة التغييرات التي تم إجراؤها عبر العديد من إصدارات الإصدارات الرئيسية.

• بالنسبة إلى التطبيقات غير المهمة، يمكنك الربط بأي إصدار ثابت. عند تلقّي إيقاف لذلك الإصدار الثابت، سيكون أمامك 12 شهرًا لإتاحة رمز تطبيقك المحدَّث مستخدميك.

  المزايا:

  • أعمال صيانة أقل تكرارًا.
  • تستمر الإصدارات الجديدة من تطبيقك في دعم المستخدمين أجهزة تعمل بإصدار قديم من أجهزة الجوّال الأنظمة لمدة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة SDK).

يتلقى مالكو المشروعات الذين لديهم عناوين بريد إلكتروني خاضعة للمراقبة إشعارات استباقية حول التغييرات التي على كل مشروع من مشروعاته. البقاء على اطّلاع بالتحديثات الرئيسية وعمليات الإيقاف نهائيًا والتغييرات الأخرى.

تثبيت

حدد دائمًا رقم إصدار في التبعيات الخاصة بك بدلاً من استخدام عامل متفائل (~>) لأنه قد يؤدي إلى نتائج غير متوقعة الإصدارات غير القابلة للتكرار. تلتزم حزمة تطوير البرامج (SDK) لبرنامج التشغيل لأجهزة iOS بما يلي: والنسخ الدلالية، وإصدارات الإصدارات الرئيسية الجديدة التغييرات التي قد تؤدي إلى أعطال.

ملاحظة: لا تتيح حزمة 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

يمكن تثبيت Driver SDK من خلال مدير حزم Swift لإضافة حزمة SDK، تأكَّد من أنّ لديك إزالة أي تبعيات حالية لحزمة تطوير البرامج (SDK) لبرنامج التشغيل.

مهم: تفترض هذه التعليمات استخدام Xcode 15 أو إصدار أحدث، ولكن يجب أن تكون متشابهة في الإصدارات السابقة من Xcode

لإضافة حزمة تطوير البرامج (SDK) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:

1. افتح Xcode project أو workspace، ثم انتقِل إلى File >. أضِف تبعيات الحزمة.
2. أدخِل https://github.com/googlemaps/ios-driver-sdk كعنوان URL واضغط على Enter. لسحب الحزمة، والنقر فوق "Add Package" (إضافة حزمة).
3. لتثبيت قاعدة version محدّدة، اضبط حقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. وبالنسبة للمشروعات الجديدة، نوصي بتحديد أحدث إصدار باستخدام "الإصدار الدقيق" . بعد اكتمال عملية النقل، انقر على "إضافة حزمة".
4. من نافذة اختيار منتجات الحزمة، تأكَّد من إضافة GoogleRidesharingDriver إلى هدف main المحدد. بعد اكتمال عملية النقل، انقر على "إضافة حزمة".
5. للتحقّق من عملية التثبيت، انتقِل إلى جزء General في استهدافك. من المفترَض أن تظهر الحِزَم المثبَّتة في أُطر العمل والمكتبات والمحتوى المضمَّن. يمكنك أيضًا عرض قسم "تبعيات الحزمة" قسم "مستكشف المشروع" للتحقق من الحزمة وإصدارها.

لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:

1. من Xcode، انتقل إلى "File >" (ملف >) الحزم > التحديث إلى أحدث إصدارات الحزمة".
2. للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (أداة التنقّل في المشروع) للتحقق من الحزمة وإصدارها.

ملاحظة مُهمّة: في بعض الأحيان، لا يمكن حلّ العناصر أو قد تحدث أخطاء. في هذه الحالة حدد "ملف > الحزم > إعادة ضبط ذاكرة التخزين المؤقت للحزمة".

الصيانة والترقية

للحصول على أحدث التحسينات، ابحث بانتظام عن الإصدارات الأحدث لتحديث مواصفات الإصدار. إذا كنت تعمل على التحديث إلى إصدار رئيسي جديد، التحقق من ملاحظات الإصدار للتعرّف على التغييرات غير المتوافقة مع الإصدارات القديمة وكيفية تعديل الرمز البرمجي

Cocoapods

1. افتح نافذة طرفية وانتقِل إلى الدليل الذي يحتوي على Podfile:

   cd <path-to-project>

2. يمكنك تشغيل "pod outdated" لمعرفة ما إذا كان هناك إصدار أحدث تتوفّر حزمة تطوير البرامج (SDK) لبرنامج التشغيل iOS.
3. إذا تم العثور على إصدار أحدث من حزمة SDK، يجب تحديث Podfile باستخدام هذا الإصدار الجديد. راجِع تحديد إصدارات المجموعة. لمعرفة كيفية ضبط إصدار محدّد في Podfile.
4. تشغيل pod update
5. أجرِ أي تغييرات ضرورية كنتيجة للترقية. يمكنك الاطّلاع على ملاحظات الإصدار للاطّلاع على قائمة بالتغييرات في كل إصدار
6. عليك تنظيف مشروعك وإعادة إنشائه عن طريق اختيار المنتج >. تنظيف ثم المنتج > إنشاء

التثبيت اليدوي

الحصول على الرابط لأحدث الملفات المصدر في تثبيت حزمة SDK.

بالإضافة إلى إجراء استطلاع حول الإصدارات الأحدث، يمكن لخدمة Google Cloud المشروع المالكون يتلقون رسائل إلكترونية بشأن التغييرات غير المتوافقة مع الإصدارات القديمة والتي قد تؤثر في مشاريعهم. إلى والحصول على إشعار استباقي حول التغييرات غير المتوافقة مع الإصدارات القديمة، تعيين دور المالك مع عنوان بريد إلكتروني يتم تتبّعه لكل مشروع من مشروعاتك.