סקירה כללית והגדרה של Android KTX

‫Places Android KTX הוא אוסף של תוספי Kotlin ל-Places SDK ל-Android. התוספים האלה מספקים תכונות של שפת Kotlin שמאפשרות לכם לכתוב קוד Kotlin תמציתי ואידיומטי כשאתם מפתחים ל-Places SDK ל-Android. ספריית Places KTX היא ספריית קוד פתוח שזמינה ב-GitHub, יחד עם דוגמאות.

התקנת KTX ל-Places SDK

כדי להתקין את KTX ל-Places SDK ל-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 באפליקציה שלכם.

המסך הראשון של האפליקציה לדוגמה Places KTX, שבו מוצגות האפשרויות שלך
מסך האפליקציה "אפליקציית הדגמה לחיפוש מקומות"

כדי לנסות את אפליקציית ההדגמה, פועלים לפי השלבים הבאים:

  1. ב-GitHub, משכפלים או מורידים את קובץ ה-ZIP.
  2. ב-Android Studio, בוחרים באפשרות File -> Open (קובץ -> פתיחה), עוברים לספרייה ופותחים את התיקייה ששכפלתם או הורדתם.
  3. מוסיפים מפתח API לאפליקציית ההדגמה.
    1. קבלת מפתח Places API.
    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. בוחרים באפשרות Run 'app-places-ktx'‎.