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

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

نصب KTX برای «کیت توسعه نرم‌افزار مکان‌ها»

برای نصب KTX برای «کیت توسعه نرم‌افزار مکان‌ها ویژه Android»، وابستگی‌های زیر را به فایل build.gradle.kts سطح برنامه اضافه کنید.

dependencies {

    // Modern Android projects use version catalogs to manage dependencies. To include the Places SDK for Android,
    // first add the following to your gradle/libs.versions.toml file:
    //
    // [versions]
    // places = "5.3.0"
    //
    // [libraries]
    // places = { group = "com.google.android.libraries.places", name = "places", version.ref = "places" }
    //
    // Places SDK for Android (Kotlin extensions and coroutines are built directly into the Places SDK)
    implementation(libs.places)

    // If your project does not use a version catalog, you can use the following dependency instead:
    //
    //    implementation("com.google.android.libraries.places:places:5.3.0")
}

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

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

برای امتحان کردن برنامه نمایشی، این مراحل را دنبال کنید:

1. از GitHub، فایل ZIP را شبیه‌سازی یا بارگیری کنید.
2. در «استودیو Android»، فایل -> باز کردن را انتخاب کنید و به دایرکتوری بروید و پوشه‌ای را که به‌تازگی شبیه‌سازی یا بارگیری کرده‌اید باز کنید.
3. کلید میانای برنامه‌سازی کاربردی را به برنامه نمایشی اضافه کنید.
1. کلید Places API دریافت کنید.
2. در دایرکتوری ریشه، فایلی با نام secrets.properties ایجاد کنید. این فایل نباید تحت کنترل نسخه باشد تا از کلید میانای برنامه‌سازی کاربردی شما محافظت شود.
3. افزودن این تک‌خط به secrets.properties
   

   PLACES_API_KEY="YOUR_API_KEY"

   که YOUR_API_KEY کلید میانای API واقعی است که در مرحله اول دریافت کردید. می‌توانید به local.defaults.properties به‌عنوان نمونه نگاه کنید.
4. در پیکربندی اجرا، واحد app-places-ktx را انتخاب کنید.
5. اجرای «app-places-ktx» را انتخاب کنید.