Skip to main content
Os tipos de problemas que o Submission Validator identifica crescem e evoluem ao longo do tempo. O objetivo é facilitar o caminho desde o envio, passando pela certificação, até o mercado. O Submission Validator executa as seguintes verificações de qualidade:

Versão disponível

O Submission Validator verifica se a versão instalada é a versão mais atual e correta. Se não for, o log de saída do Submission Validator mostrará uma falha. A mensagem de falha, mostrada na seção a seguir, contém um link para baixar a versão correta.

Versão do GDK aprovada

Quando você cria um pacote do GDK para PC (msixvc), o Submission Validator verifica se o GDK usado para empacotar é de uma versão do GDK aprovada. Se a versão não estiver na lista de aprovadas ou preteridas, o log do validador mostrará uma falha.
Se a versão estiver na lista de preteridas, o log do validador mostrará uma mensagem informativa. Essa mensagem indica que a versão expirou e não receberá mais hotfixes.
Se o Submission Validator não conseguir determinar a versão do GDK a partir dos arquivos incluídos no pacote (por exemplo, porque os arquivos estão criptografados), ele exibirá a mensagem a seguir.

Como a versão do GDK é inserida nos executáveis do jogo

Quando você compila um executável de jogo usando um GDK que inclui XGameRuntime.h, o compilador insere a versão do GDK em uma seção PE personalizada chamada .xbld. O Submission Validator lê essa seção para determinar qual versão do GDK foi usada para compilar os binários do título. Se a seção .xbld estiver ausente ou ilegível, o Submission Validator usará como alternativa a versão das ferramentas de empacotamento como a versão do GDK para o envio. Essa versão pode não representar com precisão a versão do GDK usada para compilar seus binários. Causa comum: software antiadulteração Ferramentas antiadulteração e de criptografia de dados que processam seu executável podem criptografar ou remover a seção .xbld. Essa ação torna a seção ilegível para o Submission Validator. Para resolver esse problema, configure sua ferramenta antiadulteração para excluir a seção .xbld do processamento.

Themida

Adicione a seguinte Advanced Option (separada por vírgulas) ao arquivo de configuração do Themida para excluir a seção .xbld da proteção:

GuardIT

Para excluir a seção .xbld da criptografia de dados no GuardIT, adicione uma entrada <exclude> à configuração do guard de criptografia:
A seção <exclude> impede que .xbld seja criptografada.

Game OS aprovado

O Submission Validator verifica se o Game OS e quaisquer componentes opcionais do Microsoft Game Development Kit (GDK) são da mesma versão do Microsoft Game Development Kit (GDK) e se são uma versão aprovada para uso em títulos lançados. Se a versão não estiver na lista de aprovadas ou preteridas, o log do validador incluirá uma falha, conforme mostrado na seção a seguir.
Se as versões dos componentes não corresponderem entre si ou se a versão não estiver nas listas de aprovadas ou preteridas, o log do validador incluirá uma falha, conforme mostrado na seção a seguir.
O Submission Validator pode não concluir suas verificações de validação se o PC de desenvolvimento no qual está sendo executado não puder acessar informações online. Por exemplo, se não tiver acesso à Internet, estiver bloqueado por um firewall ou não tiver conectividade de rede.

Marcador de inicialização no bloco final para conteúdo (conteúdo para download (DLC))

Para garantir a operação adequada em todos os cenários, os pacotes de conteúdo devem marcar o bloco final com o atributo de marcador de inicialização. Se o bloco final não incluir o marcador de inicialização, é possível que o pacote seja testado corretamente, mas cause problemas para os usuários finais em alguns casos. A mensagem de falha é mostrada a seguir.

Arquivos Resources.pri adicionais

O Submission Validator verifica se não existem arquivos Resources.pri adicionais em outros diretórios do layout. Assim como acontece com o MicrosoftGame.config, somente o que está na raiz é usado. No entanto, ter várias cópias pode gerar confusão sobre qual delas é a correta e qual é a intenção dos desenvolvedores em relação a esses outros arquivos. Essa verificação é paralela a uma verificação semelhante para cópias adicionais do MicrosoftGame.config. Nesse caso, cópias adicionais resultam em uma falha na seção Foreign Files Check do log, mostrada a seguir.

Arquivo Resources.pri ausente

Os aplicativos não precisam ser localizados. No entanto, se um aplicativo não incluir um arquivo Resources.pri na raiz (no mesmo local que o MicrosoftGame.config), o aviso a seguir aparecerá na seção Foreign Files Check do log de saída.

Um aplicativo por pacote

O Submission Validator agora valida se os pacotes contêm apenas um aplicativo não DevOnly por pacote.

Tamanho máximo do pacote

