Places SDK לגרסאות Android

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

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

לאיזו גרסה לקשר?

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

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

  יתרונות:

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

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

  יתרונות:

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

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

התקנה

בקובץ build.gradle ברמת האפליקציה, צריך תמיד לציין גרסה במקום טווח תחילית (+) או latest, כי יכולות להיות גרסאות build בלתי צפויות ובלתי חוזרות. Places SDK ל-Android פועל בהתאם לניהול גרסאות סמנטי, וגרסאות גדולות חדשות עשויות לכלול שינויי תוכנה שעלולים לגרום לכשלים. רמת ה-API המינימלית הנתמכת היא 21.

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.3.0'
     }

   מידע נוסף על התלות kotlin-bom זמין במאמר שימוש בגרסה העדכנית ביותר של kotlin-stdlib ביחסי תלות טרנזיטיביים.

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

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