תכונות חדשות בתצוגה המקדימה של Android Studio

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

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

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

גרסאות עדכניות של Android Studio

בטבלה הבאה מפורטות הגרסאות הנוכחיות של Android Studio והערוצים המתאימים להן.

תאימות לתצוגות מקדימות של פלאגין Android Gradle

כל גרסת Preview של Android Studio מתפרסמת לצד גרסה תואמת של הפלאגין Android Gradle (AGP). גרסאות טרום-השקה של Studio אמורות לפעול עם כל גרסה יציבה של AGP שהיא תואמת. עם זאת, אם אתם משתמשים בגרסת Preview של AGP, אתם חייבים להשתמש בגרסת ה-Preview התואמת של Studio (לדוגמה, Android Studio Chipmunk Canary 7 עם AGP 7.2.0-alpha07). ניסיונות להשתמש בגרסאות שונות (לדוגמה, Android Studio Chipmunk Beta 1 עם AGP 7.2.0-alpha07) יגרמו לכשל בסנכרון, וכתוצאה מכך תוצג בקשה לעדכון לגרסה התואמת של AGP.

יומן מפורט של הוצאות משימוש והסרות של ממשקי API של הפלאגין של Android Gradle זמין במאמר עדכונים של ממשקי API של הפלאגין של Android Gradle.

Studio Labs

ב-Studio Labs אפשר לנסות את התכונות הניסיוניות האחרונות של AI בגרסה יציבה של Android Studio, כדי לשלב מהר יותר את כלי העזר שלנו מבוססי-AI בתהליך הפיתוח. מידע נוסף זמין במאמר בנושא Studio Labs.

אלה התכונות שזמינות כרגע ב-Studio Labs.

השקת תכונות חדשות של Android Studio Narwhal 3‏ | 2025.1.3

הרשימה הבאה כוללת תכונות חדשות ב-Android Studio Narwhal 3 Feature Drop | 2025.1.3.

כדי לראות מה תוקן בגרסה הזו של Android Studio, אפשר לעיין בבעיות שנסגרו.

תצוגות מקדימות של Compose שאפשר לשנות את הגודל שלהן

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

כדי להשתמש בתכונה, צריך להיכנס למצב מיקוד בתצוגה המקדימה של הטיוטה. לשם כך, משנים את אפשרות התצוגה בסרגל הכלים:

עכשיו אפשר לשנות את הגודל של חלון התצוגה המקדימה על ידי גרירת הקצוות שלו:

אפשר גם להשתמש בסרגל הכלים לשינוי הגודל, שמוצג אחרי שמשנים את הגודל של התצוגה המקדימה:

אם רוצים לשמור את הגודל החדש כPreview הערה חדשה, משתמשים בתפריט הלחיצה הימנית:

התכונה של שינוי גודל דינמי עוזרת לכם ליצור ממשקי משתמש שנראים מצוין בכל גודל מסך.

הגדרת תצוגה ב-Android להצגת קובצי build מתחת למודולים המתאימים

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

הצגת תובנות לגבי מדיניות ב-Android Studio

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

החל מ-Android Studio Narwhal 3 Feature Drop, אפשר לראות את התובנות לגבי מדיניות Play כבדיקות lint. בדיקות ה-lint האלה יציגו את המידע הבא:

• סקירה כללית של המדיניות.
• המלצות שיעזרו לכם להימנע מטעויות נפוצות.
• קישורים לדפי המדיניות של Play, שבהם אפשר למצוא את המדיניות המלאה והרשמית ומידע ומשאבים נוספים שיכולים לעזור.

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

כדי לראות אם יש תובנות לגבי מדיניות Play בפרויקט שלכם, עוברים אל Code > Inspect for Play Policy Insights…‎ התובנות יופיעו בחלון הכלים Problems וגם כאזהרות Lint בקבצים המתאימים.

