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 /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 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 com dois ou mais atributos TargetDeviceFamily presentes no seu elemento ExecutableList. Error: All executables must have the same value for TargetDeviceFamily in the MicrosoftGame.config file when building a package. (found XboxOne and Scarlett)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.