> ## 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.

# Elemento do MicrosoftGame.config - Executable

> Elemento do MicrosoftGame.config - Executable

# Elemento do MicrosoftGame.config - Executable

Especifica os detalhes de um executável específico. Os atributos desta seção incluem o nome do executável (Name), para qual dispositivo ele foi criado (TargetDeviceFamily), sua ID de aplicativo (Id), se é um executável somente de desenvolvimento (IsDevOnly), se o nome de exibição do nó ShellVisuals deve ser substituído (OverrideDisplayName), se o Logo do nó ShellVisuals deve ser substituído (OverrideLogo), se o Square480x480Logo do nó ShellVisuals deve ser substituído (OverrideSquare480x480Logo), se o Square44x44Logo do nó ShellVisuals deve ser substituído (OverrideSquare44x44Logo), se o SplashScreenImage do nó ShellVisuals deve ser substituído (OverrideSplashScreenImage) e se o executável tem um alias (atualmente somente para Desktop).

## Pai

O pai deste elemento é o elemento ExecutableList.

## Requisito

É obrigatório definir este elemento.

## Plataforma

Este elemento se aplica a PC e console.

## Comportamento

* Os atributos são:
  * Name
  * TargetDeviceFamily
  * Architecture
  * Id
  * IsDevOnly
  * OverrideDisplayName
  * OverrideLogo
  * OverrideSquare480x480Logo
  * OverrideSquare44x44Logo
  * OverrideSplashScreenImage
  * Alias
* Os valores padrão são:
  * O atributo Name não tem valor padrão.
  * O valor padrão do atributo TargetDeviceFamily é o dispositivo em que você está executando o título.
  * O valor padrão de Architecture é x64
  * O atributo Id tem um valor padrão baseado no atributo Name. Se o atributo Name não puder gerar uma Id válida, será usado o fallback Game0.
  * O atributo IsDevOnly tem o valor padrão false.
  * O atributo OverrideDisplayName tem como valor padrão o atributo correspondente em ShellVisuals.
  * O atributo OverrideLogo tem como valor padrão o atributo correspondente em ShellVisuals.
  * O atributo OverrideSquare480x480Logo tem como valor padrão o atributo correspondente em ShellVisuals.
  * O atributo OverrideSquare44x44Logo tem como valor padrão o atributo correspondente em ShellVisuals.
  * O atributo OverrideSplashScreenImage tem como valor padrão o atributo correspondente em ShellVisuals.
  * Alias não tem valor padrão.
* Valores permitidos:
  * O valor permitido de Name é o executável em um caminho relativo à raiz do jogo.
  * Os valores permitidos de TargetDeviceFamily são XboxOne, Scarlett, PC.
  * Os valores permitidos de Architecture são x64 e ARM64
  * O valor permitido de Id é uma cadeia de caracteres ASCII de até 64 caracteres.
  * Os valores permitidos de IsDevOnly são true ou false.
  * O valor permitido de OverrideDisplayName é uma cadeia de caracteres de até 256 caracteres.
  * O valor permitido de OverrideLogo é um caminho de arquivo relativo para um arquivo .png.
  * O valor permitido de OverrideSquare480x480Logo é um caminho de arquivo relativo para um arquivo .png.
  * O valor permitido de OverrideSquare44x44Logo é um caminho de arquivo relativo para um arquivo .png.
  * O valor permitido de OverrideSplashScreenImage é um caminho de arquivo relativo para um arquivo .png.
  * O valor permitido de Alias é um nome de executável (igual a Name, mas não pode ter um caminho).

## Comentários

* O atributo Name é obrigatório.
* O atributo TargetDeviceFamily é obrigatório para o empacotamento.
* Ao incluir um executável com Architecture = ARM64, você também deve incluir um executável com Architecture = x64. Se você não incluir um binário x64, a compilação do pacote falhará com o erro 0x89245212 E\_GAMEPACKAGE\_CONFIG\_x64\_EXECUTABLE\_REQUIRED

