Places SDK לגרסאות Android

בחירת פלטפורמה: Android iOS JavaScript

הצוות של הפלטפורמה של מפות Google מעדכן באופן קבוע ערכות SDK עם תכונות חדשות, תיקוני באגים שיפורים בביצועים. בדף הזה מפורטות הנחיות לניהול יחסי התלות שלכם ב-SDK לנייד.

  • לאפליקציות שחיוניות למשימה, צריך לקשר לגרסת הנקודות האחרונה של שבה אתם משתמשים (X.*), ומשדרגים כל שנה לגרסה הראשית החדשה.

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

    יתרונות:

    • אם תגלו בעיות ב-Places SDK ל-Android, התיקונים יסופקו בדרך תואמת לאחור למשך 12 חודשים לאחר הפצת הגרסה הראשית, התמיכה בנייד . לא יהיה צורך לשדרג בדחיפות לגרסת SDK לא תואמת. להפיק תועלת מהתיקונים.
    • קל ליישם את התכונות והשיפורים האחרונים כשהאפליקציה כבר מבוססת על את הגרסה העדכנית ביותר.
    • עדכונים מצטברים שנתיים לגרסה הראשית העדכנית ביותר של ה-SDK עשויים לדרוש פחות עבודה כדי להתאים, לכתוב מחדש ולבדוק את האפליקציה, מאשר טיפול בשינויים שלא תואמים לגרסאות קודמות שנוספו במספר גרסאות ראשיות.

  • באפליקציות שאינן קריטיות, יש לקשר לכל גרסה מתוקנת. כשאנחנו מקבלים הוצאה משימוש הודעה על הגרסה המתוקנת הזו, יעמדו לרשותכם 12 חודשים כדי להפוך את קוד האפליקציה המעודכן לזמין עבור המשתמשים שלך.

    יתרונות:

    • עבודות תחזוקה בתדירות נמוכה יותר.
    • גרסאות חדשות של האפליקציה שלך ממשיכות לתמוך במשתמשים מכשירים עם מכשירים ניידים ישנים יותר למשך זמן ארוך יותר (עד שתצטרכו לשדרג לגרסת SDK חדשה).

בעלי פרויקט עם כתובות אימייל במעקב מקבלים התראות יזומות על שינויים משפיעים על כל אחד מהפרויקטים שלהם. אני רוצה להישאר קבלת מידע על עדכונים משמעותיים, הוצאת משימוש ושינויים אחרים.

התקנה

בקובץ build.gradle.kts או build.gradle ברמת האפליקציה, תמיד צריך לציין גרסה במקום טווח של קידומת (+) או latest, כי אלה יכולים להוביל לגרסאות build בלתי צפויות ולא ניתנות לחזור עליהן. 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 ל-Android בגרסה 3.2.0 ואילך

אין צורך בהעברה כשעוברים ל-SDK החדש. צריך רק:

  1. מפעילים את האפשרות Places API (New) במפתח ה-API שמשמש את האפליקציה. למידע נוסף, תוכלו לקרוא את המאמר שימוש במפתחות API.

  2. בקטע 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 ביחסי תלות מעבריים.

  3. מעדכנים את האפליקציה הקיימת כך שתפעיל את השיטה החדשה Places.initializeWithNewPlacesApiEnabled() כדי לאתחל את האפליקציה. למידע נוסף, ראו איך מאתחלים את לקוח Places API.

האפליקציות הקיימות ימשיכו לפעול ללא שינוי, אבל עכשיו תוכלו ליהנות מכל התכונות החדשות של ה-SDK.