Skip to content

Commit 2310a12

Browse files
committed
website: prerequisites update
1 parent 87edceb commit 2310a12

File tree

1 file changed

+32
-1
lines changed
  • website/docs/getting-started/prerequisites

1 file changed

+32
-1
lines changed

website/docs/getting-started/prerequisites/index.mdx

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -204,11 +204,30 @@ to install the [Git for Windows](https://git-scm.com/download/win) package too.
204204
This also installs a `bash` shell.
205205
The xPack Core Tools can run either in either the Windows shells or in the Git `bash` shell.
206206

207+
<Heading as="h2">Visual C++ Redistributable Files</Heading>
208+
209+
According to Microsoft, some libraries cannot be distributed
210+
with the xPack tools and must be installed separately.
211+
212+
For example, the `msvcp140.dll` and `vcruntime140.dll` files are part of the
213+
[Visual C++ Redistributable for Visual Studio](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist).
214+
215+
Download the latest version of `vc_redist.x64.exe` and install it as usual.
216+
217+
:::caution
218+
219+
The binaries in the **xPack Meson Build** package use `vcruntime140.dll`;
220+
without these redistributables
221+
installed, the `meson` command will fail.
222+
223+
:::
224+
207225
<Heading as="h2">PowerShell Execution Policies</Heading>
208226

209227
Recent Windows versions use PowerShell, which has a more restrictive
210228
execution policy designed to prevent the execution of malicious scripts.
211-
Unfortunately, this also prevents the execution of Node.js applications.
229+
Unfortunately, this also prevents the execution of some
230+
scripting applications, like Node.js or Python.
212231

213232
If you get a message in the console as the one below:
214233

@@ -232,6 +251,18 @@ Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope CurrentUser
232251
For more details please read the Microsoft
233252
[about_Execution_Policies](https://docs.microsoft.com/en-gb/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.1) page.
234253

254+
<Heading as="h2">Long file names</Heading>
255+
256+
Due to historical reasons, Windows restricted file paths to a maximum
257+
length of 260 characters.
258+
259+
This can present challenges for projects created on other platforms,
260+
where lengthy file names are more commonplace.
261+
262+
On Windows 10 and newer versions, the **Long Paths** feature can be enabled manually.
263+
For further information, please refer to the Microsoft documentation, such as the page on
264+
[Maximum Path Length Limitation](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation).
265+
235266
</TabItem>
236267

237268
<TabItem value="macos" label="macOS">

0 commit comments

Comments
 (0)