제출 유효성 검사 도구 품질 검사

아티클
05/10/2023

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

제출 유효성 검사 도구에서는 다음 품질 검사를 실행합니다.

사용 가능한 버전
승인된 게임 OS
콘텐츠의 마지막 청크에 있는 시작 마커 (다운로드 가능한 콘텐츠 (DLC))
추가 Resources.pri 파일
Resources.pri 파일 누락
패키지 당 한 애플리케이션
최대 패키지 크기
외부 파일
이진 스캔
Microsoft(MS) 구성 요소 버전

사용 가능한 버전

제출 유효성 검사 도구 검사를 통해 설치된 버전이 최신 버전이며 올바른 버전인지 확인합니다. 그렇지 않다면 제출 유효성 검사 도구 출력 로그에 오류가 기록됩니다. 이 실패 메시지에는 다음과 같이 올바른 버전을 다운로드할 수 있는 링크가 들어 있습니다.

<component>Available Version Check</component>
<failure>A required update to Submission Validator is available. The latest version can be downloaded from https://go.microsoft.com/fwlink/?LinkId=393356. Download and install the update, then rebuild the package. Contact your 
Developer Account Manager for assistance.</failure>

승인된 게임 OS

제출 유효성 검사 도구는 게임 OS 및 Microsoft GDK(게임 개발 키트)의 모든 선택적 구성 요소가 동일한 릴리스의 Microsoft 게임 개발 키트(GDK)이며 출시된 타이틀에 사용하도록 승인된 버전인지 확인합니다. 버전이 승인되지 않았거나 더 이상 사용되지 않는 버전 목록에 있는 경우 다음과 같이 유효성 검사 도구 로그에 오류가 포함됩니다.

<failure>The GameOS included in this package is not an approved version. Use only 
supported GameOS versions according to the Approved Libraries page on the Developer 
Network Portal</failure>

더 이상 사용되지 않는 버전에 속하는 경우 유효성 검사 도구 로그에 경고가 포함되어 더 이상 사용되지 않는 버전으로 원래 릴리스된 타이틀의 콘텐츠 업데이트에 대해서만 다음과 같이 유효함을 나타냅니다.

<warning>The GameOS included in this package is not approved for new title submissions. 
This version is allowed only for Content Updates where the original release used this 
version. Use only supported GameOS versions according to the Approved Libraries page on 
the Developer Network Portal</warning>

구성 요소의 버전이 서로 일치하지 않거나 버전이 승인된 버전 목록 또는 더 이상 사용되지 않는 버전 목록에 있는 않은 경우 오류가 다음과 같이 기록됩니다.

<failure>The GameOS version does not match the version of other Microsoft components 
included in this package. Use only components from the same Microsoft Game Development Kit (GDK)/Xbox One Software Development Kit release. Refer to the 
Approved Libraries page on the Developer Network Portal</failure>

참고 항목

제출 유효성 검사기가 실행 중인 컴퓨터가 온라인 정보에 액세스할 수 없다면(예컨대 PC가 인터넷에 연결되어 있지 않거나 방화벽으로 차단되거나 네트워크 연결이 전혀 없는 경우) 유효성 검사를 완료하지 못할 수도 있습니다.

콘텐츠의 마지막 청크에 있는 시작 마커 (다운로드 가능한 콘텐츠 (DLC))

모든 시나리오에서 적절히 작동하도록 콘텐츠 패키지는 최종 청크에 런치 마커 특성을 표시해야 합니다. 최종 청크에 런치 마커가 포함되지 않은 경우 패키지를 올바르게 테스트할 수는 있지만 경우에 따라 최종 사용자에게 문제가 발생할 수 있습니다. 실패 메시지는 다음과 같이 표시됩니다.

<failure>Content Packages require final layout chunk to include attribute marker="Launch"</failure>

추가 Resources.pri 파일

제출 검사기는 레이아웃의 다른 디렉터리에 추가 Resources.pri 파일이 없는지 검사합니다. MicrosoftGame.config와 마찬가지로 루트에 있는 것만 사용됩니다. 그러나 여러 복사본이 있는 경우 무엇이 올바른지, 이 다른 파일에 관한 개발자의 의도가 무엇인지 혼란이 일어날 수도 있습니다.

이는 MicrosoftGame.config의 추가 복사본에 대한 유사성 검사와 비슷하며, 이 경우 추가 복사본은 로그의 외부 파일 검사 섹션에서 다음과 같이 오류로 기록될 수도 있습니다.

<failure>D:\path\mytitle\mytitlesubdirectory\resources.pri</failure>

Resources.pri 파일 누락

애플리케이션은 지역화할 필요가 없지만 애플리케이션의 루트(MicrosoftGame.config와 같은 위치)에 Resources.pri 파일이 들어 있지 않다면 출력 로그의 외부 파일 검사 섹션에 이 경고가 표시됩니다.

<warning>Non-localized app: 'resources.pri' is missing</warning>

패키지 당 한 애플리케이션

제출 유효성 검사 도구에서 이제 패키지에 패키지당 단 하나의 DevOnly가 아닌 애플리케이션을 포함하는지 검사합니다.

최대 패키지 크기

제출 유효성 검사 도구에서 패키지가 49,900,000,000바이트의 최대 패키지 크기를 초과하지 않는지 확인합니다. 이는 정보 제공 메시지일 뿐이며 실패가 아닙니다.

외부 파일

Xbox 360 프로그램 검토 제출 시 발생하는 문제 중 하나는 보통 우발적으로 소매 타이틀에 속해서는 안되는 다양한 파일이 제출에 포함되는 것이었습니다.

