דיווח על באגים ומעקב אחריהם

אתם יכולים לעזור לנו לשפר את Android על ידי דיווח על בעיות ובקשה להוספת תכונות חדשות באמצעות הכלי של Google למעקב אחר בעיות. הכלי למעקב אחרי בעיות של Google משמש את Google למעקב אחרי בעיות ובקשות להוספת תכונות ב-AOSP. הכלי למעקב אחר בעיות זמין מחוץ ל-Google לשימוש של משתמשים חיצוניים מהציבור ושותפים שצריכים לשתף פעולה עם צוותי Google בנוגע לבעיות ולתכונות ספציפיות.

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

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

דיווח על באג

כדי לדווח על באג ב-AOSP:

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

3. אם אף אחד לא דיווח על הבעיה שלכם, צריך ליצור באג חדש.

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

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

   2. ממלאים את התבנית שמופיעה:

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

   3. לוחצים על יצירה. הדוח על הבאג נוצר כדי ש-Google תבדוק אותו.

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

כאן מוסבר איך לעקוב אחרי סטטוס הבאג.

רכיבי באגים

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

אבטחה

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

פלטפורמה

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

עיון בכל הבעיות בפלטפורמה

עיון בבאגים	דיווח על באג
נגישות
ART
דפדפן
CTS
Framework
גרפיקה
Kernel (GKI)
‫16kB
מדיה
אפליקציות ללא התקנה
Libcore
Networking
מערכת
Generic System Image
טקסט
דברים
Wear

כלים למפתחים של Android

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

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

עיון בכל הבעיות בכלי למפתחים

עיון בבאגים	פרטים	דיווח על באג
‫adb
‫Android Studio	מידע ספציפי על באגים ב-Android Studio
C++‎	בעיות ב-Android Studio
אמולטור או תמונות מערכת	מידע ספציפי על באגים באמולטור
Gradle	מידע ספציפי על באגים ב-Gradle
החלת השינויים	מידע ספציפי על באגים ב'החלת שינויים'
Lint
NDK	בעיות במערכת הבנייה או בקומפיילר של NDK. לא לשימוש בבקשות API או בבאגים. ממשקי API הם חלק ממערכת ההפעלה, ובקשות שקשורות אליהם צריך לשלוח באחד מרכיבי הפלטפורמה הקודמים (אם אתם לא יודעים איזה, השתמשו ב-Framework).
כלי פרופילים
‫Jetpack (androidx)
Jetpack (androidx) Test
Games SDK

מסמכים

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

עיון בבאגים	דיווח על באג
developer.android.com (מסמכי מפתחי אפליקציות)
‫source.android.com (תיעוד של AOSP)

בקשה ליכולת פעולה הדדית בהתאם ל-DMA

אם אתם רוצים לשלוח בקשת תאימות ל-DMA עבור Android, אתם צריכים להשתמש באזור הרכיב הרלוונטי:

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

בקשה לפיד תוכן בהתאם לחוק ה-DMA ב-Pixel

באזור הכלכלי האירופי (EEA),‏ Pixel מציג מסכי בחירה של מנוע חיפוש באינטרנט (OSE) בהתאם ל-DMA, שמאפשרים למשתמשים לבחור את מנוע החיפוש המועדף עליהם. אם משתמש בוחר ספק מסוים במסך הבחירה של OSE, הספק יכול לבחור להציג את פיד התוכן שלו במסך Pixel שמוצג כשמשתמשים מחליקים ימינה ממסך הבית של Pixel.

אם אתם ספקי תוכן שמשתתפים במסך הבחירה של מערכת ההפעלה בהתאם ל-DMA במדינה חברה כלשהי, ומעוניינים להציג את התוכן שלכם במסך -1 ב-Pixel, אתם יכולים לשלוח לנו דוח באג כדי ליצור איתנו קשר:

יצירת בקשה פרטית חדשה

מעקב אחרי סטטוס הבאג

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

• נדרש מידע נוסף. בדוח על הבאג אין מספיק מידע כדי שמישהו יוכל לתת לבאג עדיפות או לנתח אותו כמו שצריך. דוח הבאגים מתווסף לרשימה (New + Hotlist:NeedsInfo) עד שתספקו את המידע הנדרש. אחרי תקופה מסוימת, אם לא יסופק מידע נוסף, הבאג יקבל סטטוס שמציין שלא יבוצעו פעולות לגביו.

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

  בדרך כלל, באג נשאר בסטטוס Assigned עד שמישהו מתכוון לפתור אותו. בשלב הזה הסטטוס שלו משתנה ל-Accepted. עם זאת, יכול להיות שהאדם שהוקצתה לו הבעיה לא ישנה את הסטטוס שלה לAccepted, אלא פשוט יתקן אותה ויקצה לה סטטוס Fixed או Fixed (verified).

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

הערה: התהליך הזה מייצג תהליך טיפוסי לטיפול בבאגים ב-AOSP. המעבר של הבאג בין סטטוסים שונים עשוי להשתנות מעט.

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

כדי לעקוב אחרי סטטוס הבאג:

1. פותחים את הבאג ומסתכלים על השדות 'עדיפות', 'סטטוס' ו'תגובות'. הסברים על העדיפות והסטטוס מופיעים בקטע שדות הבעיה.
2. (אופציונלי) משיבים על שאלות או הערות בשדה ההערות.

באגים שמסומנים בסטטוס Fixed (verified) נכללים בגרסה עתידית של Android.

מידע נוסף על סטטוסים ספציפיים

בהמשך מופיע הסבר נוסף על כמה סטטוסים של באגים (בנוסף למידע שמופיע במסמכי התיעוד של שדות הבעיה בכלי למעקב אחר בעיות):

• לא יתוקן (התנהגות מכוונת): מנהל תחזוקה של AOSP קבע שההתנהגות המתוארת היא לא באג, אלא התנהגות מכוונת. הסטטוס הזה נקרא גם 'פועל כמצופה' (WAI). במקרה של בקשות לתכונות, מנהל תחזוקה של AOSP קבע שהבקשה לא תיושם ב-Android.

• לא יתוקן (לא מעשי): השינויים שנדרשים כדי לפתור את הבעיה לא אפשריים באופן סביר. הסטטוס הזה משמש גם לבעיות שדווחו שלא ניתן לטפל בהן ב-AOSP, בדרך כלל כי הן קשורות למכשיר מותאם אישית או לאפליקציה חיצונית, או כי המדווח טעה וחשב ש-Issue Tracker הוא פורום עזרה.

• תוקן (אומת): הבאג הזה תוקן והוא כלול בגרסה רשמית.

• תוקן: הבאג הזה תוקן (או שהתכונה הוטמעה) בעץ מקור, אבל יכול להיות שהוא עדיין לא נכלל בגרסה רשמית.