סקירה כללית והגדרה של 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 ברמת האפליקציה.

dependencies {

    // KTX for the Places SDK for Android library
    implementation 'com.google.maps.android:places-ktx:3.2.0'
}

כדאי לנסות את האפליקציה לדוגמה

במאגר של הספרייה הזו ב-GitHub יש גם אפליקציה להדגמה שמראה איך להשתמש בספריית KTX של Places באפליקציה שלכם.

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

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

  1. משכפלים או מורידים את קובץ ה-ZIP מ-GitHub.
  2. ב-Android Studio, בוחרים באפשרות 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'.