- Submission Validator 사용
- Submission Validator가 식별하는 문제
- 결과 로그 이해하기
- Submission Validator 업데이트
- Submission Validator 릴리스 노트
Submission Validator 사용
Submission Validator는 개발자가 사용하는 독립 실행형 도구가 아닙니다. 오히려 makepkg pack 명령을 사용할 때 앱을 확인하기 위해 자동으로 호출됩니다. 구문 및 명령줄 사용에 대한 자세한 내용은 makepkg 참조 페이지를 확인하세요. Submission Validator는 타이틀 패키지가 생성된 후에 실행됩니다. 검증 실패는 검증 로그에 기록되며, 이는 makepkg 명령줄에 지정된 출력 위치에 기록됩니다. 이는 완성된 타이틀 패키지가 생성되는 것과 동일한 출력 위치입니다. makepkg에서/validationlanguage 매개변수가 설정된 경우 동일한 위치에서 로컬라이즈된 버전의 출력도 (영어 출력 외에) 사용할 수 있습니다. 현재 추가로 지원되는 검증 언어는 ja-jp입니다.
Submission Validator 테스트의 일부는 makepkg validate 명령줄을 실행하여 타이틀 패키지를 만들기 전에 실행할 수 있습니다. 패키지 생성 전에 문제를 잡기 위해 이를 실행하는 것이 권장됩니다.
Submission Validator가 식별하는 문제
Submission Validator가 식별하는 문제 유형은 제출부터 인증, 시장까지의 과정을 매끄럽게 하기 위해 시간이 지남에 따라 성장하고 발전할 것입니다. Submission Validator가 감지하는 문제의 현재 목록은 Submission Validator 품질 검사를 참조하세요.결과 로그 이해하기
makepkg 프로세스가 완료된 후 타이틀 XVC가 출력 폴더에 나타납니다. 검증 로그는 이 동일한 폴더에 있습니다. 이름 형식이 “Validator_[title and package identifier].xml” 인 것으로 인식할 수 있습니다. 모든 실패 또는 경고에 대해 이 로그를 검토해야 합니다. 이전 섹션에서 이미 표시된 실패 및 경고 외에도, 모든 <failure> 태그는 콘텐츠 수집, 마스터링, 인증 단계의 일부로 제출이 거부되도록 하는 조건을 지정합니다. 이러한 패키지를 제출하는 것을 막지는 않지만, 그렇게 하면 시간과 노력이 낭비됩니다. 로그에 <failure> 태그가 없을 때까지 식별된 문제를 수정하는 것이 훨씬 좋습니다.
로그에서 <warning> 태그도 볼 수 있습니다. 이는 일반적으로 예외가 필요할 수 있는 문제를 나타냅니다. 식별된 경고에 대한 질문이 있으면 개발자 계정 관리자(DAM)에게 문의하세요. 타이틀에 대한 예외가 허용되더라도 <warning> 태그는 여전히 로그 파일에 표시됩니다. 로그 메시지의 전체 목록은 Submission Validator 메시지를 참조하세요.
<validatorrun> 섹션은 다음과 같이 로그의 끝에 있습니다. 이 섹션은 Submission Validator 테스트에 대한 전체 실패 또는 성공을 나타내는 <result> 태그를 포함합니다. 어떤 섹션이든 실패가 있으면 전체 실패가 됩니다.
Submission Validator 업데이트
Submission Validator는 Microsoft Game Development Kit(GDK)의\Bin 디렉터리에서 발견되는 별도의 SubmissionValidator.dll로 구현됩니다. Submission Validator의 업데이트는 Microsoft Game Development Kit(GDK)의 릴리스 주기와 항상 일치하지는 않습니다. Submission Validator의 현재 버전은 항상 developer.microsoft.com/games/resources -> downloads에서 다운로드할 수 있습니다. 압축(.zip) 파일을 다운로드하고 열어서 업데이트된 SubmissionValidator.dll을 Microsoft Game Development Kit(GDK)의 \Bin 디렉터리에 배치하여 이전 버전의 Submission Validator를 덮어씁니다. Certification Tools 페이지에는 현재 릴리스 버전 번호와 날짜도 포함되어 있습니다. 압축 파일 내에는 현재 버전에 대한 릴리스 노트가 포함된 텍스트 파일이 있으며, 여기에는 알려진 문제와 이 문서의 설명과 다른 Submission Validator에서 수행되는 확인에 대한 변경 정보가 포함됩니다.
2025년 10월 GDK부터 makepkg는 SubmissionValidator.dll의 최신 버전을 확인하는 /updatesubval 옵션을 지원합니다. 업데이트가 있으면 옵션은 DLL을 다운로드하여 makepkg.exe가 포함된 디렉터리(기본값은 GDK \Bin 디렉터리)에 설치합니다. /validationpath가 지정된 경우 DLL은 대신 해당 디렉터리에 설치됩니다. 업데이트가 실패하면 현재 설치된 SubmissionValidator.dll 버전으로 패키징이나 검증이 계속됩니다.
2026년 10월 GDK부터 패키지를 만들거나, 검증하거나, 업로드하지 않고 SubmissionValidator.dll을 업데이트하려면 독립 실행형 makepkg updatesubval 명령을 사용하세요. /updatesubval 옵션과 달리 독립 실행형 명령은 업데이트가 실패하면 0이 아닌 종료 코드를 반환합니다.
앱, 타이틀 또는 콘텐츠 패키지가 Microsoft에 제출되면 현재 버전의 Submission Validator를 사용하여 해당 제출을 확인합니다. 앱, 타이틀 또는 콘텐츠 패키지를 제출하기 전에, 제출 패키지가 빌드되는 개발 PC에 최신 버전의 Submission Validator가 있는지 확인하는 것이 권장됩니다.