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

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

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

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

    المزايا:

    • إذا اكتشفت مشاكل في حزمة تطوير البرامج (SDK) لبرنامج Drive لنظام التشغيل iOS، سيتم توفير الإصلاحات بطريقة متوافقة مع الإصدارات القديمة لمدة 12 شهرًا من الإصدار الأولي من الإصدار الرئيسي، وفقًا لسياسة الدعم للأجهزة الجوّالة. ولن تحتاج إلى الترقية بشكل عاجل إلى إصدار incompatible من حزمة 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) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:

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

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

  1. في حال الترقية من إصدار أقدم من 9.0.0، عليك إزالة الاعتماديات التالية: GoogleMapsBase وGoogleMapsCore وGoogleMapsM4B بعد الترقية. يجب عدم إزالة تبعية GoogleMaps. لمعرفة مزيد من المعلومات، يمكنك الاطّلاع على ملاحظات الإصدار 9.0.0.

    من إعدادات ضبط مشروع Xcode، ابحث عن الإطارات والمكتبات والمحتوى المضمَّن. استخدِم علامة الطرح(-) لإزالة إطار العمل التالي:

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

لإزالة الموارد الاعتمادية الحالية لـ Driver SDK التي تمت إضافتها باستخدام CocoaPods، اتّبع الخطوات التالية:

  1. أغلِق مساحة عمل Xcode. افتح المحطة الطرفية ونفِّذ الأمر التالي: 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. أزِل Podfile وPodfile.resolved ورمز Xcode workspace إذا كنت لا تستخدمهما لأي غرض آخر غير CocoaPods.

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

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

كاكاوبودز

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

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

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

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

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