{"id":106697,"date":"2022-05-31T07:00:00","date_gmt":"2022-05-31T14:00:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/oldnewthing\/?p=106697"},"modified":"2022-05-31T10:58:04","modified_gmt":"2022-05-31T17:58:04","slug":"20220531-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20220531-00\/?p=106697","title":{"rendered":"The activeCodePage<\/CODE> manifest element can be used for more than just setting UTF-8 as the active code page"},"content":{"rendered":"

Windows 10 Version 1903 introduced a new manifest property called activeCodePage<\/code>, which you can use to set the process’s code page to UTF-8<\/a>.<\/p>\n

Starting in Windows Server 2022 (and Windows 11),\u00b9 you can also use this property to pick non-UTF-8 code pages<\/a> in unpackaged app manifests.\u00b2<\/p>\n

AppLocale<\/a> finally grows up!<\/p>\n

If you specify an activeCodePage<\/code> of Legacy<\/code>, then you’re saying that your application actively hates UTF-8. It will be given the system default locale, provided a system default local exists and it isn’t UTF-8. In those exceptional cases, you get code page 1252 as a fallback.<\/p>\n

You can also specify a locale name such as en-US<\/code> or ja-JP<\/code>, and the application gets the code page corresponding to that locale. If the locale is not recognized by the system, then you get UTF-8 as a fallback.<\/p>\n

This trick is most useful for application compatibility purposes: If you have some legacy application that assumes a specific locale, you can deploy a manifest next to the application that says “I don’t care what locale the system is using. Give this application the locale it wants.”<\/p>\n

Here’s a summary table, since I know people love summary tables.<\/p>\n\n\n\n\n\n\n\n\n
activeCodePage<\/th>\nUTF-8<\/code><\/td>\nspecific locale<\/td>\nLegacy<\/code><\/td>\n<\/tr>\n
Case-sensitive?<\/th>\nYes<\/td>\nNo<\/td>\nYes<\/td>\n<\/tr>\n
Preferred result<\/th>\nUTF-8<\/td>\nThat locale,
\nif available<\/td>\n		System locale,
\nif available,
\nand not UTF-8<\/td>\n<\/tr>\n
Fallback result<\/th>\n <\/td>\nUTF-8<\/td>\n1252<\/td>\n<\/tr>\n
Packaged app<\/th>\nSupported<\/td>\nNot supported<\/td>\nNot supported<\/td>\n<\/tr>\n
Unpackaged app<\/th>\nSupported<\/td>\nSupported<\/td>\nSupported<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\u00b9 Specifically, build 20348 and higher, so that also includes HoloLens 2, also known as Windows Holographic, version 21H1.<\/p>\n

\u00b2 The code name for unpackaged app manifests\u00b3 was “fusion”, so if you read the documentation, you will frequently see them referred to as “fusion manifests”.<\/p>\n

\u00b3 They weren’t called “unpackaged app manifests” at the time, because when the fusion project was being written, we didn’t have packaged apps at all. They were just called “manifests”. Later, when manifests were introduced for packaged apps, the retronym “unpackaged app manifests” was invented to describe fusion manifests.<\/p>\n","protected":false},"excerpt":{"rendered":"

AppLocale grows up.<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25,104],"class_list":["post-106697","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code","tag-tipssupport"],"acf":[],"blog_post_summary":"

AppLocale grows up.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/106697","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=106697"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/106697\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=106697"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=106697"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=106697"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}