> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MicrosoftGame.config 요소 - Executable

> MicrosoftGame.config 요소 - Executable

# MicrosoftGame.config 요소 - Executable

특정 실행 파일의 세부 정보를 지정합니다. 이 섹션의 특성에는 실행 파일의 이름(Name), 어떤 디바이스용으로 빌드되었는지(TargetDeviceFamily), 애플리케이션 ID(Id), 개발 전용 실행 파일인지(IsDevOnly), ShellVisuals 노드의 표시 이름을 재정의할지(OverrideDisplayName), ShellVisuals 노드의 로고를 재정의할지(OverrideLogo), ShellVisuals 노드의 Square480x480Logo를 재정의할지(OverrideSquare480x480Logo), ShellVisuals 노드의 Square44x44Logo를 재정의할지(OverrideSquare44x44Logo), ShellVisuals 노드의 SplashScreenImage를 재정의할지(OverrideSplashScreenImage), 그리고 실행 파일에 별칭이 있는지(현재 데스크톱 전용) 여부가 포함됩니다.

## 상위 요소

이 요소의 상위는 ExecutableList 요소입니다.

## 요구 사항

이 요소는 필수로 설정해야 합니다.

## 플랫폼

이 요소는 PC와 콘솔에 해당됩니다.

## 동작

* 특성:
  * Name
  * TargetDeviceFamily
  * Architecture
  * Id
  * IsDevOnly
  * OverrideDisplayName
  * OverrideLogo
  * OverrideSquare480x480Logo
  * OverrideSquare44x44Logo
  * OverrideSplashScreenImage
  * Alias
* 기본값:
  * Name 특성에는 기본값이 없습니다.
  * TargetDeviceFamily 특성의 기본값은 타이틀을 실행 중인 디바이스입니다.
  * Architecture 기본값은 x64입니다.
  * Id 특성의 기본값은 Name 특성을 기반으로 합니다. Name 특성이 유효한 Id를 생성할 수 없는 경우 Game0이 대체 값으로 사용됩니다.
  * IsDevOnly 특성의 기본값은 false입니다.
  * OverrideDisplayName 특성의 기본값은 ShellVisuals의 해당 특성입니다.
  * OverrideLogo 특성의 기본값은 ShellVisuals의 해당 특성입니다.
  * OverrideSquare480x480Logo 특성의 기본값은 ShellVisuals의 해당 특성입니다.
  * OverrideSquare44x44Logo 특성의 기본값은 ShellVisuals의 해당 특성입니다.
  * OverrideSplashScreenImage 특성의 기본값은 ShellVisuals의 해당 특성입니다.
  * Alias에는 기본값이 없습니다.
* 허용되는 값:
  * Name의 허용되는 값은 게임 루트에서의 상대 경로에 있는 실행 파일입니다.
  * TargetDeviceFamily의 허용되는 값은 XboxOne, Scarlett, PC입니다.
  * Architecture의 허용되는 값은 x64와 ARM64입니다.
  * Id의 허용되는 값은 최대 64자의 ASCII 문자열입니다.
  * IsDevOnly의 허용되는 값은 true 또는 false입니다.
  * OverrideDisplayName의 허용되는 값은 최대 256자의 문자열입니다.
  * OverrideLogo의 허용되는 값은 .png 파일에 대한 상대 파일 경로입니다.
  * OverrideSquare480x480Logo의 허용되는 값은 .png 파일에 대한 상대 파일 경로입니다.
  * OverrideSquare44x44Logo의 허용되는 값은 .png 파일에 대한 상대 파일 경로입니다.
  * OverrideSplashScreenImage의 허용되는 값은 .png 파일에 대한 상대 파일 경로입니다.
  * Alias의 허용되는 값은 실행 파일 이름입니다(Name과 동일하지만 경로를 포함할 수 없음).

## 설명

* Name 특성은 필수입니다.
* TargetDeviceFamily 특성은 패키징에 필수입니다.
* Architecture = ARM64인 실행 파일을 포함하는 경우, Architecture = x64인 실행 파일도 함께 포함해야 합니다. x64 바이너리를 포함하지 않으면 오류 0x89245212 E\_GAMEPACKAGE\_CONFIG\_x64\_EXECUTABLE\_REQUIRED와 함께 패키지 빌드에 실패합니다.

### Executable 및 TargetDeviceFamily

Executable 요소는 타이틀 실행 파일에 대한 특성을 설정하기 위한 것입니다. 이 요소는 DLC 패키지 구성에는 적용되지 않습니다.

