<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:dt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
font-size:11.0pt;
font-family:"Calibri",sans-serif;
mso-ligatures:standardcontextual;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;
mso-ligatures:standardcontextual;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
/* List Definitions */
@list l0
{mso-list-id:792558315;
mso-list-template-ids:-1302051030;}
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
--></style>
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72" style="word-wrap:break-word">
<div class="WordSection1">
<p style="margin:0in">Hi,<o:p></o:p></p>
<p style="margin:0in"> <o:p></o:p></p>
<p style="margin:0in">I've been investigating an error on Windows in which compilation fails when the SDK file path includes a Chinese character (and more broadly, if any string argument passed to java.exe contains a non-ASCII character). This happens because
command line arguments are read using GetCommandLine() [1]. In the Windows file processenv.h, this resolves to GetCommandLineW [2] if UNICODE is defined and GetCommandLineA [3] otherwise. As UNICODE is not defined, GetCommandLineA is used and Chinese characters
on the command line are converted to "?", causing the following: <o:p></o:p></p>
<p style="margin:0in">Compilation failed with an internal error.<o:p></o:p></p>
<p style="margin:0in">Exception in thread "main" java.nio.file.InvalidPathException: Illegal char <?> at index 34: C:\Program Files (x86)\Android\SDK????\platforms\android-31\android.jar<o:p></o:p></p>
<p style="margin:0in"> <o:p></o:p></p>
<p style="margin:0in">This error has been reported before, including JDK-8124977 [4] (describes command line encoding challenges on Windows, created in 2015 and still unresolved) and JDK-7027461 [5] (resolved as a duplicate in 2011, but the problem has actually
not been fixed). As described in JDK-7027461, this is a fairly significant issue, especially for Asian users with non-ASCII user names and directory paths.
<o:p></o:p></p>
<p style="margin:0in"> <o:p></o:p></p>
<p style="margin:0in">We have a few options to fix this:<o:p></o:p></p>
<ol style="margin-top:0in" start="1" type="1">
<li class="MsoNormal" style="mso-list:l0 level1 lfo1;vertical-align:middle">We can define UNICODE at build time so Windows always chooses GetCommandLineW - would doing this break anything else that I'm not aware of?
<o:p></o:p></li><li class="MsoNormal" style="mso-list:l0 level1 lfo1;vertical-align:middle">We can choose to call GetCommandLineW directly if deemed appropriate. In my opinion, we should only do this if defining UNICODE isn't a viable option, as it's best practice to use the
generic function and let Windows compile it into a Unicode or ANSI function [6].<o:p></o:p></li></ol>
<p style="margin:0in"> <o:p></o:p></p>
<p style="margin:0in">I'd love to hear the community's thoughts on this, namely if there is any reason we can't define UNICODE or if there are any scenarios where using GetCommandLineA (ANSI) is preferable to GetCommandLineW (Unicode). Or if anyone has any
other suggestions for possible solutions, please let me know!<o:p></o:p></p>
<p style="margin:0in"> <o:p></o:p></p>
<p style="margin:0in">Thanks,<o:p></o:p></p>
<p style="margin:0in">Stephanie<o:p></o:p></p>
<p style="margin:0in"> <o:p></o:p></p>
<p style="margin:0in">[1] <a href="https://urldefense.com/v3/__https://github.com/openjdk/jdk/blob/e833c1d179f926edabb2d40c6c357ab20bba726e/src/java.base/share/native/launcher/main.c*L113__;Iw!!ACWV5N9M2RV99hQ!LLvyWJ5tM1ap1lkjOkP4XSEga_rEssSjz5xBE-eQ8Q0a460wTUGp5c7vBXCIHUN7rCwk_zIXy6QgFr6090Lc$">
https://github.com/openjdk/jdk/blob/e833c1d179f926edabb2d40c6c357ab20bba726e/src/java.base/share/native/launcher/main.c#L113</a><o:p></o:p></p>
<p style="margin:0in">[2] <a href="https://urldefense.com/v3/__https://docs.microsoft.com/en-us/windows/win32/api/processenv/nf-processenv-getcommandlinew__;!!ACWV5N9M2RV99hQ!LLvyWJ5tM1ap1lkjOkP4XSEga_rEssSjz5xBE-eQ8Q0a460wTUGp5c7vBXCIHUN7rCwk_zIXy6QgFkDY0xr_$">
GetCommandLineW function (processenv.h) - Win32 apps | Microsoft Docs</a><o:p></o:p></p>
<p style="margin:0in">[3] <a href="https://urldefense.com/v3/__https://docs.microsoft.com/en-us/windows/win32/api/processenv/nf-processenv-getcommandlinea__;!!ACWV5N9M2RV99hQ!LLvyWJ5tM1ap1lkjOkP4XSEga_rEssSjz5xBE-eQ8Q0a460wTUGp5c7vBXCIHUN7rCwk_zIXy6QgFuD1H-56$">
GetCommandLineA function (processenv.h) - Win32 apps | Microsoft Docs</a><o:p></o:p></p>
<p style="margin:0in">[4] <a href="https://bugs.openjdk.org/browse/JDK-8124977">[JDK-8124977] cmdline encoding challenges on Windows - Java Bug System (openjdk.org)</a><o:p></o:p></p>
<p style="margin:0in">[5] <a href="https://bugs.openjdk.org/browse/JDK-7027461">[JDK-7027461] Command Line Arguments not Encoded Properly - Java Bug System (openjdk.org)</a><o:p></o:p></p>
<p style="margin:0in">[6] <a href="https://urldefense.com/v3/__https://docs.microsoft.com/en-us/windows/win32/intl/conventions-for-function-prototypes__;!!ACWV5N9M2RV99hQ!LLvyWJ5tM1ap1lkjOkP4XSEga_rEssSjz5xBE-eQ8Q0a460wTUGp5c7vBXCIHUN7rCwk_zIXy6QgFiXV8vwR$">
Conventions for Function Prototypes - Win32 apps | Microsoft Docs</a><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</body>
</html>