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:5.1.1")
}

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

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

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

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

לא נדרשת העברה כשעוברים ל-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 זמין במאמר Usage of the latest kotlin-stdlib version in transitive dependencies.

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

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