JoYo
/
win-build
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

updated documentation

master
JoYo 2023-03-27 14:31:49 -04:00
parent 5ab3d021bc
commit a9b377c5ac
1 changed files with 18 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
README.mdown
View File

@ -6,7 +6,7 @@ Powershell scripts are included to try and recreate these build environments dir
# Requirements # 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. 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.** **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: Reference these containers later with the names:
- win_build - win_build:ltsc2022
- rust_build - rust_build:ltsc2022
- winxp_build - winxp_build:ltsc2022
# Run Containers # Run Containers
@ -51,7 +51,7 @@ version: '3'
services: services:
win_build: win_build:
image: win_build image: win_build:ltsc2022
volumes: volumes:
- .:C:/source/ - .:C:/source/
``` ```
@ -60,7 +60,7 @@ services:
- `C:/source/` is assumed to be the project being build with MSVC. - `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 # Build Your Windows Project
@ -80,7 +80,7 @@ version: '3'
services: services:
win_build: win_build:
image: win_build image: win_build:ltsc2022
volumes: volumes:
- .:C:/source/ - .:C:/source/
entrypoint: powershell -Command Import-Module C:\\msvc\\Common7\\Tools\\Microsoft.VisualStudio.DevShell.dll; Enter-VsDevShell -VsInstallPath C:\\msvc\\ -DevCmdArguments -arch=amd64 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 # 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. 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. 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\ 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 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 docker-compose disable-v2
``` ```
# service immediately exits on `docker-compose up` ## service immediately exits on `docker-compose up`
Reminder to run the container instead: Reminder to run the container instead:
``` ```
docker-compose run win_build 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.