### Executable e TargetDeviceFamily

O elemento Executable destina-se a definir atributos para o executável do seu título. Este elemento não se aplica à configuração de pacotes de DLC.

Durante o desenvolvimento, qualquer número de elementos Executable pode ser definido no elemento ExecutableList para implantação de arquivos soltos. Ao empacotar antes do envio final do pacote, há suporte a vários elementos Executable, e qualquer número de elementos Executable com o atributo IsDevOnly será incluído no pacote.

No entanto, durante o envio final do pacote para masterização e certificação, qualquer executável com o atributo IsDevOnly deve ser removido manualmente do arquivo MicrosoftGame.config e do conteúdo do pacote. Antes do GDK de março de 2024, os executáveis isDevOnly eram removidos automaticamente como parte da geração de pacotes criptografados (assinados com [MakePkg.exe pack](/pt-BR/build/core-features/common/packaging/deployment/makepkg) **/lk** ou **/l**). O Submission Validator continuará a emitir uma FALHA se for encontrado um executável isDevOnly.

Ao especificar um elemento Executable no elemento ExecutableList, você pode fornecer um atributo chamado TargetDeviceFamily. Ele se destina a especificar para qual dispositivo de destino o executável foi criado. Os valores permitidos do atributo TargetDeviceFamily são **XBOX One, Scarlett e PC**.

O empacotamento usará como padrão o TargetDeviceFamily XboxOne se nenhum Executable tiver o atributo TargetDevieFamily definido ao executar **MakePkg pack** para consoles XBOX. Ao especificar o sinalizador /pc para **MakePkg pack**, o empacotamento usará como padrão o TargetDeviceFamily PC se nenhum Executable tiver o atributo TargetDeviceFamily definido. O [MakePkg.exe](/pt-BR/build/core-features/common/packaging/deployment/makepkg) **exige que todos os executáveis no MicrosoftGame.config usem a mesma especificação de TargetDeviceFamily** para gerar corretamente um pacote para o seu título. Você receberá o seguinte erro ao tentar executar o [MakePkg.exe](/pt-BR/build/core-features/common/packaging/deployment/makepkg) com dois ou mais atributos TargetDeviceFamily presentes no seu elemento ExecutableList.

      <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

O atributo Alias do elemento Executable pode ser usado para aproveitar a funcionalidade ExecutionAlias para iniciar o seu título de PC a partir do prompt de comando pelo nome do alias e com a identidade do título.

O atributo Alias deve ser definido como o nome do executável para garantir que o título seja registrado e a identidade esteja correta ao usar um alias. Se o alias for usado no diretório atual do executável, o Windows usará diretamente o nome do executável em vez do alias e, portanto, os benefícios do registro e da identidade correta não funcionarão nesse cenário. Se o diretório atual do executável estiver na variável de ambiente %PATH% no PC local, ele também usará o executável em vez do alias.

Ao executar um alias de executável em um prompt de comando, você pode fornecer argumentos do título usando `<ExecutionAlias> [launch args]`.

Para obter mais informações sobre como iniciar o seu título no PC, confira [Utilizar as ferramentas do Microsoft Game Development Kit para instalar e iniciar o seu título de PC](/pt-BR/tools/tools-pc/launching-on-pc).

## Confira também

[Referência do MicrosoftGame.config - Sumário](/pt-BR/reference/system/microsoftgameconfig/elements/gc-microsoftgameconfig-toc)


## Related topics

- [Elemento de MicrosoftGame.config - Executable](/es/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable.md)
- [Elemento de MicrosoftGame.config - ExecutableList](/es/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executablelist.md)
- [Elemento de MicrosoftGame.config - MultiplayerProtocol](/es/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-multiplayerprotocol.md)
- [MicrosoftGame.config Element - Executable](/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable.md)
- [Elemento de MicrosoftGame.config - FileTypeAssociation](/es/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-filetypeassociation.md)
