نمای کلی و راه‌اندازی Android KTX

Places Android KTX مجموعه‌ای از افزونه‌های کاتلین برای Places SDK اندروید است. این افزونه‌ها ویژگی‌های زبان کاتلین را ارائه می‌دهند که به شما امکان می‌دهد هنگام توسعه برای Places SDK اندروید، کاتلین مختصر و اصطلاحی بنویسید. Places KTX متن‌باز است و به همراه مثال در GitHub موجود است.

نصب KTX برای Places SDK

برای نصب KTX برای Places SDK برای اندروید، وابستگی‌های زیر را به فایل build.gradle.kts در سطح برنامه خود اضافه کنید.

dependencies {

    // KTX for the Places SDK for Android library
    implementation("com.google.maps.android:places-ktx:3.5.0")
}

نمونه برنامه را امتحان کنید

مخزن گیت‌هاب این کتابخانه همچنین شامل یک برنامه آزمایشی است که نشان می‌دهد چگونه می‌توانید از کتابخانه Places KTX در برنامه خود استفاده کنید.

صفحه اول برنامه نمونه Places KTX، انتخاب‌های شما را نشان می‌دهد
صفحه نمایش برنامه نسخه آزمایشی جستجوی مکان‌ها

برای امتحان کردن نسخه آزمایشی برنامه، مراحل زیر را دنبال کنید:

  1. از گیت‌هاب ، فایل زیپ را کپی یا دانلود کنید.
  2. در اندروید استودیو، File -> Open را انتخاب کنید و به دایرکتوری بروید و پوشه‌ای را که اخیراً کلون یا دانلود کرده‌اید، باز کنید.
  3. یک کلید API به برنامه آزمایشی اضافه کنید.
    1. یک کلید API برای Places دریافت کنید .
    2. در دایرکتوری ریشه، فایلی به نام secrets.properties ایجاد کنید. این فایل نباید تحت کنترل نسخه باشد تا از کلید API شما محافظت کند.
    3. این خط را به secrets.properties اضافه کنید 
      PLACES_API_KEY="YOUR_API_KEY"
       که YOUR_API_KEY کلید API واقعی است که در مرحله اول به دست آورده‌اید. می‌توانید به عنوان مثال به local.defaults.properties نگاه کنید.
  4. در بخش پیکربندی اجرا، ماژول app-places-ktx را انتخاب کنید.
  5. اجرای 'app-places-ktx' را انتخاب کنید.