Quando você distribui em disco, o Submission Validator verifica se o tamanho do pacote não excede 49.900.000.000 bytes. Essa verificação fornece apenas uma mensagem informativa, não um erro. Quando você não distribui em disco, o Submission Validator verifica se o tamanho do pacote não excede 500 GB. Ele também fornece uma mensagem de aviso quando o tamanho do pacote é superior a 450 GB. As mensagens são as seguintes:

Arquivo estranho

Um problema encontrado ao revisar envios para o programa XBOX 360 é a inclusão de vários arquivos no envio, geralmente por acidente, que não deveriam fazer parte de um título de varejo. O Foreign File Check usa o arquivo .xml de layout para verificar todos os arquivos trazidos para o pacote do título em busca de nomes de arquivo e extensões específicos que não são permitidos no pacote. Essa verificação se baseia apenas nos nomes dos arquivos, não no conteúdo dos arquivos. Os arquivos não permitidos incluem extensões relacionadas a arquivos de origem e de depuração, Thumb.db, arquivos de registro excedentes além dos que estão na raiz e a lista completa de arquivos do sistema operacional do XBOX que não podem aparecer em pacotes de títulos. Essa verificação valida o Requisito do XBOX XR-003: Title Quality for Submission. A tabela a seguir mostra os tipos de arquivo e as extensões que não são permitidos no pacote do título enviado. Um título pode usar legitimamente quase qualquer extensão de arquivo imaginável, o que pode gerar possíveis conflitos com as verificações de extensões. Se essa situação afetar seu título, avise seu gerente de desenvolvimento de parceiros (PDM). Se você achar que tem um caso excepcional que exige que um arquivo seja incluído no pacote do título e para o qual está recebendo uma mensagem de falha no log do Submission Validator, consulte seu PDM. O exemplo a seguir mostra a saída do log que relata falhas no Foreign File Check.

Verificação de binários

Os arquivos binários do console XBOX (.exe e .dll) devem ser compilados para AMD64 e conter somente código nativo. Atualmente, a plataforma não dá suporte a binários de código gerenciado. O Binary Scan Check examina cada arquivo .exe e .dll que você inclui no pacote do título e garante que ele atenda a esses requisitos. Use essa verificação para validar o XR-003: Title Quality for Submission. Na seção Binary Scan, cada arquivo .exe e .dll é verificado em busca de dependências bloqueadas por motivos de segurança em consoles de varejo. Geralmente, esse bloqueio assume a forma de vinculação a uma versão de depuração de um arquivo da plataforma, PIXEvt.dll ou XBOX Studio. O exemplo a seguir mostra a saída do log que relata falhas no Binary Scan Check. As duas primeiras falhas resultam de um arquivo .exe vinculado a dois arquivos que não são permitidos em consoles de varejo. A terceira falha é um arquivo .exe gerenciado. A falha final é um arquivo .dll de código nativo que não é AMD64.
Os desenvolvedores devem garantir que essas dependências voltadas para depuração sejam excluídas das compilações de versão dos binários a serem incluídos em um pacote de envio.

Versões de componentes da Microsoft

O Game OS abrange grande parte da área de superfície da plataforma do XBOX. No entanto, os títulos redistribuem um conjunto de binários fornecidos pela Microsoft. A página Approved Libraries no site dos Fóruns de Desenvolvedores do XBOX lista esses arquivos e suas versões aprovadas. O Submission Validator verifica as versões desses arquivos para garantir que quaisquer arquivos DLL opcionais tenham versões correspondentes. Ele também captura a Version ID do Game OS que o título da partição exclusiva empacota no XVC. Verifique as versões em relação às informações publicadas sobre bibliotecas aprovadas antes de enviar. O Submission Validator também extrai as informações de versão dos arquivos DLL opcionais do Kinect e dos XBOX Services, se o seu título os incluir. O exemplo a seguir mostra as informações de versão que aparecem no arquivo de log do Submission Validator.

Arquivos dependentes ausentes

Quando você vincula dinamicamente bibliotecas dependentes, se essas bibliotecas estiverem ausentes, o Submission Validator incluirá a seguinte falha:

Binários ARM64

Você pode incluir binários ARM64 no pacote do seu jogo para PC junto com seus executáveis x64 compilados existentes. O Submission Validator verifica se o MicrosoftGame.config está referenciando corretamente o executável apropriado.

Confira também

Submission Validator (SubmissionValidator.dll) Mensagens do Submission Validator Criar pacote (makepkg.exe) Empacotamento de títulos, atualizações de conteúdo e testes de instalação por streaming Requisitos do XBOX (XRs) (XBOX Developer Downloads->Partner, Publishing, and Release Management Information->XGD Partner Documentation)
Last modified on October 6, 2026