Skip to main content
本主題說明如何將封裝遊戲的顯示字串當地語系化,讓殼層中顯示適當的當地語系化字串版本。這些步驟與 Microsoft Docs 上的在舊版應用程式或遊戲中使用 Windows 10 資源管理系統一文相關。如果本主題未涵蓋某些詳細資料或案例,您可能需要參考該文章。
先前提及的文章中描述了一個錯誤,其中資訊清單檔案內的字串資產是以如下方式參考:
實際有效的參考方式如下 (請注意省略了 Resources/):

在遊戲中加入當地語系化的殼層視覺效果

開始封裝時,您會有一個 MicrosoftGame.config 檔案,其中包含如下的區段,這些區段透過屬性指定要顯示的文字內容: OverrideDisplayName="My Game's Display Name"。
如果您想允許這些字串有不同的當地語系化版本,可以在應用程式中與您要支援之語言相關聯的個別子資料夾內建立 .resw 檔案。
  1. 建立名為 resources.resw 的 XML 檔案,並將其放在專案的 Strings 子資料夾中。這將是專案的語言中性後援。
  2. 針對每種語言,為專案建立新的 Strings 子資料夾。例如,英文為 Strings\en-us,墨西哥使用的西班牙文為 Strings\es-mx。請務必針對每種語言使用適當的 BCP-47 代碼。
  3. 在每個 XML 檔案中加入下列內容,並以適用於您應用程式且使用適當語言的文字取代醒目提示的文字。下列範例示範使用 (English) 作為簡單的尾碼。
接著,您應該更新 MicrosoftGame.config 檔案,使用 ms-resource:ResourceStringName 語法參考這些資源字串,如下列 OverrideDisplayName 和 Description 屬性中所示。
接著,請確定您的 MicrosoftGame.config 檔案包含應用程式所支援的當地語系化目標清單。例如,如果您的應用程式支援美國英文和墨西哥西班牙文,您的 .config 檔案會將下列內容作為 Game 的子元素。
接著,使用 makepkg localize 命令產生 Resource.pri 檔案,其中會包含這些當地語系化的資產字串。將產生的 Resources.pri 檔案放在遊戲的根內容目錄中。
  1. 在遊戲的根內容目錄中開啟 Microsoft Game Development Kit (GDK) 遊戲命令提示字元。
  2. 執行下列命令:
如果您的目錄結構與此範例不符,或需要額外驗證,可以使用其他參數執行 makepkg localize。
  • 使用 /resw 指定相對於根目錄的路徑,以尋找 .resw 檔案。
  • 使用 /pd 搭配目錄,將產生的 Resources.pri 檔案儲存在預設根目錄以外的位置。目標目錄必須已存在。
  • 使用 /t 搭配目錄名稱,指定將資源匯出至 XML 檔案的位置,您可以手動驗證該檔案以確保其包含適當的資源。
例如:
現在遊戲的根內容目錄中已有 resources.pri 檔案,您可以照常建立套件。 最後,請在系統設定為英文或墨西哥西班牙文的情況下進行安裝,驗證您的當地語系化字串是否顯示在 [開始] 功能表及其他顯示應用程式字串的系統頁面中。請注意,Microsoft Store 應用程式中的圖示來源是已上傳至 Partner Center 的資料,而不是應用程式套件中的資訊。

另請參閱

MicrosoftGame.config MicrosoftGame.config 概觀 MicrosoftGame.config 編輯器 MicrosoftGame.config 參考 (範例 MicrosoftGame.config 與結構描述) 封裝概觀
Last modified on October 6, 2026