Places SDK לגרסאות Android

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

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

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

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

    הטבות:

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

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

    הטבות:

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

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

התקנה

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

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:4.3.1")
}

תחזוקה ושדרוג

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

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

אם אתם משדרגים מגרסה 3.2.0 או מגרסה קודמת של Places SDK ל-Android

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

  1. מפעילים את Places API (חדש) במפתח ה-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.