From fcc0c922e4db138302461c68cc00213419ffdb18 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 27 Aug 2025 17:24:07 +0000 Subject: [PATCH 1/3] Initial plan From 63663baf8a38a00c12bc913433a80d0d8749eb8a Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 27 Aug 2025 17:34:45 +0000 Subject: [PATCH 2/3] Add missing Scale qualifier default value information and warnings Co-authored-by: alvinashcraft <73072+alvinashcraft@users.noreply.github.com> --- .../build-resources-into-app-package.md | 23 +++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/uwp/app-resources/build-resources-into-app-package.md b/uwp/app-resources/build-resources-into-app-package.md index d0f0959465..ce59f67a23 100644 --- a/uwp/app-resources/build-resources-into-app-package.md +++ b/uwp/app-resources/build-resources-into-app-package.md @@ -49,10 +49,19 @@ There is one final step that you need to do. **But only if you deleted the `Lang ```xml - ... + + + + + + + + ``` +**Note** Make sure to include all qualifier values in your `priconfig.default.xml` file to preserve the built-in defaults for qualifiers you're not customizing. For the complete list of default values, see [Specify the default resources that your app uses](specify-default-resources-installed.md). + ### How does this work? Behind the scenes, Visual Studio launches a tool named `MakePri.exe` to generate a file known as a Package Resource Index, which describes all of your app's resources, including indicating which resource qualifier names to auto-split on. For details about this tool, see [Compile resources manually with MakePri.exe](compile-resources-manually-with-makepri.md). Visual Studio passes a configuration file to `MakePri.exe`. The contents of your `priconfig.packaging.xml` file are used as the `` element of that configuration file, which is the part that determines auto-splitting. So, adding and editing `priconfig.packaging.xml` ultimately influences the contents of the Package Resource Index file that Visual Studio generates for your app, as well as the contents of the packages in your app bundle. @@ -85,7 +94,17 @@ Here's how that looks after you've deleted the first qualifier name. Save and close, and rebuild your project. -There is one final step that you need to do. **But only if you deleted the `Language` qualifier name**. You need to specify the union of all of your app's supported languages as your app's default language. For details, see [Specify the default resources that your app uses](specify-default-resources-installed.md). This is what your project file would contain if you included resources for English, Spanish, and French in your app package. +There is one final step that you need to do. **But only if you deleted the `Language` qualifier name**. You need to specify the union of all of your app's supported languages as your app's default language. For details, see [Specify the default resources that your app uses](specify-default-resources-installed.md). + +**Important** When you specify ``, you must include all qualifier values that you want to preserve from the built-in defaults. If you only specify some qualifiers (like Language), you will lose the built-in defaults for all other qualifiers (such as Scale, Contrast, etc.). For example, if you don't include `Scale=200`, your app may be missing scaled images. + +Here's what your project file should contain if you included resources for English, Spanish, and French in your app package, while preserving the built-in defaults for other qualifiers: + +```xml +Language=en;es;fr|Contrast=standard|Scale=200|HomeRegion=001|TargetSize=256|LayoutDirection=LTR|DXFeatureLevel=DX9|Configuration=|AlternateForm= +``` + +If you only need to specify the language and want to keep all other defaults unchanged, you can use the shorter version, but be aware it will override all defaults: ```xml Language=en;es;fr From 090aa24e5fcd0420d958a2aee947956c1713e727 Mon Sep 17 00:00:00 2001 From: Alvin Ashcraft <73072+alvinashcraft@users.noreply.github.com> Date: Wed, 27 Aug 2025 13:49:02 -0400 Subject: [PATCH 3/3] Apply suggestions from code review --- uwp/app-resources/build-resources-into-app-package.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/uwp/app-resources/build-resources-into-app-package.md b/uwp/app-resources/build-resources-into-app-package.md index ce59f67a23..d0e478cc11 100644 --- a/uwp/app-resources/build-resources-into-app-package.md +++ b/uwp/app-resources/build-resources-into-app-package.md @@ -60,7 +60,8 @@ There is one final step that you need to do. **But only if you deleted the `Lang ``` -**Note** Make sure to include all qualifier values in your `priconfig.default.xml` file to preserve the built-in defaults for qualifiers you're not customizing. For the complete list of default values, see [Specify the default resources that your app uses](specify-default-resources-installed.md). +> [!NOTE] +> Make sure to include all qualifier values in your `priconfig.default.xml` file to preserve the built-in defaults for qualifiers you're not customizing. For the complete list of default values, see [Specify the default resources that your app uses](specify-default-resources-installed.md). ### How does this work? @@ -96,7 +97,8 @@ Save and close, and rebuild your project. There is one final step that you need to do. **But only if you deleted the `Language` qualifier name**. You need to specify the union of all of your app's supported languages as your app's default language. For details, see [Specify the default resources that your app uses](specify-default-resources-installed.md). -**Important** When you specify ``, you must include all qualifier values that you want to preserve from the built-in defaults. If you only specify some qualifiers (like Language), you will lose the built-in defaults for all other qualifiers (such as Scale, Contrast, etc.). For example, if you don't include `Scale=200`, your app may be missing scaled images. +> [!IMPORTANT] +> When you specify ``, you must include all qualifier values that you want to preserve from the built-in defaults. If you only specify some qualifiers (like Language), you will lose the built-in defaults for all other qualifiers (such as Scale, Contrast, etc.). For example, if you don't include `Scale=200`, your app may be missing scaled images. Here's what your project file should contain if you included resources for English, Spanish, and French in your app package, while preserving the built-in defaults for other qualifiers: