گزارش و پیگیری اشکالات

می‌توانید با گزارش مشکلات و درخواست ویژگی‌های جدید با استفاده از Google Issue Tracker به بهبود Android کمک کنید. Google Issue Tracker ابزاری است که توسط Google برای ردیابی مشکلات AOSP و درخواست های ویژگی استفاده می شود. ردیاب مشکل در خارج از Google برای استفاده توسط کاربران عمومی و شریک خارجی که نیاز به همکاری با تیم های Google در مورد مسائل و ویژگی های خاص دارند، در دسترس است.

برای یادگیری اصول اولیه Google Issue Tracker، به Google Issue Tracker مراجعه کنید.

گزارش یک اشکال

برای گزارش یک اشکال AOSP:

1. با وجود همه اشکالات باز به عنوان مبنای جستجوی خود، از قسمت جستجوی Issue Tracker استفاده کنید تا ببینید آیا کسی قبلاً مشکل یا ویژگی شما را گزارش کرده است یا خیر. فراموش نکنید که باگ های بسته و رفع شده را نیز جستجو کنید. برای کمک به یافتن محبوب ترین نتایج، نتیجه را بر اساس تعداد ستاره ها مرتب کنید. برای جزئیات بیشتر در مورد استفاده از فیلد جستجو، به جستجوهای مشکل مراجعه کنید
2. اگر مشکل خود را پیدا کردید و برایتان مهم است، آن را ستاره دار کنید ! تعداد ستاره‌های یک موضوع به Google کمک می‌کند اولویت آن را تعیین کند.

3. اگر کسی مشکل شما را گزارش نکرده است، یک اشکال جدید ایجاد کنید.

   1. به بخشی از این سند که مربوط به مؤلفه مربوط به اشکال شما است، مراجعه کنید. مؤلفه‌های اشکال، ناحیه‌ای از Android را که باگ برای آن اعمال می‌شود، مشخص می‌کند.

      • اگر اشکال مربوط به امنیت است، به امنیت مراجعه کنید.
      • اگر اشکال مربوط به AOSP است، به پلتفرم مراجعه کنید.
      • اگر اشکال مربوط به ابزارهای توسعه دهنده است، به ابزار توسعه دهنده اندروید مراجعه کنید.
      • اگر اشکال به مستندات نادرست اشاره دارد، به مستندات مراجعه کنید.

   2. الگوی ارائه شده را پر کنید:

      • اگر مشکل یک اشکال است، مراحل بازتولید باگ را در نظرات ذکر کنید. نظری که فقط بیان می کند چیزی کار نمی کند احتمالاً به اطلاعات بیشتری نیاز دارد. میزان جزئیاتی که ارائه می‌دهید، از جمله فایل‌های گزارش و حتی یک مجموعه وصله، به Google کمک می‌کند مشکل شما را برطرف کند.
      • اگر مشکل یک درخواست ویژگی است، جزئیات صریح در مورد ویژگی پیشنهادی، از جمله مشکل حل شده و ملاحظات طراحی ارائه دهید.

   3. روی ایجاد کلیک کنید. گزارش اشکال برای Google ایجاد شده است تا بررسی شود.

برای یادگیری نحوه ردیابی وضعیت اشکال، به ردیابی وضعیت اشکال مراجعه کنید.

اجزای اشکال

چهار بخش زیر برای کمک به جستجو و گزارش اشکالات با استفاده از مؤلفه صحیح طراحی شده است.

امنیت

اگر مشکلی پیدا کردید که بر امنیت Android یا اجزای دستگاه‌های Pixel تأثیر می‌گذارد، با استفاده از دستورالعمل‌های گزارش مشکلات امنیتی، اشکالی را ثبت کنید. علاوه بر این، اشکالات امنیتی برای برنامه پاداش دستگاه‌های Android و Google واجد شرایط هستند.

پلت فرم

اگر مشکل یا درخواست ویژگی دارید که بر جنبه‌ای از پلتفرم اندروید تأثیر می‌گذارد، با کلیک کردن روی نماد اشکال در کنار ناحیه مؤلفه مربوطه، اشکال خود را ثبت کنید:

همه مشکلات پلتفرم را مرور کنید

مرور اشکالات	یک اشکال را ثبت کنید
دسترسی	bug_report
هنر	bug_report
مرورگر	bug_report
سی تی اس	bug_report
چارچوب	bug_report
گرافیک	bug_report
هسته (GKI)	bug_report
16 کیلوبایت	bug_report
رسانه ها	bug_report
برنامه های فوری	bug_report
Libcore	bug_report
شبکه سازی	bug_report
سیستم	bug_report
تصویر سیستم عمومی	bug_report
متن	bug_report
چیزها	bug_report
بپوشید	bug_report

ابزارهای توسعه دهنده اندروید

اگر مشکل یا درخواست ویژگی دارید که بر جنبه‌ای از ابزارهای توسعه‌دهنده اندروید تأثیر می‌گذارد، با کلیک کردن روی نماد اشکال در کنار ناحیه مؤلفه مربوطه در جدول زیر، باگ خود را تشکیل دهید.

همه مسائل مربوط به ابزارهای برنامه‌نویس را مرور کنید

