- 使用 Submission Validator
- Submission Validator 識別的問題
- 了解結果記錄
- 更新 Submission Validator
- Submission Validator 版本資訊
使用 Submission Validator
Submission Validator 不是供開發人員使用的獨立工具。而是在使用 makepkg pack 命令時，自動呼叫它來檢查應用程式。如需語法和命令列使用方式的詳細資訊，請參閱 makepkg 參考頁面。 Submission Validator 會在作品套件建立後執行。驗證失敗會記錄在驗證記錄中，該記錄會寫入 makepkg 命令列上指定的輸出位置。這與建立完成之作品套件的輸出位置相同。如果在 makepkg 上設定了/validationlanguage 參數，則同一位置也會提供當地語系化版本的輸出 (除了英文輸出之外)。目前額外支援的驗證語言為 ja-jp。
執行 makepkg validate 命令列，即可在建立作品套件之前執行 Submission Validator 測試的子集。建議您執行此命令，以在建立套件之前找出問題。
Submission Validator 識別的問題
Submission Validator 識別的問題類型會隨著時間成長和演進，目標是讓從提交、認證到上市的過程更加順暢。如需 Submission Validator 目前偵測之問題的清單，請參閱 Submission Validator 品質檢查。了解結果記錄
makepkg 處理程序完成後，作品 XVC 會出現在輸出資料夾中。驗證記錄也位於同一個資料夾中。您可以透過其名稱格式 “Validator_[作品和套件識別碼].xml” 來辨識它。您應該檢查此記錄中是否有任何失敗或警告。除了前幾節已顯示的失敗和警告之外，任何 <failure> 標記都代表會導致您的提交在內容擷取、母片製作和認證階段遭拒的狀況。雖然沒有任何機制會阻止您提交這類套件，但這樣做會浪費您的時間和精力。最好是修正所識別的問題，直到記錄中不再包含任何 <failure> 標記為止。
您也可能會在記錄中看到 <warning> 標記。這些標記通常表示可能需要例外狀況的問題。如果您對所識別的任何警告有疑問，請連絡您的開發人員客戶經理 (DAM)。即使您的作品獲得了例外狀況，<warning> 標記仍會出現在記錄檔中。如需記錄訊息的完整清單，請參閱 Submission Validator 訊息。
<validatorrun> 區段位於記錄的結尾，如下所示。此區段包含 <result> 標記，表示 Submission Validator 測試的整體 Fail 或 Success 結果。任何區段中的任何失敗都會導致整體失敗。
更新 Submission Validator
Submission Validator 實作為獨立的 SubmissionValidator.dll，位於 Microsoft Game Development Kit (GDK) 的\Bin 目錄中。Submission Validator 的更新不一定會與 Microsoft Game Development Kit (GDK) 的發行週期一致。您隨時可以從 developer.microsoft.com/games/resources -> downloads 下載目前版本的 Submission Validator。下載壓縮 (.zip) 檔案、開啟它，然後將更新的 SubmissionValidator.dll 放在 Microsoft Game Development Kit (GDK) 的 \Bin 目錄中，覆寫舊版的 Submission Validator。Certification Tools 頁面也會列出目前的發行版本號碼和日期。壓縮檔內有一個文字檔，其中包含目前版本的版本資訊，包括已知問題，以及 Submission Validator 所執行之檢查與本文描述不同之變更的相關資訊。
從 October 2025 GDK 開始，makepkg 支援 /updatesubval 選項，此選項會檢查是否有較新版本的 SubmissionValidator.dll。如果有可用的更新，此選項會下載 DLL 並將其安裝在包含 makepkg.exe 的目錄中，預設為 GDK 的 \Bin 目錄。如果指定了 /validationpath，則 DLL 會改為安裝在該目錄中。如果更新失敗，封裝或驗證會繼續使用目前安裝的 SubmissionValidator.dll 版本。
從 October 2026 GDK 開始，請使用獨立的 makepkg updatesubval 命令來更新 SubmissionValidator.dll，而不需建立、驗證或上傳套件。與 /updatesubval 選項不同，如果更新失敗，獨立命令會傳回非零的結束代碼。
當應用程式、作品或內容套件提交給 Microsoft 時，會使用目前版本的 Submission Validator 來檢查該提交。在提交您的應用程式、作品或內容套件之前，建議您確認建置提交套件的開發電腦上具有目前版本的 Submission Validator。