הצוות של Google Maps Platform מעדכן באופן קבוע את ערכות ה-SDK עם תכונות חדשות, תיקוני באגים ושיפורים בביצועים. בדף הזה מוסבר איך לנהל את יחסי התלות בערכות SDK לנייד.
לאיזו גרסה לקשר?
-
באפליקציות קריטיות, קשרו לגרסה המשנית האחרונה של הגרסה הראשית שבה אתם משתמשים (X.*), ושדרגו מדי שנה לגרסה הראשית החדשה.
כשמפרסמים גרסאות חדשות של האפליקציה במהלך השנה, אפשר להתחיל להשתמש בגרסאות חדשות יותר של ה-SDK של מפות ל-Android. לא תצטרכו לעדכן את האפליקציה כי גרסאות משנה חדשות תואמות לדורות קודמים.
יתרונות:
- אם תגלו בעיות ב-SDK של מפות ל-Android, תקבלו תיקונים שתואמים לדורות קודמים במשך 12 חודשים אחרי ההשקה הראשונית של הגרסה הראשית, בהתאם למדיניות התמיכה בניידים. לא תצטרכו לשדרג בדחיפות לגרסת SDK לא תואמת כדי ליהנות מהתיקונים.
- קל יותר להטמיע את השיפורים והתכונות החדשים כשהאפליקציה כבר מבוססת על הגרסה העדכנית.
- עדכונים מצטברים שנתיים לגרסה הראשית החדשה ביותר של ה-SDK עשויים לדרוש פחות עבודה כדי להתאים, לשכתב ולבדוק את האפליקציה, בהשוואה לטיפול בשינויים שאינם תואמים לדורות קודמים שהוצגו בכמה גרסאות ראשיות.
באפליקציות לא קריטיות, אפשר לקשר לכל גרסה מתוקנת. כשתקבלו הודעה על הוצאה משימוש של הגרסה המתוקנת, יהיו לכם 12 חודשים להפוך את קוד האפליקציה המעודכן לזמין למשתמשים.
יתרונות:
- עבודות תחזוקה בתדירות נמוכה יותר.
- גרסאות חדשות של האפליקציה ממשיכות לתמוך במכשירים של משתמשים עם מערכות הפעלה ישנות יותר לנייד למשך זמן רב יותר (עד שצריך לשדרג לגרסת SDK חדשה).
בעלי פרויקטים עם כתובות אימייל במעקב מקבלים התראות יזומות על שינויים שמשפיעים על כל אחד מהפרויקטים שלהם. להתעדכן לגבי עדכונים חשובים, הוצאה משימוש ושינויים אחרים.
התקנה
בקובץ build.gradle.kts או build.gradle ברמת האפליקציה, תמיד צריך לציין גרסה במקום טווח קידומת (+) או latest, כי הם יכולים להוביל ל-builds בלתי צפויים ובלתי ניתנים לשחזור. SDK של מפות ל-Android פועל לפי ניהול גרסאות סמנטי, וגרסאות ראשיות חדשות עשויות לכלול שינוי תוכנה שעלול לגרום לכשל. רמת ה-API המינימלית שנתמכת היא 23.
מציינים את התלות של מפות Google ב-Google Play Services באמצעות תחביר Gradle:
dependencies { // Maps SDK for Android implementation(libs.play.services.maps) }
הנחיות נוספות לניהול גרסאות של Google Play Services
תחזוקה ושדרוג
Android Studio בודק באופן אוטומטי אם יש גרסאות חדשות יותר, ומציג אזהרה כשיש גרסה חדשה יותר של יחסי תלות. כדי לצמצם את החוב הטכני, כדאי לעדכן לגרסה הזמינה החדשה ביותר בהקדם האפשרי. אם אתם מעדכנים לגרסה ראשית חדשה, בדקו את הערות הגרסה כדי לראות אם יש שינויים שלא תואמים לדורות קודמים, ואיך לעדכן את הקוד.
בנוסף לבדיקת גרסאות חדשות, בעלי פרויקטים ב-Google Cloud מקבלים אימיילים על שינויים שאינם תואמים לאחור, שעשויים להשפיע על הפרויקטים שלהם. כדי לקבל התראות יזומות על שינויים שגורמים לחוסר תאימות לדורות קודמים, הקצו את תפקיד הבעלים עם כתובת אימייל במעקב לכל אחד מהפרויקטים שלכם.