多語應用程式工具組常見問題集與疑難排解

否。 工具組的其中一個主要利益，便是您不需要多種語言的 .resw 檔案。 工具組會使用 .xlf 檔案管理及同步您應用程式的資源。 這個避免使多個 .resw 檔案的內容保持同步時可能會發生的相關問題。

包含相符 .resw 及 .xlf 檔案的專案會忽略來自 .xlf 檔案的翻譯。 當發生這種情形時，會在建置時顯示警告，告知您最終應用程式中將不會包含 .xlf 翻譯。 當具有相同語言代碼的目標語言時，.resw 檔案與 .xlf 檔案便相符。 其中一個相符配對的範例便是 Strings\de-DE\Resources.resw 及 <project-name>.de-DE.xlf 檔案 (包含 target-language="de-DE")。

可以，但是我們不建議。 若您想要在您的專案中包含多種語言的 .resw 檔案及使用工具組，請確認您沒有相符的 .resw 及 .xlf 檔案。

試試這些步驟。

• 請確認您在開啟 \[工具\] 功能表前選取的是專案節點，而非解決方案節點。
• 確認您已使用 Visual Studio 延伸模組管理員安裝工具組延伸模組。
• 確認您的專案為 UWP 專案。

確認您已為您的專案啟用 MAT。 在 \[工具\] 功能表上，選取 \[多語應用程式工具組\]>\[啟用選取\]。 若您的專案是使用先前版本啟用的，請使用 \[工具\] 功能表停用並重新啟用 MAT。 這會更新專案，使用新版本的工具組。

請確認您已安裝「為所有 Visual Studio 版本建置工作」元件。 這項建置元件會和延伸模組一同安裝，但可在安裝過程中手動取消選取。 這項元件為更新 .xlf 檔案並將翻譯新增到 PRI 檔案的必要元件。 若已安裝這項元件並且正常運作時，您便會看到這些建置訊息。

1> Multilingual App Toolkit build started.
1> Multilingual App Toolkit build completed successfully.

No XLIFF language files were found. The app will not contain any localized resources.

當工具組在專案中找不到任何附檔名為 .xlf 的檔案時，便會顯示這個訊息。 根據預設，工具組會產生並將這些檔案放置在 MultilingualResources 資料夾中。 您可以移動這些檔案，但我們建議您將他們留在該資料夾中，因為這可讓多語編輯器找到相關的中繼資料檔案。

若您手動將 .xlf 檔案從專案中排除，之後又重新加入，檔案類型元素的設定可能會不正確。 在 Visual Studio 中，選取檔案，然後查看 \[屬性\] 視窗。 檔案的 \[建置動作\] 必須設定為 \[XliffResource\]，而 \[複製到輸出目錄\] 則應設定為 \[不要複製\]。 您專案檔案中的參考看起來應該要像是這樣。

<XliffResource Include="MultilingualResources\<project-name>.fr-FR.xlf" />

您的預設語言資源檔 (.resw) 是您應用程式使用字串的正式「結構描述」。 翻譯後的資源檔可能會包含這些字串的全部，或是一部分的子集。

當您建置專案時，您的資源檔和您的 .xlf 檔案便會同步。

• .xlf 檔案會更新，以反映任何新增或移除的字串，或是新增或移除的資源檔。
• 資源檔也會更新，以反映任何 .xlf 檔案中的翻譯字串。

這在 使用多語應用程式工具組中詳細說明。

在能有效使用 MAT 之前，您的應用程式必須要是可當地語系化的。 這在 使用多語應用程式工具組中詳細說明。

Microsoft Translator 是機器式翻譯的雲端式服務。 機器翻譯適合在無法合理取得人類翻譯時存取翻譯。 您可以在 Microsoft Translator 深入了解。

工具組會使用 Microsoft Translator 服務為您提供翻譯建議。 您可以在 Microsoft Translator 圖示出現在 \[翻譯語言\] 對話方塊中時查看 Microsoft Translator 支援哪些語言。

您可以藉由選取字串並按一下 \[翻譯\] ，來在多語編輯器中使用 Microsoft Translator 快速翻譯您的應用程式。

虛擬語言是軟體產品的人造修改，用來模擬真正的語言當地語系化。 您可以在 使用多語應用程式工具組中找到虛擬語言和虛擬資源追蹤器的詳細資料。

這會在 使用多語應用程式工具組中說明。

這會在 使用多語應用程式工具組中說明。

請在多語編輯器中開啟 .xlf 檔案，查看其中是否有翻譯。 當預設語言 .resw 檔案中的字串明確變更時，任何對應的翻譯都會從 .xlf 檔案中移除。 這是為了確保翻譯與其來源字串相符。 請翻譯 .xlf 檔案中的字串，重新建置以更新非預設語言的 .resw 檔案。