בדיקה ופיתוח באמצעות גיבוי ושחזור של אפליקציות

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

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

יצירת גיבוי

כדי ליצור קובץ גיבוי:

1. פריסת גרסת ניפוי באגים של האפליקציה במכשיר מחובר
2. כדי ליצור גיבוי, מבצעים אחת מהפעולות הבאות:
   • בחלון Running Device, לוחצים על הפעולה Backup App Data בסרגל הכלים.
   • בסרגל התפריטים הראשי, בוחרים באפשרות הפעלה > גיבוי נתוני אפליקציה.
   • בכרטיסייה Device Explorer > Processes, לוחצים לחיצה ימנית על תהליך האפליקציה ובוחרים באפשרות Backup App Data.
3. בתיבת הדו-שיח שמופיעה, מבצעים את הפעולות הבאות:
   • מאשרים את מזהה האפליקציה שרוצים ליצור לה גיבוי
     • בוחרים אם רוצים ליצור גיבוי ממכשיר למכשיר, בענן או בענן (לא מוצפן)
   • מאשרים את השם והמיקום של הגיבוי שרוצים לשמור. כברירת מחדל, הגיבוי נשמר בספריית השורש של פרויקט Android Studio הנוכחי.

     

4. לוחצים על אישור כש-Android Studio שואל אם הוא יכול לעצור את האפליקציה. כדי ליצור את הגיבוי, Android Studio צריך לעצור את תהליך האפליקציה.

אפשר לראות את הגיבויים שיוצרים בחלון הכלים Project > Android בקטע Backup Files.

סוגי גיבוי

אפשר ליצור סוגים שונים של גיבוי לאפליקציה. כשיוצרים גיבוי, צריך לבחור את סוג הגיבוי שמתאים לתרחיש שרוצים לבדוק:

• ממכשיר למכשיר: יוצר גיבוי של האפליקציה, בדומה לגיבוי שנוצר במהלך העברה ממכשיר למכשיר. בהעברה ממכשיר למכשיר, נתוני הגיבוי של האפליקציה נשלחים ישירות למכשיר אחר, למשל באמצעות USB או Wi-Fi.
• Cloud: יצירת גיבוי של האפליקציה, בדומה לגיבוי שנשמר בנפח האחסון בחשבון Google של המשתמש. כשמשתמש מגדיר מכשיר חדש, הוא יכול לבחור לשחזר מגיבוי בענן.
• ענן (לא מוצפן): נוצר גיבוי של האפליקציה, בדומה לגיבוי שנשמר באחסון בחשבון Google של המשתמש במכשיר שבו ההצפנה בצד הלקוח לא מופעלת.

הערה: כשמשתמשים בתכונה כדי לבדוק גיבוי לענן, גיבוי לענן (לא מוצפן) או גיבוי ממכשיר למכשיר, הגיבוי שנוצר לא נשלח לענן או למכשיר אחר, בניגוד לתהליך גיבוי בפועל. הוא יוצר גיבוי של האפליקציה כאילו הוא עומד להישמר בענן או להישלח למכשיר אחר. הגיבויים שנוצרו לכל סוג גיבוי יכולים להיות בקטע Backup Files בחלון כלי Project > Android.

שחזור נתוני אפליקציות

כדי לשחזר נתונים של אפליקציה:

1. פורסים את האפליקציה במכשיר המחובר. לאפליקציה צריך להיות אותו מזהה אפליקציה כמו לקובץ הגיבוי שרוצים לשחזר במכשיר.
2. עוברים לאחת מהפעולות הבאות ולוחצים עליה:
   • בחלון Running Device, לוחצים על הפעולה Restore App Data בסרגל הכלים, ובוחרים קובץ גיבוי מההיסטוריה האחרונה או לוחצים על Browse.
   • בסרגל התפריטים הראשי, עוברים אל הפעלה > שחזור נתוני אפליקציה.
   • בכרטיסייה Device Explorer > Processes (סייר המכשירים > תהליכים), לוחצים לחיצה ימנית על תהליך האפליקציה ובוחרים באפשרות Restore App Data (שחזור נתוני האפליקציה).
   • בחלון הכלים Project > Android, לוחצים לחיצה ימנית על גיבוי בקטע Backup Files ובוחרים באפשרות Restore App Data.
