حزمة تطوير البرامج (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

يمكن تثبيت حزمة Driver SDK باستخدام Swift Package Manager. لإضافة حزمة SDK، عليك إزالة أي مثبّت حالي من حِزم SDK الخاصة بالبرامج التعريفية.

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

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

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

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

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

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

Cocoapods

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

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

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

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

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