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

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

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

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

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

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

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

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

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

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

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

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

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

توجه: هنگام گزارش یک باگ جدید AOSP، مطمئن شوید که مؤلفه تحت ردیاب عمومی Android قرار دارد.

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

اجزای اشکال

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

امنیت

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

پلت فرم

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

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

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

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

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

توجه: از آنجایی که ابزارها نیازمندی های متفاوتی دارند، جزئیات بایگانی باگ عمومی و جزئیات مرتبط ابزار را بخوانید.

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

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

مستندات

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

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

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

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

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

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

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

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

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

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

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

توجه: این فرآیند یک فرآیند معمولی برای اشکالات AOSP را نشان می دهد. پیشرفت اشکال شما در وضعیت‌های مختلف ممکن است کمی متفاوت باشد.

توجه: اندروید حاوی نرم افزارهای زیادی است و به همین نسبت تعداد زیادی باگ دریافت می کند. در نتیجه، گاهی اوقات اشکالات به صورت رسمی از تمام وضعیت ها عبور نمی کنند. گوگل سعی می‌کند سیستم را به‌روز نگه دارد، اما اغلب این کار را با استفاده از بررسی‌های دوره‌ای باگ انجام می‌دهد، جایی که پایگاه داده را بررسی می‌کند و به‌روزرسانی می‌کند. همچنین، گوگل نمی‌تواند تکمیل رفع اشکال را به موقع برای هر نسخه خاصی تضمین کند.

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

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

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

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

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

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

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

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

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