Unity 검색

유능한 베타 테스터가 되기 위한 가이드

Unity 얼리액세스 베타 테스트를 시작하고 테스트로부터 가장 많은 가치를 얻는 데 도움이 되는 실용적인 가이드와 참고 문서입니다.

환영합니다

베타 테스트가 중요한 이유

QA 직원들은 안정적인 Unity 릴리스를 위해 고군분투하지만, 릴리스가 예정된 빌드에 대한 개발자 커뮤니티 여러분의 피드백이 없으면 이 모든 것이 불가능합니다. 도와주셔서 대단히 감사합니다!

도움 주시는 여러분께 보탬이 될 수 있도록, Unity는 프로젝트 업로드 방법과 버그 리포트 작성 방법 등 최고의 베타 테스터가 되는 방법이 담긴 가이드를 작성했습니다. 각 단계를 따라 Unity가 여러분의 프로젝트의 개발에 영향을 미치는 문제를 해결하는 데 가장 중요한 정보를 전달해주실 수 있습니다.

베타 버전에 대한 피드백은 매우 소중합니다. Unity는 4등급 및 5등급 베타 버그 리포트를 모두 분석하고, 등급이 더 낮은 버그 리포트도 살펴볼 수 있도록 최선을 다합니다(무슨 뜻인지 모르시겠다면 이 블로그 게시물를 참조하세요). 버그를 확인한 후 수정이 있으면 예정된 베타 릴리스에 포함되도록 일정을 짭니다. 지금은 어떤 수정 사항이 어떤 베타 버전에 포함될 것인지는 자세히 알려드릴 수 없지만, 최대한 빠른 시일 내에 알려드리겠습니다!

효과적인 버그 보고서 및 피드백 제출을 위한 워크플로에 대한 자세한 내용은 아래에서 확인하세요. 또한 가장 중요한 단계에 대한 요약을 확인할 수 있습니다.

베타에 대해 더 자세히 알아보려면 베타 포럼을 방문하세요.

01

설치 및 시작

  1. 스탠드얼론 인스톨러로 직접 설치하거나, 새로운 Unity Hub를 통해 최신 베타 빌드 다운로드하세요. 이 페이지에는 방대한 베타 정보 및 리소스가 포함되어 있습니다. 새 기능을 알아보고, 유용한 문서와 툴을 찾고, 최근 행사에 대한 정보도 계속 확인할 수 있습니다.
  2. 인스톨러 또는 Hub를 실행합니다. 인스톨러를 사용하는 경우 베타를 새 디렉토리에 설치해야 합니다. Unity의 여러 버전을 동시에 설치해도 되며, 이때 각 버전이 개별 디렉터리에 있어야 한다는 점에만 주의하세요.
  3. 새 프로젝트를 시작하거나 베타 테스트에 사용할 프로젝트 복사본을 만든 다음 최신 베타 버전으로 프로젝트를 엽니다.
    • 기존 프로젝트를 베타에서 실행하기로 결정할 경우, 백업 복사본을 만들어야 합니다. 이전 버전과의 호환성은 보장되지 않으므로 프로젝트를 업그레이드한 후에는 이전 버전으로 되돌리지 못할 수도 있습니다.
    • Unity에서 프로젝트를 열면 현재 사용 중인 Unity 버전으로 프로젝트가 자동으로 마이그레이션됩니다. 따라서 프로젝트 복사본을 사용하여 작업하면 안정적인 최신 버전으로 돌아갈 때 다시 임포트하지 않아도 되므로 시간을 더욱 절약할 수 있습니다.
  4. 일반적인 방법으로 개발하거나 새 기능 및 업데이트를 테스트합니다. 버그를 발견했다고 생각되면 가이드의 2, 3, 4부에 설명된 다음 단계를 수행합니다.

02

Unity에서 버그 처리하기

버그를 찾으셨나요? 다음과 같이 효과적으로 도움을 주실 수 있습니다.

상황 파악하기

초기 조치

후속 조치

1. 상황 파악하기

이슈 트래커에서 기존 버그 보고서를 확인하세요.

이슈를 Google에서 검색하여 관련 포럼 스레드를 찾으세요.

2. 초기 조치

이미 알려졌지만 해결되지 않은 이슈인가요?

해당되는 이슈 트래커 항목에 투표하세요.

알려지지 않은 이슈인가요?

최소 재현 프로젝트와 함께 버그 보고서를 제출하고 유니티 직원의 요청에 응답해 주세요.

3. 후속 조치

이미 이슈를 보고했지만, 제출한 버그에 대한 해결책이 적용되었는지 확인하고 싶으신가요?

