- Uso del Validador de envíos
- Problemas identificados por el Validador de envíos
- Descripción del registro de resultados
- Actualización del Validador de envíos
- Notas de la versión del Validador de envíos
Uso del Validador de envíos
El Validador de envíos no es una herramienta independiente que use el desarrollador. En su lugar, se llama automáticamente para comprobar una aplicación cuando se usa el comando makepkg pack. Para obtener más información sobre la sintaxis y el uso de la línea de comandos, consulte la página de referencia de makepkg. El Validador de envíos se ejecuta después de crear el paquete de título. Los errores de validación se registran en el registro de validación, que se escribe en la ubicación de salida especificada en la línea de comandos de makepkg. Se trata de la misma ubicación de salida donde se crea el paquete de título terminado. También hay disponible una versión localizada de la salida (además de la salida en inglés) en la misma ubicación si se establece el parámetro/validationlanguage en makepkg. El idioma de validación adicional admitido actualmente es ja-jp.
Se puede ejecutar un subconjunto de las pruebas del Validador de envíos antes de la creación del paquete de título mediante la línea de comandos makepkg validate. Se recomienda ejecutarla para detectar problemas antes de la creación del paquete.
Problemas identificados por el Validador de envíos
Los tipos de problemas que identifica el Validador de envíos crecerán y evolucionarán con el tiempo para avanzar hacia el objetivo de facilitar el camino desde el envío, pasando por la certificación, hasta el mercado. Para obtener la lista actual de problemas que detecta el Validador de envíos, consulte Comprobaciones de calidad del Validador de envíos.Descripción del registro de resultados
Una vez completado el proceso demakepkg, el XVC del título aparece en la carpeta de salida. El registro de validación está en esta misma carpeta. Puede reconocerlo por su nombre con el formato “Validator_[identificador de título y paquete].xml”. Debe examinar este registro en busca de errores o advertencias. Además de los errores y las advertencias ya mostrados en secciones anteriores, cualquier etiqueta <failure> designa una condición que hará que se rechace el envío como parte de la fase de ingesta de contenido, masterización y certificación. Aunque nada le impide enviar un paquete de este tipo, hacerlo le hará perder tiempo y esfuerzo. Es mucho mejor corregir los problemas identificados hasta que el registro no contenga etiquetas <failure>.
También podría ver etiquetas <warning> en el registro. Por lo general, indican problemas que podrían requerir una excepción. Si tiene preguntas sobre alguna de las advertencias identificadas, póngase en contacto con su administrador de cuentas de desarrollador (DAM). Aunque se le conceda una excepción para su título, la etiqueta <warning> sigue apareciendo en el archivo de registro. Para obtener una lista completa de los mensajes del registro, consulte Mensajes del Validador de envíos.
La sección <validatorrun> está al final del registro, como se muestra a continuación. Esta sección contiene una etiqueta <result> que indica el resultado general de error (Fail) o éxito (Success) de las pruebas del Validador de envíos. Cualquier error en cualquier sección da como resultado un error general.
Actualización del Validador de envíos
El Validador de envíos se implementa como un archivo SubmissionValidator.dll independiente que se encuentra en el directorio\Bin del Microsoft Game Development Kit (GDK). Las actualizaciones del Validador de envíos no siempre coincidirán con el ciclo de versiones del Microsoft Game Development Kit (GDK). La versión actual del Validador de envíos siempre está disponible para su descarga desde developer.microsoft.com/games/resources -> downloads. Descargue el archivo comprimido (.zip), ábralo y coloque el archivo SubmissionValidator.dll actualizado en el directorio \Bin del Microsoft Game Development Kit (GDK), sobrescribiendo la versión anterior del Validador de envíos. La página de herramientas de certificación también incluye el número y la fecha de la versión actual. Dentro del archivo comprimido, hay un archivo de texto que contiene las notas de la versión actual, incluidos los problemas conocidos e información sobre los cambios en las comprobaciones realizadas por el Validador de envíos que difieren de las descripciones de este artículo.
A partir del GDK de octubre de 2025, makepkg admite la opción /updatesubval, que comprueba si hay una versión más reciente de SubmissionValidator.dll. Si hay una actualización disponible, la opción descarga e instala la DLL en el directorio que contiene makepkg.exe, que de forma predeterminada es el directorio \Bin del GDK. Si se especifica /validationpath, la DLL se instala en ese directorio en su lugar. Si la actualización falla, el empaquetado o la validación continúan con la versión de SubmissionValidator.dll instalada actualmente.
A partir del GDK de octubre de 2026, use el comando independiente makepkg updatesubval para actualizar SubmissionValidator.dll sin crear, validar ni cargar un paquete. A diferencia de la opción /updatesubval, el comando independiente devuelve un código de salida distinto de cero si la actualización falla.
Cuando se envía una aplicación, un título o un paquete de contenido a Microsoft, se usa la versión actual del Validador de envíos para comprobar ese envío. Antes de enviar su aplicación, título o paquete de contenido, se recomienda asegurarse de que tiene la versión actual del Validador de envíos en el equipo de desarrollo en el que se compila el paquete de envío.