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