최소 재현 프로젝트와 함께 버그 보고서를 제출하고 유니티 직원의 요청에 응답해 주세요.

해당 이슈에 대한 기존 포럼 스레드가 있나요?

있다면 답변을 추가해 주세요. 없을 경우, 이슈 ID를 기재하여 새로 작성해 주세요.

Unity에 문제가 발생할 경우, 우선 알려진 문제인지 아니면 처음 발생한 문제인지 파악해야 합니다. 이런 종류의 정보는 Unity의 공용 문제 추적기(Issue Tracker)에서 가장 먼저 얻을 수 있습니다. 이를 통해 다른 사용자가 신고한 버그를 검색하거나, 투표를 하거나, 코멘트를 작성할 수 있습니다. 투표에 참여하시면 Unity 팀에서 버그를 처리할 우선 순위를 정하는 데 도움이 됩니다.

Unity 베타 포럼은 또 하나의 훌륭한 커뮤니티 리소스입니다. 다른 사람들이 무엇을 신고했는지 보거나, 문제 해결 방법을 찾거나, 직접 정보를 제공할 수 있습니다. Unity 직원에게 연락할 수 있는 좋은 수단이기도 합니다. 신고하는 문제가 현재 베타와 관련이 있는지 확인하고, 두 개 이상의 서로 다른 문제를 스레드 하나에 포함하지 않도록 주의하세요.

버그와 관련된 내용을 찾을 수 없으면 버그 리포트를 제출하세요. 신고를 접수한 후에 포럼으로 돌아와서 발견한 문제에 대한 설명을 게시하는 것도 좋은 방법입니다. 그러면 다른 사용자가 정보를 얻고 더 많은 컨텍스트를 추가할 수도 있고, 자신이 문제를 해결한 방법을 게시할 수도 있습니다. Unity에서 베타 포럼을 자주 모니터링하고 포럼에서 논의되는 새로운 사례를 검토할 우선 순위를 정하기 때문에, 여러분이 적극적으로 참여하실수록 버그 처리 속도도 더욱 빨라집니다.

문제에 대한 새로운 스레드를 여는 경우, 케이스 번호(확인 이메일에 포함)를 게시물에 기재하여 접수한 버그 리포트를 Unity 팀이 식별할 수 있도록 해야 합니다. 케이스 번호를 기재하지 않으면 Unity 팀이 이 번호를 가장 먼저 물어볼 것입니다.

버그로 의심 되거나, 포럼에서 제공되는 컨설팅 내용이나 도큐멘테이션 내용들이 명확하지 않은 경우, 버그리포트를 작성해주십시오.

03

버그 기록 및 신고

처음에는 버그를 신고하기가 다소 부담스러울 수 있지만, 실은 생각보다 어렵지 않습니다. 버그를 신고해 주시면 엔진의 안정성을 유지하는 데 큰 도움이 됩니다. 아래의 간단한 절차에 따라 Unity 엔지니어들이 쉽게 이해하고 조치를 취할 수 있도록 버그 리포트를 꼼꼼히 작성해 주세요.

실수를 할까 봐 걱정하지 마세요. 리포트에 기재하신 정보를 토대로 Unity에서 문제를 재현할 수 없는 경우, 따로 연락을 드려 누락된 내용이 없는지 확인합니다.

버그 리포터(Bug Reporter) 열기

Unity 실행 중에 메뉴에서 도움말(Help) → 버그 신고(Report a Bug)로 이동합니다. 프로그램 폴더의 에디터 옆에서도 설치된 버그 리포터를 찾을 수 있습니다. 크래시가 발생한 경우에도 리포터가 자동으로 실행됩니다.

기본 정보 제공

“문제가 무엇과 관련이 있나요(What is the problem related to)” 필드에서 신고하려는 버그와 가장 관련성 높은 옵션을 선택하세요. 베타에서 발견된 버그를 신고하려고 하므로, 일반적으로 “에디터 문제(A problem with the Editor)” 또는 “크래시 버그(Crash Bug)”를 선택하세요.

“문제가 얼마나 자주 발생하나요(How often does it happen)”에서 한 번만 발생한 문제인지, 가끔 발생하는 문제인지, 아니면 매 절차마다 발생하는 문제인지 알려주셔야 합니다.

Unity 팀에서 자세한 내용을 알아보기 위해 연락을 드릴 경우에 대비하여 이메일 주소를 입력하세요. Unity 계정으로 로그인한 경우 이 필드가 자동으로 채워집니다.

