admin/raven
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

case 4690 - build docs: .NET 10 SDK for the server, launcher and build VM

Browse Source 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
John Cardinal
2026-10-23 10:48:06 -07:00
parent b4cfc54aa2
commit 2dbac07bf4
3 changed files with 9 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
devdocs/build/BUILD.md
View File

@@ -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`) |

7
devdocs/build/DEV-VM-SETUP.md
View File

@@ -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

2
devdocs/modernization/NET10-PORT.md
View File

@@ -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