다음을 통해 공유


제출 유효성 검사 도구(SubmissionValidator.dll)

제출 유효성 검사 도구는 타이틀 또는 앱 패키지에서 일련의 기본 품질 검사를 실행하는 Microsoft GDK(게임 개발 키트)의 구성 요소입니다. 제출 유효성 검사 도구는 개발자에게 피드백을 제공하고 Microsoft에서 콘텐츠를 수집 및 인증할 때 타이틀 실패를 일으킬 수 있는 일반적인 문제를 해결할 수 있게 해줍니다. 타이틀 패키지가 제출되면 최신 버전의 제출 유효성 검사 도구를 사용하여 타이틀의 거부로 이어질 수 있는 모든 오류를 감지합니다. 제출 유효성 검사 도구에서 매우 중요한 목표는 이러한 검사를 자동화하고 가급적 빨리 이를 프로세스로 푸시하여 파트너가 인증을 위해 타이틀 패키지를 제출하기 전에 문제를 자체 진단하고 교정할 수 있도록 하는 것입니다.

제출 유효성 검사 도구 사용

제출 유효성 검사 도구는 개발자가 사용하는 독립 실행형 도구가 아닙니다. 대신 makepkg pack 명령이 사용될 때마다 앱을 검사하도록 자동 호출됩니다. 구문 및 명령줄 사용에 대한 자세한 내용은 makepkg 참조 페이지를 참조 하세요.

제출 유효성 검사 도구는 타이틀 패키지가 생성된 후에 실행됩니다. 유효성 검사의 오류는 makepkg 명령줄에 지정된 출력 위치에 기록되는 유효성 검사 로그에 기록됩니다. 최종 타이틀 패키지가 생성된 곳과 동일한 출력 위치입니다. makepkg에 /validationlanguage 매개 변수를 설정한 경우 영어 출력 외에 현지화된 출력 버전도 동일한 위치에서 사용할 수 있습니다. 현재 지원되는 추가 유효성 검사 언어는 ja-jp입니다.

Makepkg validate 명령줄을 실행하여 타이틀 패키지 만들기 전에 제출 유효성 검사 도구 테스트의 하위 집합을 실행할 수 있습니다. 패키지 만들기 전에 이것을 실행하여 문제를 파악하는 것이 좋습니다.

제출 유효성 검사 도구로 식별된 문제

제출 유효성 검사 도구에서 식별하는 문제의 유형은 제출에서 인증, 시장으로 이어지는 과정을 매끄럽게 만든다는 목표로 시간에 따라 진화하고 증가합니다. 제출 유효성 검사 도구에서 감지하는 문제의 현재 목록은 제출 유효성 검사 도구 품질 검사를 참조하세요.

결과 로그 이해

makepkg 프로세스가 완료된 이후 타이틀 XVC가 출력 폴더에 표시됩니다. 유효성 검사 로그는 이 같은 폴더에 있습니다. "Validator_[title and package identifier].xml" 형식의 이름으로 인식할 수 있습니다. 이 로그에서 오류 또는 경고가 있는지 검사해야 합니다. 이전 섹션에 표시된 오류 및 경고 외에도 <failure> 태그는 콘텐츠 수집, 마스터링 및 인증 단계의 일환으로 제출이 거부되는 조건을 지정합니다. 이러한 패키지를 제출해도 아무 문제가 없지만 이 경우 불필요한 시간 및 노력이 낭비됩니다. 로그에 <failure> 태그가 없을 때까지 식별된 문제를 교정하는 것이 훨씬 더 좋습니다.

또한 로그에 <warning> 태그가 있을 수 있습니다. 이는 일반적으로 예외가 필요할 수 있는 문제를 나타냅니다. 식별된 경고에 대한 궁금증이 있는 경우 개발자 계정 관리자(DAM)에게 문의하세요. 타이틀에 대해 예외를 허용한 경우에도 로그 파일에 <warning> 태그가 여전히 표시됩니다. 로그 메시지의 전체 목록은 제출 유효성 검사 도구 메시지를 참조하세요.

<validatorrun> 섹션은 로그 끝에 다음과 같이 표시됩니다. 이 섹션에는 <result> 태그가 있어 유효성 검사 도구 테스트의 전체 오류 또는 성공 여부를 나타냅니다. 섹션에서 오류가 있는 경우 전체 오류가 발생합니다.

<validatorrun>
  <starttime>Sep 23 2019 16:43:41</starttime>
  <endtime>Sep 23 2019 16:43:41</endtime>
  <result>Fail</result>
</validatorrun>  

테스트에 사용되는 제출 검사기의 버전 번호는 로그 파일의 맨 위에 있습니다. 다음 예제는 로그 파일의 버전 번호를 보여줍니다.

<XboxOneSubmissionValidator>
  <engineversion>10.0.18362.7198</engineversion>  

제출을 Microsoft에서 수신하면 제출은 제출 검사기의 최신 버전으로 테스트를 받습니다. 타이틀을 제출을 준비하면서 현재 사용 중인 제출 검사기 버전을 정기적으로 업데이트하는 것이 좋습니다. 자세한 내용은 다음 섹션을 참조하세요.

제출 유효성 검사 도구 업데이트

제출 유효성 검사 도구는 Microsoft GDK(게임 개발 키트)의 \Bin 디렉터리에 있는 별도의 SubmissionValidator.dll로 구현됩니다. 제출 검사기에 대한 업데이트가 항상 Microsoft GDK(게임 개발 키트)의 릴리스 주기와 일치하는 것은 아닙니다. 최신 버전의 제출 유효성 검사 도구는 Xbox 개발자 다운로드->GDK->제출 유효성 검사 도구에서 언제든지 다운로드할 수 있습니다. 압축 (.zip) 파일을 다운로드한 후 파일을 열어 업데이트된 SubmissionValidator.dll을 Microsoft GDK(게임 개발 키트)의 \Bin 디렉터리에 넣어 현재 제출 검사기의 이전 버전을 덮어습니다. 인증 도구 페이지에는 현재 릴리스 버전 번호와 날짜도 들어 있습니다. 압축 파일 내에는 알려진 문제와 본 화이트페이퍼의 설명과 다른 제출 유효성 검사 도구의 검사 관련 변경 사항 정보를 포함하여 현재 버전의 릴리스 노트를 담은 텍스트 파일이 있습니다.

앱, 타이틀 또는 콘텐츠 패키지가 Microsoft에 제출되면 현재 버전의 제출 유효성 검사 도구를 사용하여 제출 검사를 실시합니다. 앱, 타이틀 또는 콘텐츠 패키지를 제출하기 전에 제출 패키지를 빌드하는 개발 PC에 현재 버전의 제출 유효성 검사 도구를 보유하는 것을 권장합니다.

제출 유효성 검사 도구 릴리스 정보

제출 유효성 검사 도구의 각 릴리스에서 변경되는 내용에 대한 자세한 내용은 Xbox 개발자 포럼의 제출 유효성 검사 도구 업데이트 피드를 참조하세요.

이 섹션의 내용

제출 유효성 검사 도구 품질 검사
제출 유효성 검사 도구에서 실시하는 품질 검사를 설명합니다.

제출 유효성 검사 도구 메시지 제출 유효성 검사 도구에서 출력하는 메시지(경고, 오류 및 권고)를 설명합니다.

참고 항목

패키지 만들기(makepkg.exe)

타이틀 패키징, 콘텐츠 업데이트, 스트리밍 설치 테스트

Xbox 요구 사항(XR) (Xbox 개발자 다운로드-> 파트너, 게시 및 릴리스 관리 정보->XGD 파트너 설명서)