אתם יכולים לעזור לנו לשפר את 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 | |
Games 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, בדרך כלל כי הן קשורות למכשיר מותאם אישית או לאפליקציה חיצונית, או שהמדווח טעה לחשוב שמערכת המעקב אחר בעיות היא פורום עזרה.
תוקן (אומת): הבאג תוקן והוא כלול בגרסה רשמית.
תוקן: הבאג תוקן (או שהתכונה הופעלה) בעץ המקור, אבל יכול להיות שהוא עדיין לא נכלל במהדורה רשמית.