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

می‌توانید با گزارش مشکلات و درخواست ویژگی‌های جدید با استفاده از 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. الگوی ارائه شده را پر کنید:

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

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

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

اجزای اشکال

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

امنیت

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

سکو

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

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

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

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

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

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

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

مستندات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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