3. אם רלוונטי, בוחרים גיבוי מההיסטוריה האחרונה או לוחצים על עיון כדי לבחור קובץ גיבוי לשחזור מהאחסון המקומי.

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

1. בסרגל התפריטים הראשי, עוברים אל Run > Edit Configurations (הפעלה > עריכת הגדרות).
2. בוחרים הגדרת הרצה של אפליקציה ועוברים אל אפשרויות שחזור.

   

3. כדי לשחזר אפליקציה מגיבוי, מסמנים את התיבה לצד שחזור מצב האפליקציה.
4. בוחרים קובץ גיבוי מההיסטוריה האחרונה או מעיינים בגיבוי ובוחרים אותו מהאחסון המקומי.
5. אם רוצים לשחזר רק את נתוני האפליקציה בהתקנה חדשה של האפליקציה, מסמנים את התיבה שלצד שחזור רק בהתקנת APK חדשה. האפשרות הזו יכולה להיות שימושית אם אתם פורסים למכשיר בדיקה חדש ורוצים לשחזר נתונים כדי לעזור בניפוי באגים ובפיתוח אפליקציות.
6. לוחצים על OK כדי לשמור את הגדרת ההרצה.
7. מפעילים את האפליקציה באמצעות הגדרת ההפעלה כדי לבדוק את השחזור של נתוני האפליקציה במכשיר מחובר.

בדיקות Proguard

‫Android Studio כולל עכשיו בדיקות שנועדו למנוע כללי Proguard שנוצרו בצורה לא טובה, או כללים שמונעים אופטימיזציות של R8. כללי שמירה רחבים מדי כמו -keep class **.* והגדרות כללי Proguard לצרכנים כמו dontshrink ו--dontoptimize מפעילים עכשיו אזהרה בסביבת הפיתוח המשולבת (IDE) של Studio. כדי ליצור כלל שמירה טוב שמאפשר לכווץ את הקוד, צריך להגדיר את הכלל לחבילה ספציפית ולציין במפורש מה רוצים לשמור.

קבצי AGENT.md להקשר ברמת הפרויקט

עכשיו אפשר לכלול בפרויקט עד AGENT.md קבצים. אלה קובצי Markdown שמספקים ל-Gemini הוראות ספציפיות לפרויקט, כללים לסגנון כתיבת קוד והנחיות אחרות כהקשר.

‫Gemini מזהה ומחיל באופן אוטומטי הוראות מכל קובץ בשם AGENT.md בפרויקט. אם קובץ AGENT.md לא קיים, Gemini יחפש במקומו קובץ GEMINI.md כברירת מחדל.

הגדרה חדשה להשבתת הסנכרון האוטומטי

ב-Android Studio יש עכשיו הגדרה למעבר ממצב ברירת המחדל של סנכרון אוטומטי (לדוגמה, הסנכרון מופעל אוטומטית כשפותחים פרויקט) למצב חדש של סנכרון ידני עם תזכורות. התנהגות ברירת המחדל היא עדיין סנכרון אוטומטי. כדי לעבור לסנכרון ידני, עוברים אל File (Android Studio ב-macOS) > Settings > Build, Execution, Deployment > Build Tools ומגדירים את Project Sync mode לManual Sync with reminders.

תכונות שעוברות מ-Studio Labs

התכונות הניסיוניות הבאות מ-Studio Labs יציבות החל מ-Narwhal 3 Feature Drop:

• צירוף תמונות ב-Gemini
• @הקשר של קובץ ב-Gemini