외부 파일 검사에서는 레이아웃 XML 파일을 사용하여 타이틀 패키지의 모든 파일에서 패키지에 허용되지 않는 특정 파일 이름 또는 확장명이 있는지 검사합니다. 이 검사는 파일의 내용이 아닌 파일 이름만을 기준으로 합니다. 허용되지 않은 파일에는 소스 및 디버그 파일 관련 확장명, Thumb.db, 루트에 있는 파일을 제외한 관련 없는 등록 파일, 그리고 타이틀 패키지에 나타날 수 없는 Xbox 운영 체제 시스템 파일의 전체 목록이 있습니다. 이 검사는 Xbox의 요구 사항 XR-003: 제출을 위한 타이틀 품질의 유효성을 검사하는 데 사용됩니다.

다음 표에서는 제출된 타이틀 패키지에서 허용되지 않는 파일 형식과 확장명을 보여줍니다.

파일 형식	확장명
소스 코드–관련 파일	.c .cpp, .cs, .lib, .h, .obj
디버그/기호 정보 파일	.pdb, .sym
레거시 이진 파일	.xbe

Microsoft에서는 타이틀에서 합법적으로 대부분의 상상할 수 있는 파일 확장명을 사용할 수 있음과 이로 인해 확장자 검사 시 잠재적 문제로 이어질 수 있음을 인식합니다. 타이틀에서 이것이 불가능하면 개발자 계정 관리자(DAM)에게 문의하세요.

제출 유효성 검사기 로그에 "실패" 메시지가 표시되는 타이틀 패키지에 파일을 포함해야 하는 예외적인 경우가 발생한 것으로 판단 시 DAM에게 문의해야 합니다.

다음 예제에서는 외부 파일 검사의 오류를 보여주는 로그 출력을 보여줍니다.

<component>Foreign File Check</component>
<failures>
  <failure>c:\MyTitle\loose\bar.cpp</failure>
  <failure>c:\MyTitle\loose\MySubDir\example.h</failure>
  <failure>c:\MyTitle\loose\MySubDir\PDBs\BlockedFiles\foo.pdb</failure>
</failures>
<filecount>3</filecount>

이진 스캔

Xbox 본체 이진(.exe와 .dll) 파일은 AMD64용으로 빌드되고 네이티브 코드여야만 합니다. 현재 관리되는 코드 이진은 플랫폼에서 지원되지 않습니다. 이진 스캔 검사는 타이틀 패키지에 포함되는 .exe와 .dll 파일을 각각 검사하여 이러한 요건을 충족하는지 확인합니다. 이 검사는 XR-003: 제출을 위한 타이틀 품질의 유효성을 검사하는 데 사용됩니다.

이진 검사 섹션에서는 각 .exe와 .dll 파일의 종속성이 검사되어 소매 본체에서 보안상의 이유로 차단되는지 검사됩니다. 일반적으로 이는 플랫폼 파일의 디버그 버전 링크인 PIXEvt.dll 또는 Xbox Studio 형태를 갖습니다.

다음 예제에서는 이진 스캔 검사의 오류를 보여주는 로그 출력을 보여줍니다. 처음 두 오류는 소매 본체에서 허용되지 않는 두 파일과 연결된 .exe 파일의 결과입니다. 세 번째 오류는 관리되는 .exe 파일입니다. 마지막 오류는 비 AMD64 네이티브 코드 .dll 파일입니다.

<component>Binary Scan</component>
      <dumpbinlocation>C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\bin\amd64\dumpbin.exe</dumpbinlocation>
      <failures>
   <failure>Non-retail dependency in file c:\MyTitle\loose\ExeWithDebugDependencies.exe: MSVCR110D.dll</failure>
  <failure>Non-retail dependency in file c:\MyTitle\loose\ExeWithDebugDependencies.exe: PIXEvt.dll</failure>
  </failures>
  <failure>Managed: Not AMD64: c:\MyTitle\loose\MySubDir\ABC.exe</failure>
  <failure>Not AMD64: c:\MyTitle\loose\MySubDir\XYZ.dll</failure>
</failures>

개발자는 이러한 디버깅 중심 종속성이 이진의 릴리스 빌드에서 제외되어 제출 패키지에 포함되도록해야합니다.

Microsoft(MS) 구성 요소 버전

Xbox를 사용하는 경우 많은 플랫폼 표면 영역이 게임 OS에 포함되었습니다. 하지만 타이틀과 재배포되는 Microsoft 제공 이진 집합이 있습니다. 이러한 파일과 승인된 버전은 XGD(Xbox Game Developer) 사이트의 승인된 라이브러리 페이지에 나열되어 있습니다.

제출 유효성 검사 도구에서는 이러한 파일의 버전을 검사하여 선택적 .dll 파일의 버전이 일치하는지 확인합니다. 또한 독점 파티션 타이틀에 대한 XVC에 패키징되는 게임 OS의 버전 ID도 캡처합니다. 개발자가 제출 전에 퍼블리싱된 승인 라이브러리 정보에 맞춰 버전을 확인해야 합니다.

제출 유효성 검사 도구에는 또한 타이틀에서 포함된 경우 Kinect 및 Xbox 서비스 .dll에 대한 버전 정보를 추출합니다.

다음 예제는 제출 유효성 검사 도구 로그 파일에 표시되는 버전 정보를 보여줍니다.

<component>MS Component Versions</component>
<component name="GameOS">60BBA05C-22F0-4452-84B6-DD278594716E</component>
<component name="Microsoft.Xbox.Services.dll">10.0.18362.7198</component>