리포트가 확인되면 문제 추적기에서 “제목(Title)” 및 “문제 설명(Describe the problem)” 필드가 커뮤니티에 공개됩니다. 다른 사용자는 코멘트를 남기고, 투표에 참여하고(해결 우선 순위를 정하는 데 도움이 됨), 사용 가능한 해결책이 있으면 확인할 수 있습니다. 개인 정보는 게시되지 않습니다. 프로젝트와 기타 첨부 파일에는 Unity 직원만 접근할 수 있습니다.

버그 특성 설명

버그를 최대한 간결하게 설명해 주시면 됩니다. 다음과 같이 짧고 구체적으로 작성하세요.

GI 캐시를 지우고 프로젝트를 다시 로드한 후에 오류가 콘솔에 표시됨

버그 분류 지정 및 제목 작성

에셋 임포트, 스크립팅, 특정 플랫폼, 크래시 등 버그가 어느 분류에 해당되는지 지정합니다. 이 사례에서는 버그가 조명, 더 구체적으로는 Enlighten 라이트매퍼와 관련이 있습니다.

이제 이 내용과 버그 설명을 추가해서 제목을 다음 형식으로 작성합니다.

[카테고리] 설명

이 시나리오에서는 버그 제목을 다음과 같이 작성합니다.

[Enlighten] GI 캐시를 지우고 프로젝트를 다시 로드한 후에 오류가 콘솔에 표시됨

버그 재현을 위한 절차 제공

Unity QA 및 개발팀은 문제를 진단하고 해결하는 데 도움이 될 수 있는 모든 정보를 필요로 합니다. 전달되는 정보에 따라, 담당팀에서 근본 원인을 식별하지 못하거나 잘못 이해하여 엉뚱한 부분을 수정할 수도 있습니다. 따라서 처음부터 최대한 많은 정보를 제공하여 문제가 확실하게 처리되도록 하는 것이 가장 좋습니다. 이렇게 하는 가장 쉬운 방법은 일반적으로 버그가 발생하기 전에 수행한 단계를 역추적하는 것입니다. 버그가 발생하기 전에 가장 먼저 어떤 작업을 진행하셨나요?

프로젝트 닫고 다시 열기

이 단계는 재현할 절차의 마지막 단계입니다. 그 직전에 수행한 작업은 무엇인가요?

GI 캐시를 삭제함: 편집(Edit) > 환경 설정(Preferences) > GI 캐시(GI Cache) > 캐시 삭제(Clean Cache)

기억할 수 있는 최대한 이른 단계까지 계속 떠올려 봅니다. Unity를 처음 열었던 시점까지 기억하실 수 있으면 가장 좋습니다. 정보가 많을수록 버그를 재현하여 수정하기가 더 쉬워집니다. 모든 단계를 기억할 수 없다면, 버그를 어떻게 재현할 수 있는지 실험해 보고 각 단계별로 나타나는 특징을 주의 깊게 살펴 보세요.

버그 재현 절차를 꼭 텍스트로 제공하지 않아도 됩니다. 예를 들어 화면을 동영상으로 캡처하여 단계를 제출해도 됩니다. 엔지니어가 버그를 재현할 수 있도록 각 단계를 명확하게 설명하는 것이 가장 중요합니다.

예상 결과와 실제 결과 비교 추가

버그가 발생하기 전에 어떤 일이 발생할 것이라고 예상하셨나요?

예상: 콘솔에 오류가 표시되지 않음

예상과 달리 어떤 일이 발생했나요?

실제: 콘솔에 오류가 표시됨

예기치 못한 오류 메시지가 나타날 경우 설명에 메시지로 추가하면 도움이 됩니다.

이런 정보를 모두 입력한 후의 리포트는 다음과 같습니다.

프로젝트 폴더 첨부

에디터에서 버그 리포터를 열면 현재 로드된 프로젝트가 버그 리포트에 자동으로 포함됩니다. 반면에 실행 가능한 파일로 리포터를 열면 프로젝트를 수동으로 연결해야 합니다. 프로젝트가 매우 작은 경우가 아니라면, 버그와 관련 없는 에셋은 제거하는 것이 좋습니다. 버그 재현에 필요한 최소한의 내용만 포함된 프로젝트를 제출하면 Unity QA 및 개발팀이 문제를 효율적으로 파악하고 더욱 빠르게 해결할 수 있습니다.

문제가 프로젝트의 특정 씬에서 발생하는 경우, 버그가 발생한 씬을 익스포트한 다음 새 프로젝트로 임포트하여 버그가 계속 발생하는지 확인해 보세요. 버그가 계속 발생하면 더 작은 새 프로젝트를 업로드하고, 버그가 발생하지 않으면 더 큰 프로젝트 버전으로 계속 시도해 볼 수 있습니다.