השקת תכונות חדשות של Android Studio Narwhal 4‏ | 2025.1.4

הרשימה הבאה כוללת תכונות חדשות ב-Android Studio Narwhal 4 Feature Drop | 2025.1.4.

כדי לראות מה תוקן בגרסה הזו של Android Studio, אפשר לעיין בבעיות שנסגרו.

‫Journeys for Android Studio

Journeys for Android Studio מאפשרת לכם לכתוב ולתחזק בקלות בדיקות מקצה לקצה. אתם יכולים להשתמש בשפה טבעית כדי לתאר את השלבים והטענות של כל בדיקה – שנקראת 'מסלול'. השלבים שכתובים בשפה טבעית מומרים לפעולות ש-Gemini מבצע באפליקציה, כך שקל לכתוב את התרחישים ולהבין אותם. התהליך הזה מתאפשר בזכות יכולות הראייה וההסקה של Gemini. בנוסף, אתם יכולים לכתוב ולתאר טענות מורכבות יותר, ש-Gemini מעריך על סמך מה שהוא רואה במכשיר כדי לקבוע אם מסלולי ההמרות שלכם עומדים בדרישות או לא.

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

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

גיבוי וסנכרון

מעכשיו אפשר לגבות את ההגדרות של Android Studio לאחסון בענן באמצעות חשבון Google או חשבון JetBrains. כך תוכלו לסנכרן את ההגדרות, כמו מיפוי מקלדת, הגדרות של עורך קוד, הגדרות מערכת ועוד. כדי להתחיל, מבצעים אחת מהפעולות הבאות:

• אחרי שפותחים פרויקט ב-Android Studio, נכנסים לחשבון Google בלחיצה על האווטאר בפינה השמאלית העליונה של סביבת הפיתוח המשולבת (IDE) ואז על כניסה.

  

  1. פועלים לפי ההנחיות בתיבת הדו-שיח שמופיעה ומקפידים לסמן את התיבה כדי לאשר ל-Android Studio לגשת לאחסון בחשבון Google.
  2. פועלים לפי ההנחיות כדי לתת הרשאה ל-Android Studio.

• עוברים אל הגדרות > גיבוי וסנכרון.

  1. בוחרים באפשרות Google כדי להשתמש בנפח האחסון בחשבון Google לסנכרון נתוני האפליקציה בין התקנות של Android Studio. אפשרות אחרת היא להשתמש בחשבון JetBrains כדי לסנכרן את נתוני האפליקציה בין התקנות של IntelliJ ו-Android Studio.
  2. אחרי שמבצעים את ההנחיות כדי לתת ל-Android Studio הרשאת גישה לאחסון של החשבון המועדף, חוזרים ל-Android Studio.
  3. בדף הגדרות > גיבוי וסנכרון, אפשר לבדוק את הקטגוריות של נתוני האפליקציות שרוצים לסנכרן עם החשבון.
  4. כדי להשבית את 'גיבוי וסנכרון', מבטלים את הסימון בתיבה שמפעילה את התכונה.

אם כבר יש לכם נתונים שמסונכרנים עם המכשיר שבחרתם, Android Studio נותן לכם את האפשרות להוריד הגדרות מהאחסון המרוחק (זו אפשרות ברירת המחדל) או להעלות את ההגדרות המקומיות שלכם ולהחליף את ההגדרות שמסונכרנות עם האחסון המרוחק.

הצעות לתיקון קריסות

במסגרת ההשקה של Android Studio Meerkat, השקנו את התכונה 'תובנות מ-Gemini לגבי קריסות' שזמינה בחלון של הכלי App Quality Insights. מעכשיו, Android Studio יכול להשתמש ב-Gemini כדי לנתח את נתוני הקריסה יחד עם קוד המקור שלכם, ולהציע תיקונים פוטנציאליים. אחרי שבוחרים קריסה בחלון של הכלי App Quality Insights, עוברים לכרטיסייה Insights ולוחצים על Suggest a fix אחרי ש-Gemini יוצר תובנה לגבי הקריסה. ‫Gemini יוצר הצעות לשינויים בקוד, ואתם יכולים לבדוק אותן ולאשר אותן בכרטיסיית השוואה בעורך.

