From 2dbac07bf40092566c7325f6283da25d798ad32d Mon Sep 17 00:00:00 2001 From: John Cardinal Date: Fri, 23 Oct 2026 10:48:06 -0700 Subject: [PATCH] case 4690 - build docs: .NET 10 SDK for the server, launcher and build VM Co-Authored-By: Claude Opus 5.5 --- devdocs/build/BUILD.md | 8 ++++---- devdocs/build/DEV-VM-SETUP.md | 7 ++++--- devdocs/modernization/NET10-PORT.md | 2 +- 3 files changed, 9 insertions(+), 8 deletions(-) diff --git a/devdocs/build/BUILD.md b/devdocs/build/BUILD.md index f9fc2838..2df83da8 100644 --- a/devdocs/build/BUILD.md +++ b/devdocs/build/BUILD.md @@ -1,7 +1,7 @@ # AyaNova v8 release build How a full release is built: tools, folder layout, what `build-release.bat` does, and where -version numbers live. Written for .NET 8 (8.2.4); the .NET 10 port updates it. +version numbers live. Written for .NET 8 (8.2.4); updated for .NET 10 (8.3.0). To set up a machine that can run this from scratch, see `DEV-VM-SETUP.md`. @@ -9,8 +9,8 @@ To set up a machine that can run this from scratch, see `DEV-VM-SETUP.md`. | Project | Framework | Output | |---|---|---| -| AyaNova server (`raven/server/AyaNova`) | .NET 8 | Five packages, below | -| Launcher (`raven-launcher`) | .NET 8, self-contained, `PublishTrimmed` | Inside the Windows standalone installer | +| AyaNova server (`raven/server/AyaNova`) | .NET 10 | Five packages, below | +| Launcher (`raven-launcher`) | .NET 10, self-contained, `PublishTrimmed` | Inside the Windows standalone installer | | QBI (`ravenqbi/AyaNovaQBI`) | .NET Framework 4.8 | `ayanova-qbi-setup.exe`, built separately | | Package | Build | @@ -25,7 +25,7 @@ To set up a machine that can run this from scratch, see `DEV-VM-SETUP.md`. | Tool | Version | Used for | |---|---|---| -| .NET SDK | 8.0.x | Server and launcher | +| .NET SDK | 10.0.x | Server and launcher | | Node.js | **12.22.9 exactly** | Front end. Newer versions break `fibers` | | Python | 3.11 | MkDocs | | MkDocs + mkdocs-material | current | Customer manual (`pip install mkdocs mkdocs-material`) | diff --git a/devdocs/build/DEV-VM-SETUP.md b/devdocs/build/DEV-VM-SETUP.md index 607921c6..0ea25f29 100644 --- a/devdocs/build/DEV-VM-SETUP.md +++ b/devdocs/build/DEV-VM-SETUP.md @@ -2,7 +2,8 @@ > **Purpose**: Step-by-step instructions to create a portable Windows virtual machine containing the complete AyaNova v8 build environment. This VM can run on Windows or Linux hosts. -Written February 2026 for the .NET 8 build. The .NET 10 port adds the .NET 10 SDK (see `../modernization/NET10-PORT.md`, section 5). +Written February 2026 for the .NET 8 build; updated October 2026 for the .NET 10 port (AyaNova 8.3.0): the .NET 10 SDK replaces the .NET 8 SDK. + --- ## Overview @@ -247,8 +248,8 @@ winget install --id Microsoft.VisualStudioCode -e --source winget # Python 3.11 winget install --id Python.Python.3.11 -e --source winget -# .NET 8 SDK -winget install --id Microsoft.DotNet.SDK.8 -e --source winget +# .NET 10 SDK (server, launcher and integration tests all target net10.0 from 8.3.0) +winget install --id Microsoft.DotNet.SDK.10 -e --source winget # Inno Setup winget install --id JRSoftware.InnoSetup -e --source winget diff --git a/devdocs/modernization/NET10-PORT.md b/devdocs/modernization/NET10-PORT.md index b4b10faf..ce74388c 100644 --- a/devdocs/modernization/NET10-PORT.md +++ b/devdocs/modernization/NET10-PORT.md @@ -146,7 +146,7 @@ suite is waiting on (case 4653, case 4654, the contract issue). - Windows LAN: `lan.iss` prompts for the ASP.NET Core Hosting Bundle. Text and link updated to .NET 10 (2026-10-23); installer test still in section 4 - Windows standalone and the launcher are self-contained: no runtime needed on the customer's machine - [ ] Customer manual (`docs/`): system requirements and upgrade instructions for self-hosted customers. Report browser move (section 3): manual already updated in the same commit (`ops-config-report-render-browser-path.md`, `ops-install-linux-server.md`, `ops-upgrade-linux-server.md`, `ops-upgrade-linux-desktop.md`). The pre-8.2.0 upgrade scripts on the two upgrade pages still install `aspnetcore-runtime-8.0`: update with the .NET 10 runtime instructions -- [ ] Build VM: install the .NET 10 SDK; update `devdocs/build/DEV-VM-SETUP.md` and `devdocs/build/BUILD.md` +- [ ] Build VM: install the .NET 10 SDK (`winget install --id Microsoft.DotNet.SDK.10 -e --source winget`; the .NET 8 SDK is no longer needed). `devdocs/build/DEV-VM-SETUP.md` and `devdocs/build/BUILD.md` updated (2026-10-23); the VM itself still to do - [ ] Final gate runs on the finished code - [ ] Merge, per repo: ```powershell