버그 신고 및 추적

Google Issue Tracker를 사용하여 문제를 신고하고 새 기능을 요청하여 Android 개선에 기여할 수 있습니다. Google Issue Tracker는 Google에서 AOSP 문제와 기능 요청을 추적하는 데 사용하는 도구입니다. Issue Tracker는 특정 문제와 기능에 관해 Google팀과 협력해야 하는 외부 일반 사용자와 파트너 사용자를 위해 Google 외부에도 제공됩니다.

Google Issue Tracker 기본사항에 관한 자세한 내용은 Google Issue Tracker를 참고하세요.

버그 신고

다음과 같이 AOSP 버그를 신고하세요.

  1. 모든 미해결 버그를 검색의 기본으로 하고 Issue Tracker의 검색창을 사용하여 문제나 기능이 이미 신고되었는지 확인합니다. 해결 및 수정된 버그도 검색하세요. 결과를 별표 수 기준으로 정렬하면 가장 인기 있는 결과를 쉽게 찾을 수 있습니다. 검색창 사용에 관한 자세한 내용은 문제 검색을 참고하세요.
  2. 중요한 문제를 찾으면 별표로 표시하세요. 문제에 있는 별표 수를 통해 Google에서 우선순위를 결정할 수 있습니다.
  3. 문제가 신고되지 않았다면 새 버그를 작성합니다.

    1. 버그 구성요소와 관련된 이 문서의 섹션을 참고합니다. 버그 구성요소는 버그가 적용되는 Android 영역을 식별합니다.

      • 버그가 보안과 관련된 경우 보안을 참고합니다.
      • 버그가 AOSP와 관련된 경우 플랫폼을 참고합니다.
      • 버그가 개발자 도구와 관련된 경우 Android 개발자 도구를 참고합니다.
      • 버그가 잘못된 문서를 참조하는 경우 문서를 참고합니다.
    2. 제공된 템플릿을 다음과 같이 작성하세요.

      • 문제가 버그이면 버그를 재현하는 단계를 댓글에 포함합니다. 문제가 있다고 단순히 언급하는 댓글에는 추가 정보가 필요할 수 있습니다. 로그 파일이나 패치 모음 등 세부정보를 많이 제공할수록 Google에서 문제를 해결하는 데 도움이 됩니다.
      • 문제가 기능 요청이면 해결된 문제와 설계 고려사항 등 제안된 기능에 관한 명시적 세부정보를 제공합니다.
    3. 만들기를 클릭합니다. 버그 신고가 만들어지면 Google에서 검토합니다.

버그 상태를 추적하는 방법을 알아보려면 버그 상태 추적을 참고하세요.

버그 구성요소

아래 네 개 섹션은 올바른 구성요소를 사용하여 버그를 검색하고 신고할 수 있도록 설계되었습니다.

보안

Pixel 기기에서 Android 또는 구성요소의 보안에 영향을 미치는 문제를 발견하면 보안 문제 신고의 안내에 따라 버그를 신고하세요. 또한 보안 버그를 제출하면 Android 및 Google 기기 리워드 프로그램에 따라 리워드를 받을 수도 있습니다.

플랫폼

Android 플랫폼 측면에 영향을 미치는 문제나 기능 요청이 있다면 다음과 같이 관련 구성요소 영역 옆에 있는 버그 아이콘을 클릭하여 버그를 신고하세요.

모든 플랫폼 문제 둘러보기

버그 검색 버그 신고
접근성
ART
브라우저
CTS
프레임워크
그래픽
커널(GKI)
미디어
인스턴트 앱
Libcore
네트워킹
시스템
일반 시스템 이미지
텍스트
사물
Wear

Android 개발자 도구

Android 개발자 도구 측면에 영향을 미치는 문제나 기능 요청이 있다면 다음 표의 관련 구성요소 영역 옆에 있는 버그 아이콘을 클릭하여 버그를 신고하세요.

모든 개발자 도구 문제 둘러보기

버그 검색 세부정보 버그 신고
adb
Android 스튜디오 Android 스튜디오 버그 관련 정보
C++ Android 스튜디오의 문제
에뮬레이터 또는 시스템 이미지 에뮬레이터 버그 관련 정보
Gradle Gradle 버그 관련 정보
변경사항 적용 변경사항 적용 버그 관련 정보
린트
NDK NDK 컴파일러 또는 빌드 시스템 문제 API 요청 또는 버그에는 적합하지 않습니다. API는 OS의 일부이며 이와 관련된 요청은 위의 플랫폼 구성요소 중 하나로 제출해야 합니다(잘 모르는 경우 프레임워크 사용).
프로파일러
Jetpack(androidx)
Jetpack(androidx) 테스트
게임즈 SDK

