شما میتوانید با گزارش مشکلات و درخواست ویژگیهای جدید با استفاده از ردیاب مشکلات گوگل (Google Issue Tracker) به بهبود اندروید کمک کنید. ردیاب مشکلات گوگل ابزاری است که توسط گوگل برای ردیابی مشکلات AOSP و درخواستهای ویژگی استفاده میشود. ردیاب مشکلات در خارج از گوگل برای استفاده کاربران عمومی و شرکای خارجی که نیاز به همکاری با تیمهای گوگل در مورد مشکلات و ویژگیهای خاص دارند، در دسترس است.
برای آشنایی با اصول اولیهی ردیاب مشکلات گوگل، به ردیاب مشکلات گوگل مراجعه کنید.
گزارش اشکال
برای گزارش یک اشکال AOSP:
- با در نظر گرفتن تمام اشکالات باز به عنوان مبنای جستجوی خود، از فیلد جستجوی ردیاب مشکلات استفاده کنید تا ببینید آیا کسی قبلاً مشکل یا ویژگی شما را گزارش کرده است یا خیر. فراموش نکنید که اشکالات بسته و رفع شده را نیز جستجو کنید. برای کمک به یافتن محبوبترین نتایج، نتایج را بر اساس تعداد ستارهها مرتب کنید. برای جزئیات بیشتر در مورد استفاده از فیلد جستجو، به «جستجوهای مشکلات» مراجعه کنید.
- اگر مشکل خود را پیدا کردید و برایتان مهم است، آن را ستارهدار کنید ! تعداد ستارههای یک مشکل به گوگل کمک میکند تا اولویت آن را تعیین کند.
اگر کسی مشکل شما را گزارش نکرده است، یک باگ جدید ایجاد کنید.
به بخشی از این سند که مربوط به کامپوننت مربوط به باگ شماست، مراجعه کنید. کامپوننتهای باگ، ناحیهای از اندروید را که باگ در آن رخ میدهد، مشخص میکنند.
- اگر اشکال مربوط به امنیت است، به بخش امنیت مراجعه کنید.
- اگر اشکال مربوط به AOSP است، به Platform مراجعه کنید.
- اگر اشکال مربوط به ابزارهای توسعهدهنده است، به ابزارهای توسعهدهنده اندروید مراجعه کنید.
- اگر اشکال به مستندات نادرست اشاره دارد، به مستندات مراجعه کنید.
الگوی ارائه شده را پر کنید:
- اگر مشکل یک باگ است، مراحل ایجاد مجدد باگ را در نظرات ذکر کنید. نظری که فقط بیان میکند چیزی کار نمیکند، احتمالاً به اطلاعات بیشتری نیاز دارد. میزان جزئیاتی که ارائه میدهید، از جمله فایلهای گزارش و حتی یک مجموعه وصله، به گوگل کمک میکند تا مشکل شما را برطرف کند.
- اگر مشکل، درخواست ویژگی جدید است، جزئیات صریحی در مورد ویژگی پیشنهادی، از جمله مشکل حل شده و ملاحظات طراحی، ارائه دهید.
روی «ایجاد» کلیک کنید. گزارش اشکال برای بررسی توسط گوگل ایجاد میشود.
برای آشنایی با نحوه پیگیری وضعیت اشکال، به «پیگیری وضعیت اشکال» مراجعه کنید.
اجزای اشکال
چهار بخش زیر برای کمک به شما در جستجو و گزارش اشکالات با استفاده از مؤلفه صحیح طراحی شدهاند.
امنیت
اگر مشکلی پیدا کردید که بر امنیت اندروید یا اجزای دستگاههای پیکسل تأثیر میگذارد، با استفاده از دستورالعملهای موجود در بخش «گزارش مشکلات امنیتی» ، یک اشکال (باگ) ثبت کنید. علاوه بر این، اشکالات امنیتی واجد شرایط برنامه پاداش دستگاههای اندروید و گوگل هستند.
پلتفرم
اگر مشکل یا درخواست ویژگی خاصی دارید که بر جنبهای از پلتفرم اندروید تأثیر میگذارد، با کلیک روی نماد اشکال در کنار قسمت مربوط به مؤلفه، اشکال خود را ثبت کنید:
ابزارهای توسعهدهندگان اندروید
اگر مشکل یا درخواست ویژگی خاصی دارید که بر جنبهای از ابزارهای توسعهدهندگان اندروید تأثیر میگذارد، با کلیک روی نماد اشکال در کنار قسمت مربوط به مؤلفه در جدول زیر، اشکال خود را ثبت کنید.
مرور همه مشکلات ابزارهای توسعهدهندگان
| مرور اشکالات | جزئیات | ثبت اشکال |
|---|---|---|
| adb | bug_report | |
| اندروید استودیو | اطلاعات ویژه برای اشکالات اندروید استودیو | bug_report |
| سی++ | مشکلات در اندروید استودیو | bug_report |
| ایمیجهای شبیهساز یا سیستم | اطلاعات ویژه برای اشکالات شبیهساز | bug_report |
| گرادل | اطلاعات ویژه برای اشکالات Gradle | bug_report |
| اعمال تغییرات | اطلاعات خاص برای اشکالات اعمال تغییرات | bug_report |
| پرز | bug_report | |
| ان دی کی | مشکلات کامپایلر NDK یا سیستم ساخت. برای درخواستها یا اشکالات API نیست. APIها بخشی از سیستم عامل هستند و درخواستهای مربوط به آنها باید در یکی از اجزای قبلی پلتفرم (اگر نمیدانید کدام است، از چارچوب استفاده کنید) ثبت شوند. | bug_report |
| پروفیلسازها | bug_report | |
| جتپک (اندروید) | bug_report | |
| تست جتپک (اندروید) | bug_report | |
| کیت توسعه نرمافزاری بازیها | bug_report | |
مستندات
اگر مشکل یا درخواست ویژگی خاصی دارید که بر جنبهای از مستندات اندروید تأثیر میگذارد، با کلیک روی نماد اشکال در کنار قسمت مربوط به مؤلفه، اشکال خود را ثبت کنید:
| مرور اشکالات | ثبت اشکال |
|---|---|
developer.android.com (مستندات توسعهدهنده برنامه) | bug_report |
source.android.com (مستندات AOSP) | bug_report |
درخواست قابلیت همکاری DMA
اگر میخواهید درخواست DMA Interoperability برای اندروید ارسال کنید، از قسمت کامپوننت مربوطه استفاده کنید:
| ثبت درخواست | مرور درخواستها |
|---|---|
| ایجاد درخواست عمومی جدید | درخواستهای عمومی |
| ایجاد یک درخواست خصوصی جدید |
درخواست فید محتوای DMA در Pixel
در منطقه اقتصادی اروپا (EEA)، پیکسل صفحات انتخاب موتور جستجوی آنلاین DMA (OSE) را نمایش میدهد که به کاربران اجازه میدهد OSE مورد نظر خود را انتخاب کنند. اگر کاربری ارائهدهنده خاصی را در صفحه انتخاب OSE انتخاب کند، آن ارائهدهنده میتواند انتخاب کند که فید محتوای آن در صفحه پیکسل نمایش داده شود، صفحهای که هنگام کشیدن انگشت کاربران از صفحه اصلی پیکسل به سمت راست نمایش داده میشود.
اگر شما ارائهدهندهای هستید که در صفحه انتخاب DMA OSE در هر کشور عضو شرکت میکنید و علاقهمند به نمایش محتوای خود در صفحه -1 پیکسل هستید، لطفاً برای تماس با ما، یک اشکال (bug) ثبت کنید:
پیگیری وضعیت اشکال
اشکالات تازه ایجاد شده همیشه با وضعیت « جدید» مشخص میشوند. نگهدارندگان AOSP به صورت دورهای اشکالات را بررسی و با تغییر وضعیت آنها و احتمالاً اختصاص دادن آنها به شخصی دیگر، آنها را اولویتبندی میکنند. اشکالات در یکی از سه دسته زیر اولویتبندی میشوند:
به اطلاعات بیشتری نیاز دارد. گزارش اشکال اطلاعات کافی برای اولویتبندی یا تجزیه و تحلیل صحیح اشکال را ندارد. گزارش اشکال تا زمانی که اطلاعات درخواستی را ارائه ندهید، در لیست ( جدید + لیست داغ:نیاز به اطلاعات ) قرار میگیرد. پس از مدتی، اگر اطلاعات اضافی ارائه نشود، به اشکال وضعیتی داده میشود که نشان میدهد اقدامی روی آن انجام نخواهد شد.
اشکال به کسی اختصاص داده میشود و به صورت اختیاری، اولویتبندی مجدد میشود. گزارش اشکال به عنوان گزارشی با جزئیات کافی از یک مشکل قانونی شناخته شده است. اشکال به درستی اولویتبندی شده یا اولویتبندی مجدد میشود. در نهایت، اشکال برای ارزیابی و تجزیه و تحلیل به یک مشارکتکننده خاص اختصاص داده میشود.
معمولاً یک اشکال تا زمانی که کسی قصد حل آن را نداشته باشد، در وضعیت « واگذار شده» باقی میماند، و در این مرحله به آن وضعیت «پذیرفته شده» اختصاص داده میشود. با این حال، ممکن است یک واگذارکننده، وضعیت یک اشکال را به «پذیرفته شده» تغییر ندهد و در عوض، فقط اشکال را برطرف کند و وضعیت «ثابت » یا «ثابت (تأیید شده)» را به آن اختصاص دهد.
به این اشکال رسیدگی نخواهد شد. یک اشکال به دلایل مختلفی در این دسته قرار میگیرد، مثلاً ممکن است تکراری از یک اشکال دیگر باشد، رفع آن غیرممکن باشد، یا ممکن است نشاندهندهی عملکردی باشد که طبق انتظار کار میکند.
برای پیگیری وضعیت اشکال:
- اشکال را باز کنید و به فیلدهای اولویت، وضعیت و نظرات نگاه کنید. برای توضیحات مربوط به اولویت و وضعیت، به فیلدهای مشکل مراجعه کنید.
- (اختیاری) به هرگونه سوال یا نظری در قسمت نظرات پاسخ دهید.
اشکالاتی که با وضعیت ثابت (تأیید شده) مشخص شدهاند، در نسخههای آینده اندروید گنجانده خواهند شد.
اطلاعات تکمیلی برای وضعیتهای خاص
در ادامه توضیحات بیشتری برای چند وضعیت اشکال (علاوه بر اطلاعات ارائه شده در مستندات فیلدهای مشکل ردیاب مشکل) آمده است:
رفع نخواهد شد (رفتار مورد نظر): یک نگهدارنده AOSP تشخیص داده است که رفتار توصیف شده یک اشکال نیست، بلکه رفتار مورد نظر است. این وضعیت معمولاً به عنوان "کار کردن طبق برنامه (WAI)" نیز شناخته میشود. برای درخواستهای ویژگی، یک نگهدارنده AOSP تشخیص داده است که درخواست قرار نیست در اندروید پیادهسازی شود.
رفع نخواهد شد (غیرعملی): تغییراتی که برای رسیدگی به مشکل لازم است، از نظر منطقی امکانپذیر نیستند. این وضعیت همچنین برای مشکلاتی گزارش میشود که در AOSP قابل مدیریت نیستند، معمولاً به این دلیل که مربوط به یک دستگاه سفارشی یا یک برنامه خارجی است، یا گزارشگر، ردیاب مشکلات را با یک انجمن راهنما اشتباه گرفته است.
رفع شده (تأیید شده): این اشکال برطرف شده و در نسخه رسمی گنجانده شده است.
رفع شد: این اشکال در یک درخت منبع برطرف شده است (یا ویژگیای به آن اضافه شده است)، اما ممکن است هنوز در یک نسخه رسمی گنجانده نشده باشد.