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