تیم پلتفرم نقشههای گوگل مرتباً SDKها را با ویژگیهای جدید، رفع اشکالات و بهبود عملکرد بهروزرسانی میکند. این صفحه راهنماییهایی در مورد نحوه مدیریت وابستگیهای شما به SDKهای موبایل ارائه میدهد.
Which version to link to?
برای برنامههای حیاتی ، به آخرین نسخهٔ منتشر شده از نسخهٔ اصلی که استفاده میکنید (X.*) لینک دهید و سالانه آن را به نسخهٔ اصلی جدید ارتقا دهید.
همزمان با انتشار نسخههای جدید برنامهتان در طول سال، میتوانید از نسخههای جدیدتر Places SDK برای اندروید استفاده کنید. این کار نیازی به بهروزرسانی برنامهتان نخواهد داشت زیرا نسخههای جدید dot با نسخههای قبلی سازگار هستند.
Benefits:
- اگر در Places SDK برای اندروید مشکلی پیدا کنید، طبق سیاست پشتیبانی موبایل ، اصلاحات به مدت ۱۲ ماه پس از انتشار اولیه نسخه اصلی، به صورت سازگار با نسخههای قبلی ارائه خواهد شد. برای بهرهمندی از اصلاحات، نیازی به ارتقاء فوری به نسخه SDK ناسازگار نخواهید داشت.
- وقتی برنامه شما از قبل بر اساس آخرین نسخه ساخته شده باشد، جدیدترین پیشرفتها و ویژگیها به راحتی قابل استفاده هستند.
- بهروزرسانیهای تدریجی سالانه برای جدیدترین نسخه اصلی SDK ممکن است به کار کمتری برای تطبیق، بازنویسی و آزمایش برنامه شما نیاز داشته باشد، در مقایسه با اینکه مجبور باشید تغییرات ناسازگار با نسخههای قبلی را که در چندین نسخه اصلی منتشر شدهاند، مدیریت کنید.
برای برنامههای غیرحیاتی ، به هر نسخه اصلاحشدهای لینک دهید. وقتی اخطار منسوخ شدن آن نسخه اصلاحشده را دریافت کردید، ۱۲ ماه فرصت خواهید داشت تا کد بهروزرسانیشده برنامه خود را در دسترس کاربرانتان قرار دهید.
Benefits:
- Less frequent maintenance work.
- نسخههای جدید برنامه شما، دستگاههای کاربرانی که سیستم عاملهای قدیمیتر موبایل را اجرا میکنند، برای مدت طولانیتری پشتیبانی میکنند (تا زمانی که نیاز به ارتقاء به نسخه جدید SDK داشته باشید).
صاحبان پروژه با آدرسهای ایمیل تحت نظارت، اعلانهای پیشگیرانهای در مورد تغییراتی که بر هر یک از پروژههایشان تأثیر میگذارد، دریافت میکنند. از بهروزرسانیهای عمده، منسوخشدهها و سایر تغییرات مطلع باشید .
نصب
در فایل build.gradle.kts یا build.gradle سطح برنامه خود، همیشه به جای محدوده پیشوند ( + ) یا latest ، یک نسخه (version) مشخص کنید، زیرا این موارد میتوانند منجر به ساختهای غیرقابل پیشبینی و تکرارناپذیر شوند. Places SDK برای اندروید به نسخهبندی معنایی پایبند است و نسخههای اصلی جدید ممکن است شامل تغییرات جزئی (breaking changes) باشند. حداقل سطح API پشتیبانی شده 24 است .
dependencies { // Places and Maps SDKs implementation("com.google.android.libraries.places:places:5.1.1") }
Maintenance and upgrade
اندروید استودیو بهطور خودکار نسخههای جدیدتر موجود را بررسی میکند و در صورت وجود نسخه جدیدتر از یک وابستگی، هشدار میدهد. برای به حداقل رساندن بدهی فنی، در اسرع وقت به جدیدترین نسخه موجود بهروزرسانی کنید. اگر در حال بهروزرسانی به یک نسخه اصلی جدید هستید، یادداشتهای انتشار را برای تغییرات ناسازگار با نسخههای قبلی و نحوه بهروزرسانی کد خود بررسی کنید .
علاوه بر نظرسنجی برای نسخههای جدیدتر، صاحبان پروژههای Google Cloud ایمیلهایی در مورد تغییرات ناسازگار با نسخههای قبلی که ممکن است بر پروژههایشان تأثیر بگذارد، دریافت میکنند. برای دریافت اعلانهای پیشگیرانه در مورد تغییرات ناسازگار با نسخههای قبلی، برای هر یک از پروژههای خود، یک آدرس ایمیل تحت نظارت به نقش مالک اختصاص دهید .
اگر از Places SDK برای اندروید نسخه ۳.۲.۰ یا قدیمیتر استفاده میکنید، آن را ارتقا دهید.
هنگام انتقال به SDK جدید نیازی به مهاجرت نیست. فقط باید:
- API مکانها (جدید) را روی کلید API مورد استفاده در برنامه خود فعال کنید. برای اطلاعات بیشتر، به استفاده از کلیدهای API مراجعه کنید.
در بخش
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()برای مقداردهی اولیهی برنامه فراخوانی شود. برای اطلاعات بیشتر، به Initialize the Places API client مراجعه کنید.
برنامههای موجود شما بدون تغییر به کار خود ادامه میدهند، اما اکنون میتوانید از تمام ویژگیهای جدید SDK بهرهمند شوید.