אתם יכולים לעזור לנו לשפר את Android על ידי דיווח על בעיות ובקשה לתכונות חדשות באמצעות כלי המעקב אחר בעיות ב-Google. Google Issue Tracker הוא כלי ש-Google משתמשת בו כדי לעקוב אחרי בעיות ובקשות להוספת תכונות ב-AOSP. הכלי למעקב אחר בעיות זמין גם מחוץ ל-Google, למשתמשים ציבוריים ושותפים חיצוניים שצריכים לשתף פעולה עם צוותי Google בנושא בעיות ותכונות ספציפיות.
למידע על היסודות של Google Issue Tracker, תוכלו לעיין במאמר Google Issue Tracker.
דיווח על באג
כדי לדווח על באג ב-AOSP:
- כשמחפשים את כל הבאגים הפתוחים, אפשר להשתמש בשדה החיפוש של הכלי למעקב אחר בעיות כדי לראות אם כבר מישהו דיווח על הבעיה או על התכונה. אל תשכחו לחפש גם באגים שנסגרו ותוקנו. כדי למצוא את התוצאות הפופולריות ביותר, אפשר למיין את התוצאות לפי מספר הכוכבים. למידע נוסף על השימוש בשדה החיפוש, קראו את המאמר חיפוש בעיות
- אם מצאתם את הבעיה וחשוב לכם שהיא תטופל, תוכלו לסמן אותה בכוכב. מספר הכוכבים שנותנים לבעיה עוזר ל-Google לקבוע את רמת העדיפות שלה.
אם אף אחד לא דיווח על הבעיה, יוצרים באג חדש.
יש לעיין בקטע במסמך הזה שקשור לרכיב שבו נמצאה הבאג. רכיבי הבאג מזהים את האזור ב-Android שבו הבאג רלוונטי.
- אם הבאג קשור לאבטחה, יש לעיין בקטע אבטחה.
- אם הבאג קשור ל-AOSP, יש לעיין בקטע פלטפורמה.
- אם הבאג קשור לכלים למפתחים, אפשר לעיין במאמר כלים למפתחי Android.
- אם הבאג מתייחס למסמכי תיעוד שגויים, עיינו במסמכי התיעוד.
ממלאים את התבנית שסופקה:
- אם מדובר בבאג, יש לכלול את השלבים לשחזור הבאג בתגובות. אם התגובה כוללת רק הודעה על כך שמשהו לא עובד, סביר להניח שנצטרך מידע נוסף. ככל שתספקו יותר פרטים, כולל קובצי יומן ואפילו ערכת תיקונים, כך Google תוכל לטפל בבעיה.
- אם מדובר בבקשה להוספת תכונה, יש לציין פרטים מפורטים על התכונה המוצעת, כולל הבעיה שהיא פותרת ושיקולי עיצוב.
לוחצים על יצירה. דוח הבאג נוצר כדי ש-Google תבדוק אותו.
במאמר מעקב אחר סטטוס הבאג מוסבר איך עוקבים אחרי הבאג.
רכיבי הבאג
ארבעת החלקים הבאים נועדו לעזור לכם לחפש באגים ולדווח עליהם באמצעות הרכיב הנכון.
אבטחה
אם נתקלתם בבעיה שמשפיעה על האבטחה של Android או על רכיבים במכשירי Pixel, תוכלו לדווח על באג לפי ההוראות במאמר דיווח על בעיות אבטחה. בנוסף, באגים באבטחה אפשר להשתתף בתוכנית התגמולים של מכשירי Android ו-Google.
פלטפורמה
אם יש לכם בעיה או בקשה לתכונה שמשפיעה על היבט כלשהו בפלטפורמת Android, תוכלו לדווח על הבאג בלחיצה על סמל הבאג לצד אזור הרכיב הרלוונטי:
כלים למפתחים של Android
אם יש בעיה או בקשה להוספת תכונה שמשפיעה על היבט מסוים של הכלים למפתחים של Android, אפשר לדווח על הבאג באמצעות לחיצה על סמל הבאג ליד אזור הרכיבים הרלוונטי בטבלה הבאה.
הצגת כל הבעיות שקשורות לכלים למפתחים
עיון בבאגים | פרטים | דיווח על באג |
---|---|---|
adb | bug_report | |
Android Studio | מידע ספציפי לגבי באגים ב-Android Studio | bug_report |
C++ | בעיות ב-Android Studio | bug_report |
תמונות של אמולטור או מערכת | מידע ספציפי על באגים במהדורת ה-Emulator | bug_report |
Gradle | מידע ספציפי לבאגים ב-Gradle | bug_report |
החלת השינויים | מידע ספציפי על באגים ב-Apply Changes | bug_report |
Lint | bug_report | |
NDK | בעיות במהדר של NDK או במערכת ה-build. לא לבקשות API או באגים. ממשקי API הם חלק ממערכת ההפעלה, וצריך לשלוח בקשות שקשורות אליהם לאחד מרכיבי הפלטפורמה שצוינו למעלה (אם אתם לא יודעים איזה, השתמשו ב-Framework). | bug_report |
מנהלי פרופילים | bug_report | |
Jetpack (androidx) | bug_report | |
Jetpack (androidx) Test | bug_report | |
SDK למשחקים | bug_report |
מסמכים
אם יש לכם בעיה או בקשה להוספת תכונה שמשפיעה על היבט כלשהו במסמכי העזרה של Android, תוכלו לדווח על הבאג בלחיצה על סמל הבאג לצד אזור הרכיב הרלוונטי:
עיון בבאגים | דיווח על באג |
---|---|
developer.android.com (מסמכי עזרה למפתחי אפליקציות) |
bug_report |
source.android.com (מסמכי העזרה של AOSP) |
bug_report |
בקשה ליכולת פעולה הדדית ב-DMA
אם אתם רוצים לשלוח בקשה ליכולת פעולה הדדית של DMA ל-Android, תוכלו להשתמש באזור המתאים של הרכיב:
הגשת בקשה | עיון בבקשות |
---|---|
יצירת בקשה ציבורית חדשה | בקשות ציבוריות |
יצירת בקשה פרטית חדשה |
מעקב אחר סטטוס באג
באגים שנוצרים לאחרונה תמיד מסומנים בסטטוס חדש. מנהלי AOSP בודקים באגים מדי פעם ומחלקים אותם לקטגוריות לפי רמת החשיבות שלהם, על ידי שינוי הסטטוס שלהם וייתכן גם הקצאה שלהם למישהו. הבאגים מחולקים לאחת משלוש קטגוריות:
נדרש מידע נוסף. דוח על הבאג לא מכיל מספיק מידע כדי שמישהו יוכל לתעדף את הבאג או לנתח אותו כראוי. דיווח על הבאג יועבר לרשימה (New + Hotlist:NeedsInfo) עד שתספקו את המידע המבוקש. אם לא תספקו מידע נוסף אחרי פרק זמן מסוים, הבאג יקבל סטטוס שמציין שלא ייעשה בו שימוש.
הבאג מוקצה למישהו, ואפשר גם לשנות את רמת העדיפות שלו. הדוח על הבאג זוהה כדוח מפורט כראוי של בעיה לגיטימית. הבאג מקבל עדיפות מתאימה או שהעדיפות שלו משתנה. לבסוף, הבאג מוקצה לתורם ספציפי לצורך הערכה וניתוח.
בדרך כלל, הסטטוס הוקצה נשאר לבאג עד שמישהו מתכוון לפתור אותו, ואז הסטטוס משתנה לאושר. עם זאת, יכול להיות שהאדם שהוקצה אליו הבאג לא ישנה את הסטטוס שלו ל-Accepted, אלא רק יטפל בבאג ויקצה לו את הסטטוס Fixed או Fixed (verified).
לא תתבצע פעולה על הבאג. באג משתייך לקטגוריה הזו מכמה סיבות, למשל: הבאג הוא כפילות של באג אחר, שלא ניתן לתקן את הבאג או שהבאג פועל באופן תקין.
כדי לעקוב אחרי סטטוס הבאג:
- פותחים את הבאג ומעיינים בשדות 'עדיפות', 'סטטוס' ו'תגובות'. הסברים על העדיפות והסטטוס מופיעים בקטע שדות הבעיה.
- (אופציונלי) משיבים על שאלות או תגובות בשדה התגובות.
באגים שמסומנים בסטטוס תוקנו (אומתו) ייכללו במהדורה עתידית של Android.
מידע נוסף על סטטוסים ספציפיים
בהמשך יש הסבר נוסף על כמה סטטוסים של באגים (בנוסף למידע שמופיע במסמכי התיעוד בנושא שדות הבעיה של מעקב אחר בעיות):
לא תתוקן (התנהגות מכוונת): מנהל תחזוקת AOSP קבע שההתנהגות המתוארת אינה באג, אבל זו ההתנהגות המיועד. הסטטוס הזה נקרא גם 'פועל כמצופה (WAI)'. בבקשות להוספת תכונות, מנהל AOSP קבע שהבקשה לא תיושם ב-Android.
לא יתוקן (לא ניתן לביצוע): השינויים הנדרשים כדי לטפל בבעיה לא אפשריים באופן סביר. הסטטוס הזה משמש גם לבעיות שדווחו ולא ניתן לטפל בהן ב-AOSP, בדרך כלל כי הוא קשור למכשיר מותאם אישית או לאפליקציה חיצונית, או שהדיווח זיהה בטעות את 'מעקב אחר בעיות' כפורום עזרה.
תוקן (אומת): הבאג תוקן והוא כלול בגרסה רשמית.
תוקן: הבאג תוקן (או שהתכונה הופעלה) בעץ המקור, אבל יכול להיות שהוא עדיין לא נכלל במהדורה רשמית.