حزمة تطوير برامج الأماكن لإصدارات iOS

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

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

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

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

    المزايا:

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

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

    المزايا:

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

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

تثبيت

مدير حزم Swift

يمكن تثبيت حزمة تطوير برامج الأماكن لأجهزة iOS عبر مدير حزم Swift لإضافة حزمة تطوير البرامج (SDK)، تأكَّد من أنّ لديك إزالة أي حزمة SDK حالية للأماكن لتبعيات iOS.

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

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

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

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

CocoaPods

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

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

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '8.3.0'
end

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

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

مدير حزم Swift

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

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

كاكاوبودز

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

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

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

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

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