Places SDK לגרסאות Android

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

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

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

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

    יתרונות:

    • אם תגלו בעיות ב-Places SDK ל-Android, התיקונים יסופקו בדרך תואמת לאחור למשך 12 חודשים לאחר הפצת הגרסה הראשית, התמיכה בנייד . לא יהיה צורך לשדרג בדחיפות לגרסת SDK לא תואמת. להפיק תועלת מהתיקונים.
    • קל ליישם את התכונות והשיפורים האחרונים כשהאפליקציה כבר מבוססת על את הגרסה העדכנית ביותר.
    • יכול להיות שעדכונים שנתיים מצטברים לגרסה הראשית החדשה של ה-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 פרויקט בעלים מקבלים הודעות אימייל על שינויים שאינם תואמים לאחור, שעשויים ישפיעו על הפרויקטים שלהם. כדי לקבל התראה יזומה על תאימות לאחור שינויים, להקצות תפקיד הבעלים עם כתובת אימייל במעקב לכל אחד מהפרויקטים שלכם.

אם אתה משדרג מ-Place 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 החדשות.