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

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

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

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

    المزايا:

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

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

    المزايا:

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

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

تثبيت

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

مدير حزم Swift

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

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

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

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

  1. في حال الترقية من إصدار أقدم من 9.0.0، يجب إزالة التبعيات التالية: GoogleMapsBase وGoogleMapsCore و GoogleMapsM4B بعد الترقية. لا تقم بإزالة تبعية GoogleMaps لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات الإصدار 9.0.0:

    من إعدادات ضبط مشروع Xcode، ابحث عن Frameworks وLibraries والمحتوى المضمَّن استخدِم علامة الطرح(-) لإزالة إطار العمل التالي:

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

لإزالة الموارد الاعتمادية الحالية لحزمة تطوير البرامج (SDK) للمستهلكين التي تمت إضافتها باستخدام CocoaPods، يُرجى اتّباع الخطوات التالية:

  1. أغلِق مساحة عمل Xcode. افتح المحطة الطرفية ونفِّذ الأمر التالي: 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. إزالة Podfile وPodfile.resolved و Xcode workspace إذا كنت لا تستخدمهم لأي غرض آخر غير CocoaPods.

CocoaPods

CocoaPods

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

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

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', ' 2.2.0'
    end

مثال على تبعية Podfile لاستخدام الإصدار التجريبي من حزمة تطوير البرامج (SDK) للمستهلك:

    source "https://cpdc-eap.googlesource.com/ridesharing-consumer-sdk"
    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', '2.1.0-beta01.0'
    end

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

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

كاكاوبودز

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

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

يدوي

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

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