피드백 보내기 및 버그 보고하기

개발자 피드백은 더 나은 Apple 환경을 만드는 데 매우 중요합니다. iPhone, iPad, Mac, 웹에서 피드백 지원을 사용할 수 있으므로, 발생하는 문제를 손쉽게 보고하고 API, 도구 및 서비스에 대한 개선 사항을 요청할 수 있습니다.

나란히 배치되어 각각 피드백 지원의 다른 화면을 보여 주는 MacBook Pro, iPad 및 iPhone

    시작하기

    개발자 커뮤니티의 피드백은 문제 해결, 기능 향상 및 문서 업데이트에 도움이 됩니다. Apple 소프트웨어 또는 하드웨어에 문제가 발생하거나, SDK 기능 요청이 있거나, Apple에서 제공하는 API에서 코드 수준 버그 및 문제를 발견하거나, 개발자 문서에서 오류 또는 누락된 사항을 발견하는 경우 Apple에 알려 주십시오.

    가능한 한 빨리 피드백을 제공해 주십시오. 새로운 피드백을 보내는 경우 피드백 지원 앱에서 문제를 진단하는 데 중요한 역할을 하는 시간에 민감한 정보를 자동으로 수집합니다. 피드백 지원 웹 사이트를 사용하는 경우 이 정보를 수동으로 수집할 수 있습니다. 이 작업을 완료하면 피드백 지원에 직접 정보를 업로드할 수 있습니다. 차후 피드백을 보내거나 웹 사이트를 통해 피드백을 보낼 계획이라면 문제가 발생한 날짜 및 시간과 같은 핵심 정보를 메모해 두고 문제가 발생하는 즉시 파일 또는 로그를 수집하시기 바랍니다. 하나의 기기에서 피드백을 시작하고 저장한 다음 다른 기기로 전환하여 세부 사항을 추가하고 나중에 제출할 수 있습니다.

    베타 소프트웨어 관련 보고서는 조속히 제출해 주십시오. 베타 소프트웨어에는 때때로 API에 대한 변경 사항이나 앱에서 해결해야 하는 새로운 문제가 포함되어 있을 수 있습니다. 베타 릴리즈 주기 동안 문제가 발생하면 공개 릴리즈 버전에서 문제가 해결될 가능성이 높아지도록 즉시 피드백을 제출하여 주십시오.

    모든 문제에 대해 피드백을 제출해 주십시오. 문제가 분명하고 다른 사람이 이미 보고했을 것이라는 생각이 들더라도 피드백을 제출해야 합니다. 문제에 대해 피드백을 많이 받을수록 해당 문제로 인하여 얼마나 많은 사용자가 영향을 받는지 더 잘 파악할 수 있습니다.

    피드백 지원 앱 사용하기

    피드백 지원 앱에는 다음과 같은 몇 가지 유용한 기능이 있습니다.

    자동 온디바이스 진단. 각 문제의 sysdiagnose(운영 체제의 다양한 부분의 진단 정보 및 최근 충돌 로그 일체)를 수동으로 수집하고 첨부할 필요가 없습니다. 개발자 승인 하에 피드백 지원에서 영역별 진단을 실행하여 sysdiagnose 진단 범위 이상의 정보를 제공할 수 있습니다.

    원격 제출. iPhone 및 iPad에서 피드백 지원을 사용하여 연결된 Apple TV, HomePod 또는 Apple Watch에 관한 피드백을 제출하고 해당 기기에서 직접 기기 진단 정보를 수집할 수 있습니다.

    상세 보고서 양식. 간단한 제출 절차를 통해 구체적인 조건부 문항에 답하여 자세한 정보를 제공할 수 있습니다.

    앱 열기

    iPhone 및 iPad. iOS 및 iPadOS의 베타 버전에서는 기본적으로 앱이 홈 화면에 제공됩니다. iOS 및 iPadOS 공식 릴리즈 버전에서는 베타 프로파일을 설치하면 앱을 활성화할 수 있습니다. applefeedback:// URL 체계를 사용하여 앱을 실행할 수도 있습니다.

    Mac. 모든 macOS 버전의 CoreServices 폴더에 앱이 포함되어 있으며, applefeedback:// URL 체계를 통해 실행하거나 Spotlight에서 피드백 지원을 검색하여 실행할 수 있습니다. Finder 윈도우를 열고 이동 메뉴에서 폴더로 이동을 선택한 다음 아래의 경로를 입력할 수도 있습니다. /시스템/라이브러리/CoreServices/Applications

    피드백 작성하기

    보고서당 한 건의 문제를 제출해 주십시오. 정확한 처리를 위해 보고서에는 문제 또는 요청 한 건만 포함하도록 합니다. 여러 문제에 대해 논하는 보고서는 처리할 수 없으며 개별 보고서로 다시 제출하도록 반환될 수 있습니다.

    제목. 보고서 제목은 간결해야 하며 문제 및 발생한 문제에 영향을 미칠 수 있는 요소를 명확하게 설명해야 합니다. 기술, 플랫폼 및 버전과 같은 주요 세부 사항을 요약 및 포함하도록 합니다. 예를 들어 '캘린더 이벤트가 사라짐'보다는 '빠른 이벤트 생성 후 iOS 15.2 베타의 캘린더 이벤트가 사라짐'이 더 실행 가능한 세부 사항을 제공하는 것입니다. 문제가 앱과 관련된 경우 해당 앱의 이름 및 버전도 포함하도록 합니다.

    설명. 보고서에는 각 단계에 대한 자세한 설명과 함께 문제를 재현하는 방법에 대한 지침을 포함하도록 합니다. 예를 들어 다음과 같이 작성할 수 있습니다.

    1. 캘린더 앱에서 빠른 이벤트를 클릭합니다.
    2. 이벤트를 원하는 제목으로 작성합니다.
    3. return 키를 누릅니다.

    실제 결과: 이벤트가 내 캘린더의 올바른 위치에 나타났다가 사라집니다.

    정상적인 결과: 이벤트가 표시되고 내 캘린더에 유지되어야 합니다.

    실행 단계와 정상적인 결과를 작성한 후 문제에 영향을 미칠 수 있는 추가 요소가 있는지 생각해 봅니다. 예를 들어, iCloud에 로그인했는가? 손쉬운 사용 설정이 켜져 있는가? 운영 체제의 다른 부분에서 문제를 재현할 수 있는가? 더 많은 정보를 포함하여 작성할수록 더 효과적으로 문제를 진단할 수 있습니다.

    첨부 파일 포함하기

    sysdiagnose.피드백 지원 앱의 경우 자동으로 각 문제에 대한 sysdiagnose를 첨부하므로 iPhone, iPad 또는 Mac의 앱에서 바로 보고서를 제출할 것을 권장합니다. Sysdiagnose에는 시스템 상태 및 모든 최근 충돌 로그와 관련한 중요한 정보가 포함되어 있으며, 필요하지 않다고 생각되더라도 모든 보고서에 포함해야 합니다. 또는 웹 사이트를 사용하여 ZIP 압축 파일로 관련 파일 및 폴더를 수동으로 업로드할 수 있습니다. 보고서 검토 이후 추가 파일을 제공하라는 요청을 받을 수 있습니다.

    디버그 프로파일 및 로그. 보고한 내용을 더 자세히 진단하기 위한 추가 보고 및 로그 세부 사항을 제공할 수 있도록 디버그 프로파일을 설치하라는 요청을 받을 수 있습니다. 디버그 프로파일로 문제를 진단하는 데 도움이 되는 기술 또는 프레임워크에 대한 구체적인 세부 정보를 수집할 수 있습니다. 디버그 프로파일을 설치하려면 프로파일 및 로그 페이지에서 기기로 다운로드하시기 바랍니다. 그런 다음 지침에 따라 요청받은 정보를 수집하고, 조사가 조속히 진행되도록 모든 관련 로그를 포함하도록 합니다.

    Mac 시스템 정보 보고서. 충돌, 커널 패닉, 하드웨어 버그 또는 인쇄 문제가 발생하는 경우 피드백과 함께 Mac 시스템 정보 보고서를 포함하도록 합니다.

    빌드 및 샘플 코드. 문제가 앱에서 발생하는 경우 시연하기 쉽도록 작은 프로젝트를 사용하여 문제를 재현하도록 합니다. 그러면 문제가 되는 구체적인 버그의 범위를 좁히는 데 도움이 되며, 이는 문제를 식별하는 가장 쉬운 방법의 하나기도 합니다. 컴파일하는 전체 프로젝트를 생성할 수 없는 경우 코드 예시도 도움이 됩니다.

    스크린샷 또는 화면 녹화. 문제가 사용자 인터페이스에서 발생하는 경우 피드백에 시각 자료를 포함하도록 합니다. 설명 필드에 포함할 수 있다는 생각을 하지 못했던 유용한 단서와 세부 정보를 재현된 버그의 스크린샷이나 화면 녹화에서 발견할 수도 있습니다.

    팀과 공동 작업하기

    팀에서 제출한 모든 보고서를 보고, 의견에 답하고, Apple에 새 메시지를 보낼 수 있는 피드백 지원 내의 팀의 받은 편지함에서 피드백을 제출하는 것이 좋습니다. 팀 보고서가 할당된 팀원은 Apple의 요청이 있을 경우 알림을 받게 되며, 재량에 따라 첨부 파일을 다운로드하거나 보고서를 종료할 수 있습니다. 기본적으로 보고서는 제출한 팀원에게 할당됩니다. 그러나 다른 팀원에게 재할당할 수 있습니다.

    팀의 받은 편지함의 보고서는 보고서를 제출한 사람이 아니라 조직에 속하게 됩니다. 보고서가 할당된 팀원이 조직을 떠나도 보고서는 팀에 남아 있습니다. 팀의 받은 편지함 외에도 별도의 제출을 위해 개인용 받은 편지함이 제공됩니다. 언제든지 보고서를 개인용 받은 편지함에서 팀의 받은 편지함으로 이동할 수 있습니다.

    제출 후 예상되는 상황

    피드백에 피드백 지원 ID가 할당되며, 이를 사용하여 제출한 피드백의 업데이트나 해결 방법을 확인할 수 있습니다. 또한 Apple에서 문제를 조사하는 데 필요한 추가 정보나 파일을 요청하는 이메일을 보낼 수도 있습니다. 접수된 모든 건에 답할 수는 없지만, Apple에서는 접수된 보고서를 모두 검토하며, 문제의 범위를 더 잘 파악하수 있도록 제출된 피드백의 양을 모니터링합니다.

    문제를 해결 중이므로 모든 사용자를 위한 베타 소프트웨어 업데이트에서 수정 사항을 사용할 수 있거나 문제 조사를 완료한 후 다른 해결 방법이 확인될 때까지 Apple에서는 상태 업데이트를 제공할 수 없습니다.

    피드백 상태 이해하기

    Recent Similar Reports (최근 유사 보고서). 지난 1년 동안 본인의 보고서와 함께 그룹화된 유사한 보고서가 얼마나 많은지 알아보십시오. 상태는 없음, 10건 미만 또는 10건 초과로 설정됩니다. Apple에서서 피드백에 대한 이해가 향상되고 다른 개발자로부터 더 많은 피드백을 받으면 이 변경될 수 있습니다. 지난 1년 동안 생성된 보고서는 최근 보고서로 간주합니다. 보고서가 오래될수록 증상이 비슷해 보이더라도 재현 가능성이 떨어지고 새 보고서와의 유사성이 낮을 가능성이 높기 때문입니다.

    Open (진행 중). Apple에서 보고서를 조사 중입니다. 조사를 계속하기 위한 추가 정보 요청과 함께 반환되었을 수도 있습니다.

    Potential Fix Identified – For a Future OS Update (잠재적 수정 사항 식별됨 - 향후 OS 업데이트용). 보고된 문제의 잠재적인 수정 사항은 향후 OS 업데이트에 반영될 수 있으며, 해당 업데이트는 일반적으로 다음 해 내에 출시됩니다. 베타 릴리즈 버전에서 사용할 수 있게 될 경우 해결 방법에는 플랫폼 버전과 빌드 번호도 포함됩니다.

    본인이 제출한 보고서는 최초 근본 원인이 동일한 것으로 파악된 유사한 보고서와 그룹화될 수 있습니다. 그러나 유사한 보고서의 원인은 여러 가지일 수 있습니다. 수정 사항을 사용했을 때 유사한 보고서의 문제는 해결되나 본인이 제출한 문제는 완전히 해결되지 않는다면 새로운 보고서를 제출하십시오.

    Investigation Complete – Change Required by a Third Party (조사 완료 – 타사에서 변경 필요). 보고된 문제를 해결하려면 Apple이 아닌 타사의 소프트웨어, 하드웨어 또는 서비스를 변경해야 합니다.

    Investigation Complete – Works as Designed (조사 완료 – 정상적인 동작). 보고서에 설명된 동작은 설계된 대로 작동한 동작입니다.

    Investigation Complete - Unable to Diagnose with Current Information (조사 완료 - 현재 정보로는 진단할 수 없음). 보고된 문제를 계속 조사하려면 추가 정보가 필요합니다. 추가 로그 파일, 재현 단계 또는 기타 명확한 세부 사항을 제공해야 할 수도 있습니다.

    Closed (종료됨). 보고한 당사자가 보고서를 종료됨으로 표시한 것입니다. 더 이상 문제가 발생하지 않는 경우 언제든지 보고서를 종료됨으로 표시할 수 있습니다. 보고서를 종료한 후에 동일한 문제가 발생하는 경우 새 보고서를 제출하십시오.

    알려진 문제 임시 해결 방법

    피드백 지원으로 보고서를 제출한 후에도 Apple 소프트웨어 또는 서비스에 문제가 계속되는 경우 문제를 조사하는 동안 임시 해결 방법이 제공될 수도 있습니다.

    릴리즈 노트. 최신 소프트웨어 업데이트용 최신 릴리즈 노트를 검토하여 이전 업데이트에 제기된 문제가 해결되었는지 또는 임시 해결 방법이 있는지 확인하시기 바랍니다. 최신 릴리즈 노트는 피드백 지원의 받은 편지함 또는 소프트웨어 릴리즈 페이지에서 확인할 수 있습니다.

    포럼. 지금 겪고 있는 문제가 Apple 개발자 포럼에서 논의되고 해결되었는지 확인해 보십시오.

    코드 수준 지원. Apple Developer Program 또는 Apple Developer Enterprise Program 회원은 코드 수준 지원을 요청할 수 있습니다. 보고서를 제출한 후 TSI(Technical Support Incident)를 제출하고, 보고서에 제공한 정보와 관련 있는 파일 또는 로그를 포함하도록 합니다. 피드백 지원 ID는 문제 진단에 도움이 될 수 있으므로 이를 포함하는 것을 적극 권장합니다. 제출된 건은 가능한 임시 해결 방법을 조사할 수 있는 기술 지원 엔지니어에게 할당됩니다.

    비활성 보고서에서 데이터 삭제하기

    Apple의 개인정보 보호를 위한 노력의 일환 및 유럽 연합의 개인정보보호 규정(GDPR)에 따라 2018년 늦가을부터 특정 보고서에서 개발자 데이터를 삭제하였습니다.

    자주 나타나지 않는 문제의 데이터 삭제. 종료된 지 5년이 지나고 60일 동안 업데이트되지 않았으며 다른 문제와 중복되지 않은 문제의 개발자 데이터는 삭제됩니다. 개발자가 생성한 sysdiagnoses 및 관련 첨부 파일이 삭제되며 최초 피드백을 제출한 개발자에 대한 언급은 모두 삭제됩니다. 또한 해당 문제는 더 이상 표시되지 않습니다.

    중복 문제는 일정 시간 동안 계속 사용할 수 있습니다. 중복 문제로 표시되는 경우 최초 버그가 종료된 지 5년이 지나고 60일 동안 업데이트되지 않으면 개발자 데이터가 삭제됩니다. 그때까지 개발자는 문제가 종료될 때까지 최초 제기된 문제의 상태를 확인할 수 있으며, 해당 문제가 해결될 때까지 엔지니어링 팀에서 개발자에게 연락을 취할 수 있습니다.

    Apple Security Bounty

    Apple 기기, 소프트웨어, 서비스 또는 웹 서버에 영향을 미치는 보안 또는 개인 정보 보호 취약점을 발견했다고 생각된다면 Apple 보안 팀에 보고해 주십시오. 보안 전문가, 개발자 및 고객을 포함한 모든 분들의 보고를 환영합니다. 모든 보고서는 상금 정산을 위해 검토되고 평가됩니다.

    더 알아보기

    Apple 베타 소프트웨어 프로그램

    Apple 베타 소프트웨어 프로그램에서는 사전 공개 Apple 소프트웨어에 대한 피드백을 수집합니다. Apple 베타 소프트웨어 프로그램 회원은 공개 베타 이용을 위해 기기를 등록할 수 있고, 최신 기능을 사용해 보고, 피드백 지원 앱을 사용하여 Apple에 직접 피드백을 제공할 수 있습니다.

    더 알아보기

    리소스