تیم پلتفرم نقشههای گوگل مرتباً SDKها را با ویژگیهای جدید، رفع اشکالات و بهبود عملکرد بهروزرسانی میکند. این صفحه راهنماییهایی در مورد نحوه مدیریت وابستگیهای شما به SDKهای موبایل ارائه میدهد.
به کدام نسخه لینک بدهیم؟
برای برنامههای حیاتی ، به آخرین نسخهٔ منتشر شده از نسخهٔ اصلی که استفاده میکنید (X.*) لینک دهید و سالانه آن را به نسخهٔ اصلی جدید ارتقا دهید.
همزمان با انتشار نسخههای جدید برنامهتان در طول سال، میتوانید از نسخههای جدیدتر Maps SDK برای اندروید استفاده کنید. این کار نیازی به بهروزرسانی برنامهتان نخواهد داشت زیرا نسخههای جدید dot با نسخههای قبلی سازگار هستند.
مزایا:
- اگر در SDK نقشههای اندروید مشکلی پیدا کنید، طبق سیاست پشتیبانی موبایل، اصلاحات به مدت ۱۲ ماه پس از انتشار اولیه نسخه اصلی، به صورت سازگار با نسخههای قبلی ارائه خواهد شد. برای بهرهمندی از اصلاحات، نیازی به ارتقاء فوری به نسخه SDK ناسازگار نخواهید داشت.
- وقتی برنامه شما از قبل بر اساس آخرین نسخه ساخته شده باشد، جدیدترین پیشرفتها و ویژگیها به راحتی قابل استفاده هستند.
- بهروزرسانیهای تدریجی سالانه برای جدیدترین نسخه اصلی SDK ممکن است به کار کمتری برای تطبیق، بازنویسی و آزمایش برنامه شما نیاز داشته باشد، در مقایسه با اینکه مجبور باشید تغییرات ناسازگار با نسخههای قبلی را که در چندین نسخه اصلی منتشر شدهاند، مدیریت کنید.
برای برنامههای غیرحیاتی ، به هر نسخه اصلاحشدهای لینک دهید. وقتی اخطار منسوخ شدن آن نسخه اصلاحشده را دریافت کردید، ۱۲ ماه فرصت خواهید داشت تا کد بهروزرسانیشده برنامه خود را در دسترس کاربرانتان قرار دهید.
مزایا:
- کارهای تعمیر و نگهداری کمتر.
- نسخههای جدید برنامه شما، دستگاههای کاربرانی که سیستم عاملهای قدیمیتر موبایل را اجرا میکنند، برای مدت طولانیتری پشتیبانی میکنند (تا زمانی که نیاز به ارتقاء به نسخه جدید SDK داشته باشید).
صاحبان پروژه با آدرسهای ایمیل تحت نظارت، اعلانهای پیشگیرانهای در مورد تغییراتی که بر هر یک از پروژههایشان تأثیر میگذارد، دریافت میکنند. از بهروزرسانیهای عمده، منسوخشدهها و سایر تغییرات مطلع باشید .
نصب
در فایل build.gradle.kts یا build.gradle سطح برنامه خود، همیشه به جای محدوده پیشوند ( + ) یا latest یک نسخه را مشخص کنید، زیرا این موارد میتوانند منجر به ساختهای غیرقابل پیشبینی و تکرارناپذیر شوند. Maps SDK برای اندروید به نسخهبندی معنایی پایبند است و نسخههای اصلی جدید ممکن است شامل تغییرات جزئی باشند. حداقل سطح API پشتیبانی شده ۲۱ است .
تعیین وابستگی Maps در سرویسهای Google Play با استفاده از نحو Gradle .
dependencies { // Maps SDK for Android implementation(libs.play.services.maps) }
برای مدیریت نسخهبندی سرویسهای گوگل پلی، به راهنماییهای بیشتر مراجعه کنید.
نگهداری و ارتقاء
اندروید استودیو بهطور خودکار نسخههای جدیدتر موجود را بررسی میکند و در صورت وجود نسخه جدیدتر از یک وابستگی، هشدار میدهد. برای به حداقل رساندن بدهی فنی، در اسرع وقت به جدیدترین نسخه موجود بهروزرسانی کنید. اگر در حال بهروزرسانی به یک نسخه اصلی جدید هستید، یادداشتهای انتشار را برای تغییرات ناسازگار با نسخههای قبلی و نحوه بهروزرسانی کد خود بررسی کنید .
علاوه بر نظرسنجی برای نسخههای جدیدتر، صاحبان پروژههای Google Cloud ایمیلهایی در مورد تغییرات ناسازگار با نسخههای قبلی که ممکن است بر پروژههایشان تأثیر بگذارد، دریافت میکنند. برای دریافت اعلانهای پیشگیرانه در مورد تغییرات ناسازگار با نسخههای قبلی، برای هر یک از پروژههای خود، یک آدرس ایمیل تحت نظارت به نقش مالک اختصاص دهید .