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