يُجري فريق "منصة خرائط Google" بانتظام تحديثات على حِزم تطوير البرامج (SDK) لإضافة ميزات جديدة وإصلاح الأخطاء وتحسين الأداء. تقدّم هذه الصفحة إرشادات حول كيفية إدارة تبعياتك على حِزم تطوير البرامج (SDK) للأجهزة الجوّالة.
ما هو الإصدار الذي يجب الربط به؟
-
بالنسبة إلى التطبيقات بالغة الأهمية، يجب الربط بأحدث إصدار فرعي من الإصدار الرئيسي الذي تستخدمه (X.*)، والترقية سنويًا إلى الإصدار الرئيسي الجديد.
عند طرح إصدارات جديدة من تطبيقك على مدار العام، قد تبدأ في استخدام إصدارات فرعية أحدث من حزمة تطوير برامج الأماكن لأجهزة iOS. لن يتطلّب ذلك إجراء تحديثات في تطبيقك لأنّ الإصدارات الفرعية الجديدة متوافقة مع الإصدارات السابقة.
المزايا:
- إذا اكتشفت مشاكل في حزمة تطوير برامج الأماكن لأجهزة iOS، سيتم توفير إصلاحات بطريقة متوافقة مع الإصدارات السابقة لمدة 12 شهرًا بعد الإصدار الأولي من رقم الإصدار الرئيسي، وفقًا لـ سياسة الدعم على الأجهزة الجوّالة. لن تحتاج إلى الترقية بشكل عاجل إلى إصدار غير متوافق من حزمة تطوير البرامج (SDK) للاستفادة من الإصلاحات.
- من السهل اعتماد أحدث التحسينات والميزات عندما يكون تطبيقك مبنيًا على أحدث إصدار.
- قد تتطلّب التحديثات السنوية التزايدية لأحدث رقم إصدار رئيسي من حزمة تطوير البرامج (SDK) جهدًا أقل لتعديل تطبيقك وإعادة كتابته واختباره، مقارنةً بالتعامل مع التغييرات غير المتوافقة مع الإصدارات السابقة التي تم إدخالها في إصدارات رئيسية متعددة.
بالنسبة إلى التطبيقات غير البالغة الأهمية، يجب الربط بأي إصدار ثابت. عند تلقّي إشعار بإيقاف الإصدار الثابت، سيكون لديك 12 شهرًا لإتاحة رمز التطبيق المعدَّل للمستخدمين.
المزايا:
- انخفاض وتيرة أعمال الصيانة.
- تستمر الإصدارات الجديدة من تطبيقك في دعم أجهزة المستخدمين التي تعمل بأنظمة تشغيل أقدم للأجهزة الجوّالة لفترة أطول (إلى أن تحتاج إلى الترقية إلى إصدار جديد من حزمة تطوير البرامج (SDK)).
يتلقّى مالكو المشاريع الذين لديهم عناوين بريد إلكتروني تتم مراقبتها إشعارات استباقية بشأن التغييرات التي تؤثّر في كل مشروع من مشاريعهم. يمكنك البقاء على اطّلاع على التحديثات الرئيسية وعمليات الإيقاف والتغييرات الأخرى.
تثبيت
Swift Package Manager
يمكن تثبيت حزمة تطوير برامج الأماكن لأجهزة iOS من خلال Swift Package Manager. لإضافة حزمة تطوير البرامج (SDK)، تأكَّد من إزالة أي تبعيات حالية لحزمة تطوير برامج الأماكن لأجهزة iOS.
لإضافة حزمة تطوير البرامج (SDK) إلى مشروع جديد أو حالي، اتّبِع الخطوات التالية:
-
افتح Xcode
projectأوworkspace، ثم انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة. - أدخِل https://github.com/googlemaps/ios-places-sdk كعنوان URL، واضغط على مفتاح الإدخال (Enter) لجلب الحزمة، وانقر على "إضافة حزمة".
-
لتثبيت
versionمعيّن، اضبط الحقل قاعدة الاعتمادية (Dependency Rule) على أحد الخيارات المستندة إلى الإصدار. بالنسبة إلى المشاريع الجديدة، ننصحك بتحديد أحدث إصدار واستخدام الخيار "الإصدار الدقيق". بعد إتمام الخطوة السابقة، انقر على "إضافة حزمة". - من نافذة اختيار منتجات الحزمة (Choose Package Products) ، تأكَّد من أنّه سيتم إضافة
GooglePlacesأوGooglePlacesSwiftأو كليهما إلى الهدف الرئيسي المحدّد. بعد إتمام الخطوة السابقة، انقر على إضافة حزمة.إذا كنت بصدد تحديث Google Places Swift من عنوان URL المتوقّف على GitHub
ملاحظة مهمة: تغيّر عنوان URL على GitHub للوصول إلى Google Places Swift بدءًا من الإصدار 0.3.0. إذا كنت بصدد تحديث إصدار من GooglePlacesSwift تم الوصول إليه من خلال عنوان URL القديم،
https://github.com/googlemaps/ios-places-swift-sdk، عليك إزالته من قسم تبعيات الحزمة في Xcode. - للتحقّق من عملية التثبيت، انتقِل إلى لوحة عام (General) الخاصة بالهدف. في الأطر والمكتبات والمحتوى المضمّن (Frameworks, Libraries, and Embedded Content)، من المفترض أن تظهر لك الحِزم المثبَّتة. يمكنك أيضًا عرض قسم تبعيات الحزمة (Package Dependencies) في مستكشف المشروع (Project Navigator) للتحقّق من الحزمة وإصدارها.
لتحديث package لمشروع حالي، اتّبِع الخطوات التالية:
-
من Xcode، انتقِل إلى ملف > الحِزم > التحديث إلى أحدث إصدارات الحزمة (File > Packages > Update To Latest Package Versions).
إذا كنت بصدد تحديث Google Places Swift من عنوان URL المتوقّف على GitHub
ملاحظة مهمة: تغيّر عنوان URL على GitHub للوصول إلى Google Places Swift بدءًا من الإصدار 0.3.0. إذا كنت بصدد تحديث إصدار من GooglePlacesSwift تم الوصول إليه من خلال عنوان URL القديم،
https://github.com/googlemaps/ios-places-swift-sdk، عليك إزالته من قسم تبعيات الحزمة في Xcode. - للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة (Package Dependencies) في مستكشف المشروع (Project Navigator) للتحقّق من الحزمة وإصدارها.
الصيانة والترقية
لإنشاء التطبيق باستخدام أحدث التحسينات، تحقَّق بانتظام من الإصدارات الأحدث وحدِّد إصداراتك. إذا كنت بصدد الترقية إلى إصدار رئيسي جديد، اطّلِع على ملاحظات الإصدار لمعرفة التغييرات غير المتوافقة مع الإصدارات السابقة وكيفية تعديل الرمز.
Swift Package Manager
لتحديث package لمشروع حالي، اتّبِع الخطوات التالية:
- للتحقّق من عملية التثبيت، انتقِل إلى قسم تبعيات الحزمة (Package Dependencies) في مستكشف المشروع (Project Navigator) للتحقّق من الحزمة وإصدارها.
التثبيت اليدوي
يمكنك الحصول على رابط لأحدث ملفات المصدر في مقالة تثبيت حزمة تطوير البرامج (SDK).
بالإضافة إلى التحقّق من الإصدارات الأحدث، يتلقّى مالكو مشاريع Google Cloud المشاريع رسائل إلكترونية بشأن التغييرات غير المتوافقة مع الإصدارات السابقة والتي قد تؤثّر في مشاريعهم. لتلقّي إشعار استباقي بشأن التغييرات غير المتوافقة مع الإصدارات السابقة، عليك منح دور المالك مع عنوان بريد إلكتروني تتم مراقبته لكل مشروع من مشاريعك.