הגדרה חדשה לפתיחת פרויקטים חדשים בתצוגת הפרויקט

יש הגדרה חדשה שמאפשרת לפתוח פרויקטים חדשים בתצוגת הפרויקט כברירת מחדל. כדי להפעיל את ההגדרה, עוברים אל File (Android Studio ב-macOS) > Settings > Advanced Settings > Project View ובוחרים באפשרות Set Project view as the default.

כלי לבדיקת צילומי מסך של תצוגה מקדימה של יצירה

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

שיפור עץ הרכיבים של הכלי לבדיקת פריסות מוטמעות

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

1. גלילה אופקית: עכשיו אפשר לגלול אופקית בתוך עץ הרכיבים, וכך קל יותר לנווט בפריסות רחבות או בפריסות עם רכיבים מוטמעים ברמות עומק שונות ולבדוק אותן בלי לאבד את ההקשר.
2. גלילה אוטומטית בבחירה: מעכשיו, כשבוחרים פריט בעץ הרכיבים, התצוגה נגללת אוטומטית גם אופקית וגם אנכית, כדי שהפריט שנבחר יהיה במרכז. כך תמיד תוכלו לראות את הרכיב שמעניין אתכם.
3. שיפור הוויזואליזציה של הקשרים: שיפרנו את קווי התמיכה בעץ הרכיבים כדי לספק רמזים חזותיים ברורים יותר להבנת הקשרים בין הצמתים. עכשיו קל יותר לעקוב אחרי קשרים תוכנתיים כי קווי נקודות מציינים בבירור את הקשר בין צומת אב לצומת צאצא במחסנית הקריאות. הקווים הרציפים ממשיכים לייצג את כל שאר הקשרים הרגילים של הורה-צאצא בעץ.

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

שימוש במודל LLM מקומי

ב-Android Studio Narwhal 4 Feature Drop אפשר לבחור את מודל ה-LLM שמפעיל את תכונות ה-AI של ה-IDE.

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

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

כדי לתמוך במודלים מקומיים של שפה גדולה (LLM), צריך להתקין במחשב המקומי ספק LLM כמו LM Studio או Ollama, יחד עם מודל תואם לבחירתכם.

הכלי לשדרוג Android SDK תומך עכשיו ב-Android 16 / API 36

הוספנו את המעבר מ-Android 15 / API 35 ל-Android 16 / API 36 לכלי לשדרוג Android SDK. כדי לקבל עזרה בהעברה, עוברים אל כלים > הכלי לשדרוג Android SDK.

פלאגין Android Gradle 9.0

פלאגין Android Gradle‏ 9.0 הוא גרסה ראשית חדשה של AGP, והוא כולל שינויים בממשקי ה-API ובהתנהגות.

כדי לעדכן לגרסה Android Gradle plugin 9.0.0-alpha02, משתמשים בעוזר השדרוג של Android Gradle plugin ב-Android Studio Narwhal 4 Feature Drop | 2025.1.4.

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

תאימות

רמת ה-API המקסימלית של Android שנתמכת על ידי Android Gradle plugin 9.0.0-alpha02 היא רמת API‏ 36.

‫Android Gradle plugin 9.0.0-alpha02 requires Gradle 9.0.0.

שינויים בהתנהגות

לפלאגין Android Gradle 9.0 יש התנהגויות חדשות:

‫AGP 9.0 כולל עדכונים בערכי ברירת המחדל של מאפייני Gradle הבאים. כך תוכלו לבחור אם לשמור על ההתנהגות של AGP 8.13 כשאתם משדרגים:

