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

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

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

ما هو الإصدار الذي سيتم الربط به؟

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

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

  المزايا:

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

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

  المزايا:

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

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

تثبيت

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

استخدام CocoaPods

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

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

platform :ios, '14.0'

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

استخدام قرطاج

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

binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1

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

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

استخدام Cocoapods

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

   cd <path-to-project>

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

استخدام قرطاج

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

   cd <path-to-project>

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

مطالبة يدوية

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

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