Unity는 최대한 작은 크기의 재현 프로젝트를 더욱 쉽게 만들 수 있는 몇 가지 툴을 개발했습니다.

툴 사용 방법에 관한 자세한 정보는 !여기에서 확인할 수 있습니다.

프로젝트 크기는 작을수록 좋지만, 큰 프로젝트도 버그 해결에 많은 도움이 됩니다. 프로젝트 크기를 줄일 수 없다면 전체 프로젝트를 포함하세요. Unity의 신고 시스템은 대용량 첨부파일을 지원합니다. 프로젝트에는 에셋에 포함되지 않는 관련 데이터 및 파일이 포함되므로 개별 에셋을 업로드하지 마세요.

이제 최종 리포트의 형태는 다음과 같습니다.

완벽합니다! Unity 팀이 문제를 찾고 해결하는 데 사용할 수 있는 유용하고 간결한 버그 리포트를 작성하셨습니다. 마지막으로 다음 단계 하나만 남았습니다.

버그 리포트 제출

“보내기(Send)”를 눌러 버그 리포트를 제출합니다.

버그가 접수되면 케이스 번호가 포함된 확인 이메일이 전송됩니다. 이 이메일을 보관해 주세요. 이메일에는 현재 버그 상태가 있는 웹 페이지로 연결되는 링크가 포함됩니다. 이 페이지를 언제든지 다시 방문하여 업데이트를 확인할 수 있습니다. 이 링크를 포럼이나 다른 공개된 공간에 공유하지 마세요. 본인의 연락처, 주소나 버그 신고 이력이 공개될 수 있습니다. 케이스 번호만 있어도 다른 사용자가 문제 추적기에서 문제를 찾을 수 있습니다.

개인적인 편의를 위해 버그 리포트와 관련 프로젝트 폴더를 계속 관리하시면 도움이 됩니다. 다음과 같은 방법을 활용해 보세요.

  1. 버그 리포트를 접수할 때마다 첨부한 프로젝트의 .zip 파일을 만듭니다.
  2. 버그 리포트 자체를 .txt 파일로 에셋(Assets) 디렉토리에 보관합니다. 그러면 프로젝트가 표시하는 오류와 오류를 재현하는 방법을 알 수 있습니다.
  3. 버그 리포트를 접수한 후 확인 이메일에 제공된 케이스 번호를 복사하여 .zip 파일의 이름으로 지정합니다.

이렇게 하면 Unity에서 버그 리포트가 마감되었음을 알리는 이메일을 보낸 후에 리포트에 첨부하신 프로젝트를 빨리 찾을 수 있습니다.

버그 리포트 마감에 대한 Unity의 알림을 받으면 해당 프로젝트를 찾아 최신 Unity 베타에서 연 다음 버그가 수정되었는지 확인할 수 있습니다. 절차에 따라 재현하여 버그가 수정되었는지 쉽게 확인할 수 있습니다.

이 모든 과정을 거치려면 해야 할 일이 좀 많지만, a) 품질이 높은 버그 리포트를 얻게 될 가능성이 더 커지므로 버그를 재현하고 고칠 수 있는 가능성이 높아지고, b) 향후 베타 버전에서 버그가 수정되었는지 쉽게 확인할 수 있습니다.

04

후속 커뮤니케이션

Unity 직원들이 드릴 질문이 있는 경우 연락을 드릴 수 있으면 문제 해결에 많은 도움이 됩니다. 버그 리포트를 제출하신 경우 팀에서 검토한 후 이메일을 통해 연락을 드립니다. 포럼에 게시물을 작성하신 경우 게시물에 답변을 드립니다. 팀에서 질문을 드리면 최대한 빨리 답변을 보내 절차 진행에 도움을 주시기 바랍니다.

발견하신 버그가 포럼에 언급되어 있지 않은 경우 새 스레드를 시작하는 것이 좋습니다. 다른 사용자들도 같은 문제를 겪었을 수 있으므로, 다른 스레드에서 해결 방법을 게시하면 베타 커뮤니티에서 친구를 가장 빨리 만들 수 있습니다!

여기까지입니다!

유능한 베타 테스터가 되는 방법에 대해 알아보는 데 시간을 내어 주셔서 감사합니다. 위 내용에 대한 질문이 있거나 검색 엔진으로 답변을 찾을 수 없는 경우 포럼에 질문을 남겨 보세요.

확인

유니티에서는 웹 사이트의 모든 기능을 최대로 이용할 수 있도록 쿠키를 사용합니다. 자세한 정보는 쿠키 정책 페이지를 참조하세요.