مرور اشکالات	جزئیات	یک اشکال را ثبت کنید
adb		bug_report
اندروید استودیو	اطلاعات مختص باگ‌های Android Studio	bug_report
C++	مشکلات اندروید استودیو	bug_report
شبیه ساز یا تصاویر سیستم	اطلاعات خاص برای اشکالات شبیه ساز	bug_report
گریدل	اطلاعات ویژه برای اشکالات Gradle	bug_report
اعمال تغییرات	اطلاعات ویژه برای اشکالات اعمال تغییرات	bug_report
لینت		bug_report
NDK	مشکلات سیستم کامپایلر یا ساختن NDK. نه برای درخواست های API یا اشکالات. API ها بخشی از سیستم عامل هستند و درخواست های مربوط به آنها باید در یکی از مؤلفه های پلتفرم بالا ثبت شوند (اگر نمی دانید کدام، از Framework استفاده کنید).	bug_report
پروفایلرها		bug_report
جت پک (اندرویدکس)		bug_report
تست جت پک (اندرویدکس).		bug_report
بازی SDK		bug_report

مستندات

اگر مشکل یا درخواست ویژگی دارید که بر جنبه‌ای از مستندات Android تأثیر می‌گذارد، با کلیک کردن روی نماد اشکال در کنار ناحیه مؤلفه مربوطه، اشکال خود را ثبت کنید:

مرور اشکالات	یک اشکال را ثبت کنید
developer.android.com (اسناد توسعه دهنده برنامه)	bug_report
source.android.com (اسناد AOSP)	bug_report

درخواست همکاری DMA

اگر می‌خواهید یک درخواست همکاری DMA برای Android ارسال کنید، از قسمت مؤلفه مربوطه استفاده کنید:

درخواست را ثبت کنید	درخواست ها را مرور کنید
یک درخواست عمومی جدید ایجاد کنید	درخواست های عمومی
یک درخواست خصوصی جدید ایجاد کنید

پیگیری وضعیت اشکال

اشکالات جدید ایجاد شده همیشه با وضعیت جدید مشخص می شوند. نگهدارنده‌های AOSP به‌طور دوره‌ای باگ‌ها را با تغییر وضعیت آن‌ها و تخصیص احتمالی آن‌ها به شخصی بررسی و تریاژ می‌کنند. اشکالات به یکی از سه دسته تقسیم می شوند:

• به اطلاعات بیشتری نیاز دارد. گزارش اشکال اطلاعات کافی برای اولویت بندی یا تجزیه و تحلیل صحیح اشکال را ندارد. گزارش اشکال در یک لیست ( جدید + Hotlist:NeedsInfo ) قرار می گیرد تا زمانی که اطلاعات درخواستی را ارائه دهید. پس از مدتی، اگر اطلاعات اضافی ارائه نشود، به اشکال وضعیتی داده می‌شود که نشان می‌دهد بر اساس آن عمل نمی‌شود.

• اشکال به شخصی اختصاص داده می شود و به صورت اختیاری، اولویت بندی مجدد می شود. گزارش اشکال به عنوان گزارشی با جزئیات کافی از یک مشکل قانونی شناخته شده است. اشکال به درستی اولویت بندی شده است یا مجددا اولویت بندی شده است. در نهایت، اشکال به یک مشارکت کننده خاص برای ارزیابی و تجزیه و تحلیل اختصاص داده می شود.

  به طور معمول، یک باگ به‌عنوان اختصاص داده شده باقی می‌ماند تا زمانی که شخصی قصد رفع اشکال را داشته باشد، در این مرحله وضعیت Accepted به آن اختصاص داده می‌شود. با این حال، یک گیرنده ممکن است وضعیت یک اشکال را به Accepted تغییر ندهد و به جای آن، فقط باگ را برطرف کرده و یک وضعیت ثابت یا ثابت (تأیید شده) اختصاص دهد.

• بر اساس اشکال عمل نمی شود. یک باگ به دلایل متعددی در این دسته قرار می‌گیرد، مثلاً باگ تکراری از یک باگ دیگر است، رفع اشکال غیرممکن است، یا باگ عملکردی را نشان می‌دهد که طبق خواسته کار می‌کند.

برای پیگیری وضعیت اشکال:

1. اشکال را باز کنید و به قسمت های اولویت، وضعیت و نظرات نگاه کنید. برای توضیحات اولویت و وضعیت، به فیلدهای Issue مراجعه کنید.
2. (اختیاری) به هر سوال یا نظری در قسمت نظرات پاسخ دهید.

اشکالات مشخص شده با وضعیت ثابت (تأیید شده) در نسخه آینده اندروید گنجانده شده است.

اطلاعات اضافی برای وضعیت های خاص

در زیر توضیح بیشتری برای چند وضعیت اشکال ارائه شده است (علاوه بر اطلاعات ارائه شده در مستندات فیلدهای Issue Tracker Issue):

• رفع نمی شود (رفتار مورد نظر): یک نگهدارنده AOSP تشخیص داده است که رفتار توصیف شده یک اشکال نیست، بلکه رفتار مورد نظر است. این وضعیت معمولاً به عنوان "کار به عنوان هدف (WAI)" نیز شناخته می شود. برای درخواست های ویژگی، یک نگهدارنده AOSP تشخیص داده است که این درخواست در اندروید اجرا نمی شود.

• رفع نمی شود (غیرقابل اجرا): تغییراتی که برای رسیدگی به مشکل مورد نیاز است به طور منطقی امکان پذیر نیست. این وضعیت همچنین برای مشکلات گزارش شده استفاده می‌شود که در AOSP قابل رسیدگی نیستند، معمولاً به این دلیل که مربوط به یک دستگاه سفارشی‌شده یا یک برنامه خارجی است، یا گزارش‌گر ردیاب مشکل را به‌عنوان یک انجمن راهنمایی اشتباه گرفته است.

• رفع شده (تأیید شده): این اشکال برطرف شده است و در نسخه رسمی گنجانده شده است.

• رفع شد: این اشکال در یک درخت منبع برطرف شده است (یا قابلیت پیاده سازی شده است)، اما ممکن است هنوز در نسخه رسمی گنجانده نشده باشد.