updated documentation
parent
5ab3d021bc
commit
a9b377c5ac
28
README.mdown
28
README.mdown
|
@ -6,7 +6,7 @@ Powershell scripts are included to try and recreate these build environments dir
|
|||
|
||||
# Requirements
|
||||
|
||||
A Windows 10.0.19041.804+ workstation or VM with minimum 8 GB of memory is required.
|
||||
A Windows 11 10.0.22621.1413+ workstation or VM with minimum 8 GB of memory is required.
|
||||
The more concurrent containers you have running, the more memory and CPU cores are required.
|
||||
|
||||
**Each container requires one core and approximately 4 GB of memory.**
|
||||
|
@ -33,11 +33,11 @@ This will install both the Windows v142 and Windows XP v141_xp build chains into
|
|||
|
||||
Reference these containers later with the names:
|
||||
|
||||
- win_build
|
||||
- win_build:ltsc2022
|
||||
|
||||
- rust_build
|
||||
- rust_build:ltsc2022
|
||||
|
||||
- winxp_build
|
||||
- winxp_build:ltsc2022
|
||||
|
||||
# Run Containers
|
||||
|
||||
|
@ -51,7 +51,7 @@ version: '3'
|
|||
|
||||
services:
|
||||
win_build:
|
||||
image: win_build
|
||||
image: win_build:ltsc2022
|
||||
volumes:
|
||||
- .:C:/source/
|
||||
```
|
||||
|
@ -60,7 +60,7 @@ services:
|
|||
|
||||
- `C:/source/` is assumed to be the project being build with MSVC.
|
||||
|
||||
To build a Windows XP project use the `image: winxp_build` container image.
|
||||
To build a Windows XP project use the `image: winxp_build:ltsc2022` container image.
|
||||
|
||||
# Build Your Windows Project
|
||||
|
||||
|
@ -80,7 +80,7 @@ version: '3'
|
|||
|
||||
services:
|
||||
win_build:
|
||||
image: win_build
|
||||
image: win_build:ltsc2022
|
||||
volumes:
|
||||
- .:C:/source/
|
||||
entrypoint: powershell -Command Import-Module C:\\msvc\\Common7\\Tools\\Microsoft.VisualStudio.DevShell.dll; Enter-VsDevShell -VsInstallPath C:\\msvc\\ -DevCmdArguments -arch=amd64
|
||||
|
@ -97,7 +97,7 @@ They can be ran but should be evaluated as there is no error checking.
|
|||
|
||||
# Troubleshooting
|
||||
|
||||
## error C2471: cannot update program database
|
||||
## `error C2471: cannot update program database`
|
||||
|
||||
MSBuild has trouble writing files to a mounted directory which occurs even if the out path is set in the project.
|
||||
It is recommended that you include a script in your project that copies the `C:\source` directory into the container prior to running the build commands.
|
||||
|
@ -109,7 +109,7 @@ Copy-Item C:\build\bin -Destination C:\source\ -Recurse -Force
|
|||
Remove-Item -Recurse C:\build\
|
||||
```
|
||||
|
||||
# docker-compose build not implimented
|
||||
## `docker-compose build not implimented`
|
||||
|
||||
https://docs.docker.com/compose/cli-command/#compose-v2-and-the-new-docker-compose-command
|
||||
|
||||
|
@ -120,9 +120,17 @@ Use the following command to disable.
|
|||
docker-compose disable-v2
|
||||
```
|
||||
|
||||
# service immediately exits on `docker-compose up`
|
||||
## service immediately exits on `docker-compose up`
|
||||
|
||||
Reminder to run the container instead:
|
||||
```
|
||||
docker-compose run win_build
|
||||
```
|
||||
|
||||
## `a Windows version 10.0.XXXXX-based image is incompatible with a 10.0.XXXXX host`
|
||||
|
||||
Microsoft paid a lot of money to check each container version.
|
||||
Two solutions:
|
||||
|
||||
0. Update your workstation to Windows 11 10.0.22621.1413+
|
||||
0. Replace the string `ltsc2022` with `ltsc2019` across the entire project and rebuild.
|
Loading…
Reference in New Issue