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

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

כדי להכיר את היסודות של Google Issue Tracker, אפשר לעיין במאמר Google Issue Tracker.

דיווח על באג

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

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

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

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

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

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

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

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

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

רכיבי באגים

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

אבטחה

אם מצאתם בעיה שמשפיעה על האבטחה של 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 documentation)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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