این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

مکان‌های SDK برای نسخه‌های اندروید

پلتفرم را انتخاب کنید: Android iOS JavaScript

تیم Google Maps Platform به طور منظم SDK ها را با ویژگی های جدید، رفع اشکالات و بهبود عملکرد به روز می کند. این صفحه راهنمایی در مورد نحوه مدیریت وابستگی های خود به SDK های تلفن همراه ارائه می دهد.

به کدام نسخه لینک بدهیم؟

برای برنامه‌های حیاتی ، به آخرین نسخه نقطه‌ای از نسخه اصلی که استفاده می‌کنید (X.*) پیوند دهید و سالانه به نسخه اصلی جدید ارتقا دهید.
همانطور که نسخه‌های جدید برنامه خود را در طول سال منتشر می‌کنید، ممکن است شروع به استفاده از نسخه‌های نقطه‌ای جدیدتر Places SDK برای Android کنید. این نیازی به به‌روزرسانی در برنامه شما ندارد زیرا نسخه‌های جدید نقطه‌ای با نسخه‌های قبلی سازگار هستند.
مزایا:
- اگر مشکلاتی را در Places SDK برای Android کشف کردید، طبق خط‌مشی پشتیبانی تلفن همراه، به مدت 12 ماه پس از انتشار اولیه نسخه اصلی، رفع مشکلات به روشی سازگار با عقب ارائه می‌شود. برای بهره مندی از اصلاحات، نیازی به ارتقاء فوری به نسخه SDK ناسازگار ندارید.
- زمانی که برنامه شما از قبل بر اساس آخرین نسخه ساخته شده باشد، به راحتی می توان از آخرین پیشرفت ها و ویژگی ها استفاده کرد.
- به‌روزرسانی‌های افزایشی سالانه جدیدترین نسخه اصلی SDK ممکن است به کار کمتری برای انطباق، بازنویسی و آزمایش برنامه‌تان نیاز داشته باشد تا اینکه مجبور باشید تغییرات ناسازگار با عقب را انجام دهید که در چندین نسخه اصلی ارائه شده‌اند.
برای برنامه‌های غیر مهم ، به هر نسخه ثابتی پیوند دهید. وقتی یک اخطار منسوخ برای آن نسخه ثابت دریافت می کنید، 12 ماه فرصت خواهید داشت تا کد برنامه به روز شده خود را در دسترس کاربران خود قرار دهید.
مزایا:
- کارهای تعمیر و نگهداری کمتر
- نسخه‌های جدید برنامه شما برای مدت طولانی‌تری از دستگاه‌های کاربران با سیستم‌عامل تلفن همراه قدیمی‌تر پشتیبانی می‌کنند (تا زمانی که نیاز به ارتقاء به نسخه جدید SDK داشته باشید).

صاحبان پروژه با آدرس‌های ایمیل نظارت شده، اعلان‌های فعالانه‌ای در مورد تغییراتی که بر هر یک از پروژه‌هایشان تأثیر می‌گذارد، دریافت می‌کنند. از به‌روزرسانی‌های اصلی، منسوخ شدن‌ها و سایر تغییرات مطلع باشید .

نصب و راه اندازی

در فایل build.gradle.kts یا build.gradle سطح برنامه خود، همیشه یک نسخه را به جای یک محدوده پیشوند ( + ) یا latest مشخص کنید زیرا این موارد می توانند به ساخت های غیرقابل پیش بینی و تکرار نشدنی منجر شوند. Places SDK برای Android به نسخه معنایی پایبند است و نسخه‌های اصلی جدید ممکن است شامل تغییرات قطعی باشند. حداقل سطح API پشتیبانی شده 23 است .

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

تعمیر و نگهداری و ارتقاء

Android Studio به‌طور خودکار نسخه‌های موجود جدیدتر را بررسی می‌کند و در صورت در دسترس بودن نسخه جدیدتر یک وابستگی، هشداری ارائه می‌کند. برای به حداقل رساندن بدهی فنی، در اسرع وقت به جدیدترین نسخه موجود به روز رسانی کنید. اگر در حال به‌روزرسانی به نسخه اصلی جدید هستید، یادداشت‌های انتشار را برای تغییرات ناسازگار با عقب و نحوه به‌روزرسانی کد خود بررسی کنید .

علاوه بر نظرسنجی برای نسخه‌های جدیدتر، صاحبان پروژه Google Cloud ایمیل‌هایی درباره تغییرات ناسازگار که ممکن است بر پروژه‌های آنها تأثیر بگذارد، دریافت می‌کنند. برای دریافت اعلان پیشگیرانه در مورد تغییرات ناسازگار با عقب، نقش مالک را با یک آدرس ایمیل نظارت شده برای هر یک از پروژه های خود اختصاص دهید .

اگر در حال ارتقا از Places SDK برای اندروید نسخه 3.2.0 یا قبل هستید

هنگام انتقال به SDK جدید، نیازی به مهاجرت نیست. شما فقط باید:

Places 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 استفاده کنید.