تیم 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 را ببینید.
برنامه‌های موجودتان بدون تغییر به کار خود ادامه می‌دهند، اما اکنون می‌توانید از همه ویژگی‌های جدید کیت توسعه نرم‌افزار بهره‌مند شوید.