MicrosoftGame.config 요소 - 실행 파일
특정 실행 파일의 세부 정보를 지정합니다. 이 섹션 특성에는 실행 파일의 이름(Name), 빌드된 장치(TargetDeviceFamily), 애플리케이션 ID(Id), 개발용 실행 파일인지 여부(IsDevOnly), ShellVisuals 노드로부터의 디스플레이 이름을 재정의해야 하는지 여부(OverrideDisplayName), ShellVisuals 노드로부터의 Logo를 재정의해야 하는지 여부(OverrideLogo), ShellVisuals 노드로부터의 Square480x480Logo를 재정의해야 하는지 여부(OverrideSquare480x480Logo), ShellVisuals 노드로부터의 Square44x44Logo를 재정의해야 하는지 여부(OverrideSquare44x44Logo), ShellVisuals 노드로부터의 SplashScreenImage를 재정의해야 하는지 여부(OverrideSplashScreenImage), 실행 파일에 별칭이 있는지 여부(Alias, 현재 데스크톱에만 해당)가 포함됩니다.
상위 항목
이 요소의 상위 항목은 ExecutableList 요소입니다.
요구 사항
이 요소를 설정해야 합니다.
플랫폼
이 요소는 PC 및 콘솔에 적용됩니다.
동작
- 특성은 다음과 같습니다.
- Name
- TargetDeviceFamily
- ID
- IsDevOnly
- OverrideDisplayName
- OverrideLogo
- OverrideSquare480x480Logo
- OverrideSquare44x44Logo
- OverrideSplashScreenImage
- Alias
- 기본값은 다음과 같습니다.
- 이름 속성에 기본값이 없습니다.
- TargetDeviceFamily 속성 기본값은 타이틀을 실행 중인 모든 장치입니다.
- Id 속성에는 Name 속성에 기반한 기본값이 있습니다. 이름 속성이 유효한 ID를 생성할 수 없는 경우 Game0의 대체가 사용됩니다.
- IsDevOnly 속성의 기본값은 false입니다.
- OverrideDisplayName 특성에는 ShellVisuals에서 해당 특성의 기본값이 있습니다.
- OverrideLogo 특성에는 ShellVisuals에서 해당 특성의 기본값이 있습니다.
- OverrideSquare480x480Logo 속성에는 ShellVisuals에서 해당 속성의 기본값이 있습니다.
- OverrideSquare44x44Logo 속성에는 ShellVisuals에서 해당 속성의 기본값이 있습니다.
- OverrideSplashScreenImage 특성에는 ShellVisuals에서 해당 특성의 기본값이 있습니다.
- 별칭에는 기본값이 없습니다.
- 허용되는 값:
- 이름 허용 값은 게임 루트의 상대 경로에 있는 실행 파일입니다.
- TargetDeviceFamily 허용 값은 XboxOne, Scarlett 및 PC입니다.
- ID 허용 값은 최대 64자의 ASCII 문자열입니다.
- IsDevOnly 허용 값은 true 또는 false입니다.
- OverrideDisplayName 허용 값은 최대 256자의 문자열입니다.
- OverrideLogo 허용 값은 .png 파일에 대한 상대 파일 경로입니다.
- OverrideSquare480x480Logo 허용 값은 .png 파일에 대한 상대 파일 경로입니다.
- OverrideSquare44x44Logo 허용 값은 .png 파일에 대한 상대 파일 경로입니다.
- OverrideSplashScreenImage 허용 값은 .png 파일에 대한 상대 파일 경로입니다.
- 별칭 허용 값은 실행 가능한 이름입니다(이름과 동일하지만 경로를 가질 수 없음).
비고
- Name 특성이 필요합니다.
- TargetDeviceFamily 특성은 패키징에 필요합니다.
Executable 및 TargetDeviceFamily
Executable 요소는 타이틀 실행 파일에 대한 특성을 설정합니다. 이 요소는 DLC 패키지 구성에 적용되지 않습니다.
개발 도중 여러 개의 Executable 요소가 루스 파일 배포에 대한 ExecutableList 요소에서 유효한 것으로 정의됩니다. 최종 패키지 제출 전에 패키징할 경우 여러 Executable 요소가 지원되고 IsDevOnly 특성이 있는 Executable 요소가 그 개수에 상관없이 패키지에 포함됩니다.
그렇지만 마스터링 및 인증을 위한 최종 패키지 제출 과정에서 IsDevOnly 특성이 있는 모든 Executable을 MicrosoftGame.config 파일 및 패키지 콘텐츠에서 수동으로 제거해야 합니다. 2024년 3월 GDK 이전에는 isDevOnly Executable이 암호화된 패키지 생성(MakePkg.exe pack/lk 또는 /l(으)로 서명됨)의 일환으로 자동으로 제거되었습니다. isDevOnly Executable이 있는 경우 제출 유효성 검사기는 계속해서 실패를 표시합니다.
ExecutableList 요소에서 Executable 요소를 지정할 때 TargetDeviceFamily라는 특성을 제공할 수 있습니다. 이는 빌드된 실행 파일의 대상 장치를 지정합니다. TargetDeviceFamily 특성에서 허용되는 값은 Xbox One, Scarlett 및 PC입니다.
Xbox 본체에 대해 MakePkg pack 실행 시 Executable에서 TargetDevieFamily 특성이 정의되지 않은 경우 패키징 시 XboxOne TargetDeviceFamily가 기본값으로 설정됩니다. MakePkg pack에 /pc 플래그를 지정할 때 Executable에서 TargetDeviceFamily 특성이 정의되지 않은 경우 패키징 시 PC TargetDeviceFamily가 기본값으로 설정됩니다. MakePkg.exe의 경우 MicrosoftGame.config의 모든 실행 파일에서 동일한 TargetDeviceFamily 사양을 사용하여 타이틀에 대해 적절한 패키지를 생성해야 합니다. ExecutableList 요소에 2개 이상의 TargetDeviceFamily 특성이 있는 상태에서 MakePkg.exe를 실행하려 하면 다음 오류가 발생합니다.
오류: 패키지 빌드 시 모든 실행 파일에 MicrosoftGame.config 파일의 TargetDeviceFamily 값과 똑같은 값이 있어야 합니다. (XboxOne 및 Scarlett에서 발견)
ExecutionAlias
Executable 요소의 Alias 속성은 별칭 이름 및 제목 ID로 명령 프롬프트에서 PC 제목을 시작하는 ExecutionAlias 기능의 이점을 얻는 데 사용할 수 있습니다.
별칭을 사용할 때 제목이 등록되고 ID가 올바른지 확인하려면 별칭 속성을 실행 파일 이름으로 설정해야 합니다. 별칭이 실행 파일의 현재 디렉터리에서 사용되는 경우 Windows는 별칭 대신 실행 파일 이름을 직접 연기하므로 이 시나리오에서는 등록 및 적절한 ID의 이점이 작동하지 않습니다. 실행 파일의 현재 디렉터리가 로컬 PC의 % PATH % 환경 변수에 있는 경우 별칭 대신 실행 파일을 따릅니다.
명령 프롬프트에서 실행 가능한 별칭을 실행할 때 <ExecutionAlias> [launch args] 사용량을 통해 타이틀 인수를 제공할 수 있습니다.
PC에서 타이틀을 시작하는 방법에 대한 자세한 내용은 Microsoft 게임 개발 키트 도구를 활용하여 PC 타이틀을 설치 및 시작을 참조하세요.