حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لإصدارات iOS

اختَر النظام الأساسي: Android iOS JavaScript

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

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

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

    المزايا:

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

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

    المزايا:

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

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

تثبيت

يجب دائمًا تحديد رقم الإصدار في الاعتماديات بدلاً من استخدام عامل تشغيل متفائل (~>) لأنّ ذلك قد يؤدي إلى إنشاء إصدارات غير متوقعة وغير قابلة للتكرار. تتقيَّد حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS بالإصدار الدلالي، وتتضمّن إصدارات الإصدار الرئيسية الجديدة تغييرات قد تؤدي إلى أعطال.

مثال على اعتمادية Podfile باستخدام بنية Podfile:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '14.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '8.2.0'
end

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

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

استخدام Cocoapods

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

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

يدوي

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

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