- Usando o Submission Validator
- Problemas identificados pelo Submission Validator
- Noções básicas sobre o log de resultados
- Atualizando o Submission Validator
- Notas de versão do Submission Validator
Usando o Submission Validator
O Submission Validator não é uma ferramenta autônoma que o desenvolvedor usa. Em vez disso, ele é chamado automaticamente para verificar um aplicativo quando o comando makepkg pack é usado. Para obter mais informações sobre a sintaxe e o uso da linha de comando, consulte a página de referência do makepkg. O Submission Validator é executado depois que o pacote do título é criado. As falhas de validação são registradas no log de validação, que é gravado no local de saída especificado na linha de comando do makepkg. Esse é o mesmo local de saída em que o pacote do título concluído é criado. Uma versão localizada da saída também fica disponível (além da saída em inglês) no mesmo local se o parâmetro/validationlanguage for definido no makepkg. O idioma de validação adicional com suporte atualmente é ja-jp.
Um subconjunto dos testes do Submission Validator pode ser executado antes da criação do pacote do título executando a linha de comando makepkg validate. Recomendamos executá-lo para detectar problemas antes da criação do pacote.
Problemas identificados pelo Submission Validator
Os tipos de problemas que o Submission Validator identifica crescerão e evoluirão ao longo do tempo para atingir o objetivo de facilitar o caminho desde o envio, passando pela certificação, até o mercado. Para obter a lista atual de problemas que o Submission Validator detecta, consulte Verificações de qualidade do Submission Validator.Noções básicas sobre o log de resultados
Após a conclusão do processomakepkg, o XVC do título aparece na pasta de saída. O log de validação está nessa mesma pasta. Você pode reconhecê-lo pelo nome no formato “Validator_[identificador do título e do pacote].xml.” Você deve examinar esse log em busca de falhas ou avisos. Além das falhas e avisos já mostrados nas seções anteriores, qualquer marca <failure> designa uma condição que fará com que seu envio seja rejeitado como parte da fase de ingestão de conteúdo, masterização e certificação. Embora nada impeça você de enviar esse pacote, fazer isso causará desperdício de tempo e esforço. É muito melhor corrigir os problemas identificados até que o log não contenha nenhuma marca <failure>.
Você também pode ver marcas <warning> no log. Geralmente, elas indicam problemas que podem exigir uma exceção. Se você tiver dúvidas sobre quaisquer avisos identificados, entre em contato com seu gerente de conta de desenvolvedor (DAM). Mesmo que uma exceção seja concedida para o seu título, a marca <warning> ainda aparecerá no arquivo de log. Para obter uma lista completa de mensagens de log, consulte Mensagens do Submission Validator.
A seção <validatorrun> fica no final do log, conforme mostrado a seguir. Essa seção contém uma marca <result> que indica o resultado geral Fail ou Success dos testes do Submission Validator. Qualquer falha em qualquer seção resulta em uma falha geral.
Atualizando o Submission Validator
O Submission Validator é implementado como um SubmissionValidator.dll separado, encontrado no diretório\Bin do Microsoft Game Development Kit (GDK). As atualizações do Submission Validator nem sempre corresponderão ao ciclo de lançamento do Microsoft Game Development Kit (GDK). A versão atual do Submission Validator está sempre disponível para download em developer.microsoft.com/games/resources -> downloads. Baixe o arquivo compactado (.zip), abra-o e coloque o SubmissionValidator.dll atualizado no diretório \Bin do Microsoft Game Development Kit (GDK), substituindo a versão anterior do Submission Validator. A página Certification Tools também inclui o número e a data da versão atual. Dentro do arquivo compactado, há um arquivo de texto com as notas de versão da versão atual, incluindo problemas conhecidos e informações sobre alterações nas verificações realizadas pelo Submission Validator que diferem das descrições neste artigo.
A partir do GDK de outubro de 2025, o makepkg dá suporte à opção /updatesubval, que verifica se há uma versão mais recente do SubmissionValidator.dll. Se uma atualização estiver disponível, a opção baixa e instala a DLL no diretório que contém o makepkg.exe, que é o diretório \Bin do GDK por padrão. Se /validationpath for especificado, a DLL será instalada nesse diretório. Se a atualização falhar, o empacotamento ou a validação continuará com a versão atualmente instalada do SubmissionValidator.dll.
A partir do GDK de outubro de 2026, use o comando autônomo makepkg updatesubval para atualizar o SubmissionValidator.dll sem criar, validar ou carregar um pacote. Ao contrário da opção /updatesubval, o comando autônomo retorna um código de saída diferente de zero se a atualização falhar.
Quando um aplicativo, um título ou um pacote de conteúdo é enviado à Microsoft, a versão atual do Submission Validator é usada para verificar esse envio. Antes de enviar seu aplicativo, título ou pacote de conteúdo, recomendamos que você verifique se tem a versão atual do Submission Validator no PC de desenvolvimento no qual o pacote de envio está sendo criado.