개발 중에는 느슨한 파일 배포를 위해 ExecutableList 요소 내에 임의 개수의 Executable 요소를 정의할 수 있습니다. 최종 패키지 제출 전에 패키징할 때는 여러 Executable 요소가 지원되며, IsDevOnly 특성을 가진 임의 개수의 executable 요소가 패키지에 포함됩니다.

그러나 마스터링 및 인증을 위한 최종 패키지 제출 시, IsDevOnly 특성이 있는 모든 실행 파일은 MicrosoftGame.config 파일과 패키지 콘텐츠에서 수동으로 제거해야 합니다. 2024년 3월 GDK 이전에는 isDevOnly 실행 파일이 암호화된 패키지 생성([MakePkg.exe pack](/build/core-features/common/packaging/deployment/makepkg) **/lk** 또는 **/l**로 서명됨)의 일환으로 자동 제거되었습니다. 제출 유효성 검사기는 isDevOnly 실행 파일이 발견되면 계속 FAILURE를 발생시킵니다.

ExecutableList 요소에 Executable 요소를 지정할 때 TargetDeviceFamily라는 특성을 제공할 수 있습니다. 이는 실행 파일이 어떤 대상 디바이스용으로 빌드되었는지를 지정하기 위한 것입니다. TargetDeviceFamily 특성의 허용 값은 **XBOX One, Scarlett & PC**입니다.

XBOX 콘솔용 **MakePkg pack** 실행 시 어떤 Executable에도 TargetDevieFamily 특성이 정의되어 있지 않으면 패키징은 기본적으로 XboxOne TargetDeviceFamily로 설정됩니다. **MakePkg pack**에 /pc 플래그를 지정하는 경우, 어떤 Executable에도 TargetDeviceFamily 특성이 정의되어 있지 않으면 패키징은 기본적으로 PC TargetDeviceFamily로 설정됩니다. [MakePkg.exe](/build/core-features/common/packaging/deployment/makepkg)는 타이틀 패키지를 올바르게 생성하기 위해 **MicrosoftGame.config의 모든 실행 파일이 동일한 TargetDeviceFamily 사양을 사용해야 합니다**. ExecutableList 요소에 두 개 이상의 TargetDeviceFamily 특성이 있을 때 [MakePkg.exe](/build/core-features/common/packaging/deployment/makepkg)를 실행하려고 하면 다음과 같은 오류가 발생합니다.

      <span>Error: All executables must have the same value for TargetDeviceFamily in the MicrosoftGame.config file when building a package. (found XboxOne and Scarlett)</span>

<a id="MicrosoftGameConfig-Alias" />

#### ExecutionAlias

Executable 요소의 Alias 특성을 사용하면 PC 타이틀을 별칭 이름과 타이틀 ID로 명령 프롬프트에서 실행하기 위해 ExecutionAlias 기능의 이점을 활용할 수 있습니다.

별칭을 사용할 때 타이틀이 등록되고 ID가 올바르도록 하려면 Alias 특성을 실행 파일 이름으로 설정해야 합니다. 별칭이 실행 파일의 현재 디렉터리에서 사용되는 경우, Windows는 별칭 대신 실행 파일 이름을 직접 참조하며 이 경우 등록 및 올바른 ID의 이점이 작동하지 않습니다. 실행 파일의 현재 디렉터리가 로컬 PC의 %PATH% 환경 변수에 있는 경우에도 별칭 대신 실행 파일을 참조합니다.

명령 프롬프트에서 실행 파일 별칭을 실행할 때 `<ExecutionAlias> [launch args]` 사용법을 통해 타이틀 인수를 제공할 수 있습니다.

PC에서 타이틀 실행에 대한 자세한 내용은 [Microsoft Game Development Kit 도구를 활용하여 PC 타이틀 설치 및 실행](/tools/tools-pc/launching-on-pc)을 참조하세요.

## 함께 보기

[MicrosoftGame.config 참조 - 목차](/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)


## Related topics

- [MicrosoftGame.config 요소 - ExecutableList](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executablelist.md)
- [MicrosoftGame.config 요소 - FileTypeAssociation](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-filetypeassociation.md)
- [MicrosoftGame.config Element - MultiplayerProtocol](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-multiplayerprotocol.md)
- [MicrosoftGame.config Element - ShellVisuals](/ko/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-shellvisuals.md)
- [MicrosoftGame.config 참조](/ko/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc.md)