android {
  buildFeatures {
    shaders = true
  }
}

תכונות שהוסרו

בפלאגין Android Gradle 9.0, הפונקציונליות הבאה הוסרה:

• התמיכה בהטמעת אפליקציות ל-Wear OS
  ב-AGP 9.0 הוסרה התמיכה בהטמעת אפליקציות ל-Wear OS, שלא נתמכת יותר ב-Play. זה כולל הסרה של ההגדרות של wearApp ושל ה-DSL של AndroidSourceSet.wearAppConfigurationName. במאמר הפצה ב-Wear OS מוסבר איך לפרסם את האפליקציה ב-Wear OS.

שינוי ב-DSL

בפלאגין Android ל-Gradle בגרסה 9.0 יש את שינויי ה-DSL הבאים שעלולים לגרום לכשלים:

• הוסר הפרמטר של CommonExtension. השינוי הזה הוא שינוי שובר תאימות ברמת המקור בלבד, שמטרתו למנוע שינויים שוברי תאימות ברמת המקור בעתיד. אבל המשמעות שלו היא גם שצריך להעביר את השיטות של בלוק ה-DSL מ-CommonExtension אל ApplicationExtension,‏ LibraryExension,‏ DynamicFeatureExtension ו-TestExtension.

הוסר DSL

הפלאגין Android Gradle 9.0 מסיר את:

• AndroidSourceSet.jni, כי הוא לא פעל.

• ‫AndroidSourceSet.wearAppConfigurationName, כי הוא קשור להסרת התמיכה באפליקציית Wear OS המוטמעת.

• BuildType.isRenderscriptDebuggable, כי הוא לא פעל.

• ‫ComponentBuilder.enabled. הוא הוחלף ב-ComponentBuilder.enable.

• ‫Installation.installOptions(String). הוא מוחלף במאפיין הניתן לשינוי של Installation.installOptions.

• ‫VariantBuilder.targetSdk ו-targetSdkPreview, כי הן לא היו משמעותיות בספריות. במקום זאת, אתם צריכים להשתמש ב-GeneratesApkBuilder.targetSdk או ב-GeneratesApkBuilder.targetSdkPreview.

• הבלוק PostProcessing, שהוא ניסיוני אבל אף פעם לא יציב.

• ‫ProductFlavor.setDimension, שמוחלף במאפיין dimension

• ‫Variant.unitTest, כי הוא לא רלוונטי לפלאגין com.android.test. המאפיין unitTest זמין בסוגי המשנה VariantBuilder של HasUnitTest.

• ‫VariantBuilder.enableUnitTest, כי הוא לא רלוונטי לפלאגין com.android.test. המאפיין enableUnitTest זמין בסוגי המשנה VariantBuilder של HasUnitTestBuilder.

• הסוג VariantBuilder.unitTestEnabled הוסר לטובת הסוג enableUnitTest, ששמו עקבי יותר, בסוגי המשנה VariantBuilder שמרחיבים את HasUnitTestBuilder.

הוסרו מאפייני Gradle

המאפיינים הבאים של Gradle נוספו בהתחלה כדרכים להשבית באופן גלובלי תכונות שהופעלו כברירת מחדל.

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

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

ממשקי API שהוסרו

הפלאגין Android Gradle 9.0 מסיר את:

• ממשקי ה-API שהוצאו משימוש והושבתו, BaseExtension.registerTransformשנותרו רק כדי לאפשר קומפילציה מול הגרסה האחרונה של AGP תוך מיקוד להפעלה ב-AGP 4.2 או בגרסאות קודמות.

מאפייני Gradle שנאכפים

אם מגדירים את מאפייני Gradle הבאים, AGP 9.0 יציג שגיאה.

הכלי Android Gradle plugin Upgrade Assistant לא ישדרג פרויקטים ל-AGP 9.0 שמשתמשים במאפיינים האלה.