> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Submission Validator (SubmissionValidator.dll) > Submission Validator (SubmissionValidator.dll) Submission Validator 是 Microsoft Game Development Kit (GDK) 的元件，會對作品或應用程式套件執行一系列基本品質檢查。Submission Validator 會向開發人員提供意見反應，協助解決可能導致作品在 Microsoft 內容擷取和認證流程中失敗的常見問題。提交作品套件時，會使用最新版本的 Submission Validator 來偵測任何可能導致作品遭拒的失敗。Submission Validator 的整體目標是將這些檢查自動化，並盡可能將其提前到流程的早期階段，以確保合作夥伴能在提交作品套件進行認證之前，自行診斷並修正問題。 * [使用 Submission Validator](#using-submission-validator) * [Submission Validator 識別的問題](#problems-identified-by-submission-validator) * [了解結果記錄](#understanding-the-results-log) * [更新 Submission Validator](#updating-submission-validator) * [Submission Validator 版本資訊](#submission-validator-release-notes) ## 使用 Submission Validator Submission Validator 不是供開發人員使用的獨立工具。而是在使用 [makepkg pack](/zh-TW/build/core-features/common/packaging/deployment/makepkg) 命令時，自動呼叫它來檢查應用程式。如需語法和命令列使用方式的詳細資訊，請參閱 [makepkg](/zh-TW/build/core-features/common/packaging/deployment/makepkg) 參考頁面。 Submission Validator 會在作品套件建立後執行。驗證失敗會記錄在驗證記錄中，該記錄會寫入 [makepkg](/zh-TW/build/core-features/common/packaging/deployment/makepkg) 命令列上指定的輸出位置。這與建立完成之作品套件的輸出位置相同。如果在 [makepkg](/zh-TW/build/core-features/common/packaging/deployment/makepkg) 上設定了 `/validationlanguage` 參數，則同一位置也會提供當地語系化版本的輸出 (除了英文輸出之外)。目前額外支援的驗證語言為 ja-jp。 執行 [makepkg validate](/zh-TW/build/core-features/common/packaging/deployment/makepkg) 命令列，即可在建立作品套件之前執行 Submission Validator 測試的子集。建議您執行此命令，以在建立套件之前找出問題。 ## Submission Validator 識別的問題 Submission Validator 識別的問題類型會隨著時間成長和演進，目標是讓從提交、認證到上市的過程更加順暢。如需 Submission Validator 目前偵測之問題的清單，請參閱 [Submission Validator 品質檢查](/zh-TW/build/core-features/common/packaging/subval/submissionvalidator-tests)。 ## 了解結果記錄 `makepkg` 處理程序完成後，作品 XVC 會出現在輸出資料夾中。驗證記錄也位於同一個資料夾中。您可以透過其名稱格式 *"Validator\_\[作品和套件識別碼].xml"* 來辨識它。您應該檢查此記錄中是否有任何失敗或警告。除了前幾節已顯示的失敗和警告之外，任何 `` 標記都代表會導致您的提交在內容擷取、母片製作和認證階段遭拒的狀況。雖然沒有任何機制會阻止您提交這類套件，但這樣做會浪費您的時間和精力。最好是修正所識別的問題，直到記錄中不再包含任何 `` 標記為止。 您也可能會在記錄中看到 `` 標記。這些標記通常表示可能需要例外狀況的問題。如果您對所識別的任何警告有疑問，請連絡您的開發人員客戶經理 (DAM)。即使您的作品獲得了例外狀況，`` 標記仍會出現在記錄檔中。如需記錄訊息的完整清單，請參閱 [Submission Validator 訊息](/zh-TW/build/core-features/common/packaging/subval/submissionvalidator-messages)。 `` 區段位於記錄的結尾，如下所示。此區段包含 `` 標記，表示 Submission Validator 測試的整體 Fail 或 Success 結果。任何區段中的任何失敗都會導致整體失敗。 ```xml theme={null} Sep 23 2019 16:43:41 Sep 23 2019 16:43:41 Fail ``` 測試所使用之 Submission Validator 的版本號碼位於記錄檔的頂端。下列範例顯示記錄檔中的此版本號碼。 ```xml theme={null} 10.0.18362.7198 ``` Microsoft 收到您的提交時，會使用最新版本的 Submission Validator 來測試您的提交。強烈建議您在準備提交作品時，定期更新您所使用的 Submission Validator 版本。如需詳細資訊，請參閱下一節。 ## 更新 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](https://aka.ms/currentsubvalzip) 下載目前版本的 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`](/zh-TW/build/core-features/common/packaging/deployment/makepkg#updatesubval) 命令來更新 `SubmissionValidator.dll`，而不需建立、驗證或上傳套件。與 `/updatesubval` 選項不同，如果更新失敗，獨立命令會傳回非零的結束代碼。 當應用程式、作品或內容套件提交給 Microsoft 時，會使用目前版本的 Submission Validator 來檢查該提交。在提交您的應用程式、作品或內容套件之前，建議您確認建置提交套件的開發電腦上具有目前版本的 Submission Validator。 ## Submission Validator 版本資訊 如需 Submission Validator 每個版本之變更的詳細資訊，請參閱 XBOX 開發人員論壇上的 [Submission Validator Updates](https://aka.ms/subvalupdates) 摘要。 ## Submission Validator 主題 [Submission Validator 品質檢查](/zh-TW/build/core-features/common/packaging/subval/submissionvalidator-tests) 說明 Submission Validator 所執行的品質檢查。 [Submission Validator 訊息](/zh-TW/build/core-features/common/packaging/subval/submissionvalidator-messages) 說明 Submission Validator 所產生的訊息 (警告、錯誤和建議)。 ## 相關主題 [建立套件 (makepkg.exe)](/zh-TW/build/core-features/common/packaging/deployment/makepkg) [作品封裝、內容更新和串流安裝測試](/zh-TW/build/core-features/common/packaging/title-packaging-streaming-install-testing) XBOX 需求 (XR) [(XBOX Developer Downloads->Partner, Publishing, and Release Management Information->XGD Partner Documentation)](https://aka.ms/xgddl) ## Related topics - [Submission Validator (SubmissionValidator.dll)](/build/core-features/common/packaging/subval/submissionvalidator.md) - [Submission Validator(SubmissionValidator.dll)](/ko/build/core-features/common/packaging/subval/submissionvalidator.md) - [Submission Validator messages](/build/core-features/common/packaging/subval/submissionvalidator-messages.md) - [Submission Validator 消息](/zh-CN/build/core-features/common/packaging/subval/submissionvalidator-messages.md) - [Submission Validator quality checks](/build/core-features/common/packaging/subval/submissionvalidator-tests.md)