문서

Android 문서 측면에 영향을 미치는 문제나 기능 요청이 있다면 다음과 같이 관련 구성요소 영역 옆에 있는 버그 아이콘을 클릭하여 버그를 신고하세요.

버그 검색 버그 신고
developer.android.com(앱 개발자 문서)
source.android.com(AOSP 문서)

DMA 상호 운용성 요청

Android에 대한 DMA 상호 운용성 요청을 제출하려면 다음과 같은 관련 구성요소 영역을 사용하세요.

요청 제출 요청 탐색
새 공개 요청 만들기 공개 요청
새 비공개 요청 만들기

버그 상태 추적

새로 작성한 버그는 항상 신규 상태로 표시됩니다. AOSP 유지관리자는 상태를 변경하고 잠재적으로 누군가에게 할당하여 버그를 주기적으로 검토하고 분류합니다. 버그는 다음과 같이 세 카테고리 중 하나로 분류됩니다.

  • 추가 정보가 필요합니다. 버그 신고는 누군가가 버그의 우선순위를 지정하거나 버그를 적절히 분석하는 데 필요한 정보가 충분하지 않습니다. 버그 신고는 요청된 정보가 제공될 때까지 목록(New + Hotlist:NeedsInfo)에 배치됩니다. 일정 기간이 지난 후 추가 정보가 제공되지 않으면 버그에는 조치가 취해지지 않음을 나타내는 상태가 부여됩니다.

  • 버그가 누군가에게 할당되고 선택적으로 우선순위가 다시 지정됩니다. 버그 신고가 합법적인 문제에 관한 상세한 신고 내용을 담은 것으로 인지되었습니다. 버그의 우선순위가 적절히 지정되거나 우선순위가 다시 지정됩니다. 마지막으로 버그가 특정 기여자에게 할당되어 평가 및 분석됩니다.

    일반적으로 버그는 할당됨으로 유지되다가 누군가 버그를 해결하려고 할 때 수락됨 상태가 부여됩니다. 그러나 담당자는 버그의 상태를 수락됨으로 변경하지 않고 대신 버그를 수정하고 해결됨 또는 해결됨(확인됨) 상태를 부여할 수 있습니다.

  • 버그에 대한 조치가 취해지지 않습니다. 버그가 이 카테고리로 분류되는 이유는 여러 가지입니다. 버그가 다른 버그와 중복되거나 버그를 수정할 수 없거나 버그가 제대로 작동하는 기능을 나타내는 경우를 예로 들 수 있습니다.

다음과 같이 버그 상태를 추적합니다.

  1. 버그를 열고 우선순위, 상태, 댓글 필드를 살펴봅니다. 우선순위와 상태에 관한 설명은 문제 필드를 참고하세요.
  2. (선택사항) 댓글 필드에서 질문이나 댓글에 응답합니다.

해결됨(확인됨) 상태로 표시된 버그는 향후 Android 출시에 포함됩니다.

특정 상태 추가 정보

다음은 버그 상태에 관한 추가 설명입니다(Issue Tracker 문제 필드 문서에 제공된 정보에 추가).

  • 해결하지 않음(의도된 동작): AOSP 운영자가 설명된 동작은 버그가 아니라 의도된 동작이라고 판단했습니다. 이 상태는 흔히 '의도대로 작동(WAI)'이라고도 합니다. 기능 요청의 경우 AOSP 운영자가 요청이 Android에서 구현되지 않을 것이라고 판단했습니다.

  • 해결하지 않음(실행 불가): 문제를 해결하는 데 필요한 변경사항이 합리적으로 불가능합니다. 이 상태는 AOSP에서 처리할 수 없는 신고된 문제에도 사용됩니다. 일반적인 이유는 맞춤설정된 기기 또는 외부 앱과 관련이 있거나 신고자가 Issue Tracker를 도움말 포럼으로 착각했기 때문입니다.

  • 해결됨(확인됨): 이 버그가 해결되었으며 정식 버전에 포함되었습니다.

  • 해결됨: 이 버그가 소스 트리에서 해결되었거나 기능이 구현되었지만 아직 정식 버전에는 포함되지 않았을 가능성이 있습니다.