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

يعمل فريق Google Maps Platform بانتظام على تحديث حِزم 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 إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:

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

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

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

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

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

Cocoapods

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

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

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

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

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