若您已在 .xlf 檔案中翻譯字串，但他們仍然沒有出現在您的應用程式中，請重新建置您的專案，更新非預設語言的 .resw 檔案。 Visual Studio 會最佳化 \[建置\] 命令，只建置任何自上一次建置後發生變更的檔案。

檢查您的語言喜好設定順序。 確保您想要測試的語言已列在 \[設定\] 中您的語言喜好設定清單的頂部。

Merge of Loc PRI file failed calling makepri.exe: "0x80004004"

當地區格式與工具組的建置作業產生衝突時，便會顯示這個訊息。 因應措施是在建置時在 \[設定\] 中將您的語言變更為 zh-TW。

Merge of Loc PRI file failed calling makepri.exe: "0x80004005"

當 .xlf 檔案包含不支援的目標語言時，便會顯示這個訊息。 例如，"zh-cht" 為不正確 (請變更為 "zh-hant")，"zh-chs" 也不正確 (請變更為 "zh-hans")。

有，您可以在 Visual Studio 中開啟詳細記錄。 按一下[工具>選項>專案和方案>建置並執行]。 將 \[MSBuild 專案建置輸出詳細資訊\] 從 \[最小\] 變更為 \[標準\] 或更高。

從命令列執行 MSBuild 也會產生額外的訊息。

msbuild /t:rebuild <project-name>

匯入處理序會在匯入前執行基本的驗證。 這會確保匯入檔案中的目標文化資訊與現有的 .xlf 檔案相符。 在多語編輯器中開啟 .xlf 檔案，確認文化資訊相符。

當您在 [匯出字串資源] 對話方塊中選取 [輸出：郵件收件者 ] 時，電子郵件會包含下載並安裝多語應用程式工具組的連結， (MAT) 。 您的翻譯工具仍然可以安裝 MAT 獨立多語系編輯器工具，即使沒有Windows 10，Windows 11也不安裝 Visual Studio。

如需詳細資訊，請參閱 使用多語應用程式工具組。

多語應用程式工具組不會使用專屬的資源鎖定檔案。 而是會將 XLIFF 1.2 標籤 <mrk> 直接新增到 .xlf 檔案，識別在機器翻譯過程中並未修改的字串。 這可讓 XLIFF 檔案獨立，並允許以每個檔案為基礎的資源鎖定。

由於您不再需要這些額外的支援檔案，您可以安心的刪除他們 (若有的話)。

.tpx 檔案提供一種簡單的方式，可在送出 .xlf 檔案進行翻譯時於其中包含 MarkupRules.xml 和 ResourcesLocks.xml 檔案。 這項功能已不再需要。

若 .tpx 檔案中有您想要擷取的翻譯，您只需要將 .tpx 檔案附檔名重新命名為 .zip。 這可讓您使用檔案總管或任何 .zip 相容工具開啟並解壓縮內容。

試試這些步驟。

1. 使用其中一種上述方式新增翻譯。
2. 傾印 .pri 檔案 (請參閱 MakePri.exe 命令列選項) 以查看您的翻譯是否在 .pri 檔案中。 翻譯會與語言代碼和翻譯值一同顯示如下。

   <Candidate qualifiers="Language-QPS-PLOC" type="String">
       <Value>[!!_Ŝéãřćĥ_!!]</Value>
   </Candidate>
   

3. 從命令提示字元建置；其產生的錯誤可能會顯示比建置輸出更多的詳細資料。

在您啟動 Microsoft Store 認證處理序前，您必須先從專案中排除 <project-name>.qps-ploc.xlf 檔案。 虛擬語言是用來偵測潛在的可當地語系化性問題或 Bug，並非有效的 Microsoft Store 語言。 若您並未移除它，您的應用程式便無法通過 Microsoft Store 認證處理序。

多語應用程式工具組 Visual Studio (MAT VS) 擴充功能會收集匿名使用方式資料，並將其傳送至 Microsoft 伺服器，以協助改善產品和服務。 遙測預設為關閉，且可以隨時啟用或停用。

使用方式資料：這是使用哪些功能的匿名資訊。 例如：將新語言新增至已啟用 MAT 的解決方案。

組態資料：這是有關所安裝 MAT VS 版本及其執行所在的 Windows 版本的匿名資訊。

以下是以下列格式所收集的資料具體範例：索引鍵/值/附注：

• AddLanguage / MachineID：xxxx /這是以網路介面卡 NIC 的雜湊為基礎。 不保證是唯一的。
• TimeStamp / 2022/01/07T22：04：45.0000000Z / 時間事件發生。
• 已安裝 MAT_Version / 4.1.02 / MAT 版本。
• Languages / fr，es，de/DE / 已新增至專案的語言清單。

所有資料都會使用 Application Insights 收集並傳送至 Azure Log Analytics。 資料會保留 90 天，然後刪除。

相關主題

• 使用多語應用程式工具組
• Microsoft Translator
• MakePri.exe 命令列選項