تیم Google Maps Platform به‌طور مرتب کیت‌های توسعه نرم‌افزار را با ویژگی‌های جدید، رفع اشکال، و بهبود عملکرد به‌روز می‌کند. این صفحه راهنمایی‌هایی درباره نحوه مدیریت وابستگی‌هایتان به کیت‌های توسعه نرم‌افزار تلفن همراه ارائه می‌دهد.
به کدام نسخه پیوند داده شود؟
-
برای برنامه‌های حیاتی، به جدیدترین نسخه فرعی از نسخه اصلی که استفاده می‌کنید (X.*) پیوند دهید و سالانه به نسخه اصلی جدید ارتقا دهید.
همان‌طور که نسخه‌های جدید برنامه‌تان را درطول سال منتشر می‌کنید، ممکن است شروع به استفاده از نسخه‌های جدیدتر Places SDK for Android کنید. این کار نیازی به به‌روزرسانی در برنامه شما ندارد زیرا نسخه‌های نقطه‌ای جدید سازگار با نسخه قدیمی هستند.
مزایا:
- اگر در «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» مشکلی پیدا کنید، طبق خط‌مشی پشتیبانی تلفن همراه، اصلاحات به‌مدت ۱۲ ماه پس‌از انتشار اولیه نسخه اصلی به‌صورت سازگار با نسخه قدیمی ارائه خواهد شد. برای بهره‌مندی از اصلاحات، نیازی نیست فوراً به نسخه کیت توسعه نرم‌افزار ناسازگار ارتقا دهید.
- وقتی برنامه‌تان ازقبل روی جدیدترین نسخه ساخته شده باشد، به‌کارگیری جدیدترین بهبودها و ویژگی‌ها آسان است.
- به‌روزرسانی‌های افزایشی سالانه به جدیدترین نسخه عمده کیت توسعه نرم‌افزار ممکن است به کار کمتری برای سازگار کردن، بازنویسی، و آزمایش کردن برنامه‌تان نیاز داشته باشد تا اینکه بخواهید تغییرات ناسازگار با نسخه‌های قبلی را که در چندین نسخه عمده معرفی شده‌اند مدیریت کنید.
برای برنامه‌های غیرحیاتی، به هر نسخه اصلاح‌شده‌ای پیوند دهید. وقتی برای آن نسخه اصلاح‌شده اعلان منسوخ شدن دریافت می‌کنید، ۱۲ ماه فرصت خواهید داشت تا کد برنامه به‌روزشده‌تان را دردسترس کاربران قرار دهید.
مزایا:
- کاهش دفعات کارهای تعمیر و نگهداری.
- نسخه‌های جدید برنامه‌تان همچنان از دستگاه‌های کاربران که سیستم‌عامل‌های قدیمی‌تر تلفن همراه را اجرا می‌کنند برای مدت طولانی‌تری پشتیبانی می‌کنند (تا زمانی که نیاز به ارتقا به نسخه جدید کیت توسعه نرم‌افزار داشته باشید).
«مالکان پروژه» با نشانی‌های ایمیل تحت نظارت، اعلان‌های پیش‌گیرانه‌ای درباره تغییراتی که بر هریک از پروژه‌هایشان تأثیر می‌گذارد دریافت می‌کنند. از به‌روزرسانی‌های مهم، منسوخ شدن‌ها، و تغییرات دیگر مطلع شوید.
نصب
در فایل build.gradle.kts یا build.gradle در سطح برنامه، همیشه به‌جای محدوده پیشوند (+) یا latest، نسخه را مشخص کنید زیرا این موارد می‌توانند منجر به ساخت‌های غیرقابل‌پیش‌بینی و غیرقابل‌تکرار شوند. «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» از
نسخه‌بندی معنایی پیروی می‌کند و نسخه‌های اصلی جدید
ممکن است حاوی تغییرات اساسی باشند. حداقل سطح میانای برنامه‌سازی کاربردی پشتیبانی‌شده
۲۴ است.
dependencies { // Places and Maps SDKs implementation("com.google.android.libraries.places:places:6.0.2") }
تعمیرات و نگهداری و ارتقا
Android Studio به‌طور خودکار نسخه‌های جدیدتر دردسترس را بررسی می‌کند و وقتی نسخه جدیدتری از یک وابستگی دردسترس باشد، هشداری ارائه می‌دهد. برای به‌حداقل رساندن بدهی فنی، در اسرع وقت به جدیدترین نسخه دردسترس به‌روزرسانی کنید. اگر درحال به‌روزرسانی به نسخه اصلی جدیدی هستید، یادداشت‌های انتشار را بررسی کنید تا از تغییرات ناسازگار با نسخه‌های قبلی و نحوه به‌روزرسانی کدتان مطلع شوید.
علاوه‌بر نظرسنجی برای نسخه‌های جدیدتر، مالکان پروژه Google Cloud ایمیل‌هایی درباره تغییرات ناسازگار با نسخه‌های قبلی دریافت می‌کنند که ممکن است بر پروژه‌هایشان تأثیر بگذارد. برای دریافت اعلان پیش‌کنشی درباره تغییرات ناسازگار با نسخه‌های قبلی، نقش مالک را با نشانی ایمیل تحت نظارت برای هریک از پروژه‌هایتان اختصاص دهید.
اگر از «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» نسخه ۳.۲.۰ یا قدیمی‌تر ارتقا می‌دهید
هنگام انتقال به کیت توسعه نرم‌افزار جدید، نیازی به انتقال نیست. فقط باید:
- Places API (New) را در کلید میانای برنامه‌سازی کاربردی استفاده‌شده در برنامه‌تان فعال کنید. برای اطلاعات بیشتر، استفاده از کلیدهای میانای برنامه‌سازی کاربردی را ببینید.
در بخش
dependenciesفایلbuild.gradleدر سطح واحد، وابستگیplacesرا به‌روز کنید و وابستگیkotlin-bomرا اضافه کنید:dependencies { implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0")) implementation 'com.google.android.libraries.places:places:3.5.0' }
برای اطلاعات بیشتر درباره وابستگی
kotlin-bom، به استفاده از جدیدترین نسخه kotlin-stdlib در وابستگی‌های انتقالی مراجعه کنید.- برنامه موجودتان را به‌روز کنید تا روش جدید
Places.initializeWithNewPlacesApiEnabled()را برای مقداردهی اولیه برنامه‌تان فراخوانی کند. برای اطلاعات بیشتر، مقداردهی اولیه کارخواه Places API را ببینید.
برنامه‌های موجودتان بدون تغییر به کار خود ادامه می‌دهند، اما اکنون می‌توانید از همه ویژگی‌های جدید کیت توسعه نرم‌افزار بهره‌مند شوید.