يُحدِّث فريق "منصة خرائط Google" حِزم SDK بانتظام بميزات جديدة وإصلاحات للأخطاء تحسينات في الأداء. توفر هذه الصفحة إرشادات حول كيفية إدارة تبعياتك على حزم SDK للجوّال.
ما الإصدار المطلوب الربط به؟
-
بالنسبة إلى التطبيقات المهمة للمهام، يمكنك الربط بأحدث إصدار من النقاط من منصة الذي تستخدمه (X.*)، وستتم الترقية سنويًا إلى الإصدار الرئيسي الجديد.
عند إصدار إصدارات جديدة من تطبيقك على مدار العام، يمكنك البدء في استخدام إصدارات أحدث من حزمة Driver SDK لنظام التشغيل iOS. سيؤدي هذا إلى لا تتطلّب تحديثات في تطبيقك لأنّ إصدارات النقاط الجديدة متوافقة مع الأنظمة القديمة.
المزايا:
- إذا اكتشفت مشاكل في Driver SDK لنظام التشغيل iOS، سيتم توفير الإصلاحات في متوافقة مع الإصدارات القديمة لمدة 12 شهرًا بعد الإصدار الأولي للإصدار الرئيسي، دعم الجوال . لن تحتاج إلى الترقية بشكل عاجل إلى إصدار غير متوافق من حزمة تطوير البرامج (SDK). للاستفادة من الإصلاحات.
- ويكون من السهل اعتماد أحدث التحسينات والميزات عندما يكون تطبيقك مبنيًا على أحدث إصدار.
- قد تتطلّب التحديثات الإضافية السنوية لأحدث إصدار رئيسي من حزمة تطوير البرامج (SDK) جهدًا أقل. لتعديل تطبيقك وإعادة كتابته واختباره، بدلاً من التعامل مع الإصدارات غير المتوافقة مع الإصدارات القديمة التغييرات التي تم إجراؤها عبر العديد من إصدارات الإصدارات الرئيسية.
بالنسبة إلى التطبيقات غير المُهمّة، يمكنك إضافة رابط إلى أي إصدار تم إصلاحه. عند تلقّي إيقاف لذلك الإصدار الثابت، سيكون أمامك 12 شهرًا لإتاحة رمز تطبيقك المحدَّث مستخدميك.
المزايا:
- أعمال صيانة أقل تكرارًا.
- تستمر الإصدارات الجديدة من تطبيقك في دعم المستخدمين أجهزة تعمل بإصدار قديم من أجهزة الجوّال الأنظمة لمدة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة SDK).
يتلقى مالكو المشروعات الذين لديهم عناوين بريد إلكتروني خاضعة للمراقبة إشعارات استباقية حول التغييرات التي على كل مشروع من مشروعاته. البقاء على اطّلاع بالتحديثات الرئيسية وعمليات الإيقاف نهائيًا والتغييرات الأخرى.
تثبيت
حدد دائمًا رقم إصدار في التبعيات الخاصة بك بدلاً من استخدام
عامل متفائل (~>) لأنه قد يؤدي إلى نتائج غير متوقعة
الإصدارات غير القابلة للتكرار. تلتزم حزمة تطوير البرامج (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 لإضافة حزمة SDK، تأكَّد من أنّ لديك إزالة أي تبعيات حالية لحزمة تطوير البرامج (SDK) لبرنامج التشغيل.
لإضافة حزمة تطوير البرامج (SDK) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
projectأوworkspace، ثم انتقِل إلى ملف > إضافة تبعيات الحزمة. - أدخِل https://github.com/googlemaps/ios-driver-sdk كعنوان URL واضغط على Enter. لسحب الحزمة، والنقر فوق "Add Package" (إضافة حزمة).
-
لتثبيت قاعدة
versionمحدّدة، اضبط حقل قاعدة التبعية على أحد الخيارات المستندة إلى الإصدار. وبالنسبة للمشروعات الجديدة، نوصي بتحديد أحدث إصدار باستخدام "الإصدار الدقيق" . بعد الانتهاء، انقر على "إضافة حزمة". -
من نافذة اختيار منتجات الحزمة، تأكَّد من إضافة
GoogleRidesharingDriverإلى هدفmainالمحدد. بعد اكتمال عملية النقل، انقر على "إضافة حزمة". -
للتحقّق من عملية التثبيت، انتقِل إلى جزء
Generalفي استهدافك. من المفترَض أن تظهر الحِزَم المثبَّتة في أُطر العمل والمكتبات والمحتوى المضمَّن. يمكنك أيضًا عرض قسم "تبعيات الحزمة" قسم "مستكشف المشروع" للتحقق من الحزمة وإصدارها.
لتعديل package لمشروع حالي، اتّبِع الخطوات التالية:
- من Xcode، انتقل إلى "File >" (ملف >) الحزم > التحديث إلى أحدث إصدارات الحزمة".
- للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة في Project Navigator (أداة التنقّل في المشروع) للتحقق من الحزمة وإصدارها.
الصيانة والترقية
للحصول على أحدث التحسينات، ابحث بانتظام عن الإصدارات الأحدث لتحديث مواصفات الإصدار. إذا كنت بصدد التحديث إلى إصدار رئيسي جديد، اطّلِع على ملاحظات الإصدار لمعرفة التغييرات غير المتوافقة مع الإصدارات القديمة وكيفية تعديل الرمز البرمجي.
Cocoapods
-
افتح وحدة طرفية وانتقِل إلى الدليل الذي يحتوي على
Podfile:cd <path-to-project>
- يمكنك تشغيل "
pod outdated" لمعرفة ما إذا كان هناك إصدار أحدث تتوفّر حزمة تطوير البرامج (SDK) لبرنامج التشغيل iOS. - إذا تم العثور على إصدار أحدث من حزمة SDK، يجب تحديث
Podfileباستخدام هذا الإصدار الجديد. راجِع تحديد إصدارات المجموعة. لمعرفة كيفية ضبط إصدار محدّد فيPodfile. - شغِّل
pod update. - أدخِل أي تغييرات ضرورية نتيجة الترقية. يمكنك الاطّلاع على ملاحظات الإصدار للاطّلاع على قائمة بالتغييرات في كل إصدار
- عليك تنظيف مشروعك وإعادة إنشائه عن طريق اختيار المنتج >. تنظيف ثم المنتج > إنشاء
التثبيت اليدوي
الحصول على الرابط لأحدث الملفات المصدر في تثبيت حزمة SDK.
بالإضافة إلى إجراء استطلاع حول الإصدارات الأحدث، يمكن لخدمة Google Cloud المشروع المالكون يتلقون رسائل إلكترونية بشأن التغييرات غير المتوافقة مع الإصدارات القديمة والتي قد تؤثر في مشاريعهم. إلى والحصول على إشعار استباقي حول التغييرات غير المتوافقة مع الإصدارات القديمة، تعيين دور المالك مع عنوان بريد إلكتروني يتم تتبّعه لكل مشروع من مشروعاتك.