edubox/agent/installer/setup-wizard/README.md

StudioE5 Setup Wizard

Assistant d’installation graphique Windows pour studioE5 Agent.

Rôle

Ce wizard guide l’utilisateur pas à pas pour :

1. Vérifier les prérequis (RAM, disque, Windows, environnement virtuel, Podman).
2. Installer l’environnement virtuel (WSL2) si nécessaire, avec reprise après redémarrage.
3. Installer Podman depuis le MSI bundlé.
4. Initialiser et démarrer la machine Podman.
5. Lancer le package Inno Setup de studioE5 Agent.

Il propose aussi un mode désinstallation complet (/uninstall).

Prérequis de build

• Windows 10/11
• .NET 8 SDK
• Visual Studio 2022 ou Visual Studio Code (optionnel)

Structure

setup-wizard/
├── SetupWizard.csproj
├── Program.cs
├── MainForm.cs
├── InstallerState.cs
├── PrerequisiteChecker.cs
└── Resources/
    ├── podman-installer-windows-amd64.msi  # MSI officiel Podman pour Windows
    └── studioE5-agent-setup.exe            # Package Inno Setup de l'agent

Build

Ouvrir un terminal PowerShell dans ce dossier et exécuter :

dotnet build -c Release

Pour publier un exécutable autonome (pas besoin du runtime .NET sur le poste cible) :

dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true

L’exécutable se trouve dans :

bin\Release\net8.0-windows\win-x64\publish\StudioE5-SetupWizard.exe

Préparation du package

1. Télécharger le MSI Podman Windows : https://github.com/containers/podman/releases
2. Le renommer en podman-installer-windows-amd64.msi et le placer dans Resources/.
3. Générer le package Inno Setup de l’agent (studioE5-agent-setup.exe) et le placer dans Resources/.
4. Builder et publier le wizard.

Lancement

Mode installation

.\StudioE5-SetupWizard.exe

Mode désinstallation

.\StudioE5-SetupWizard.exe /uninstall

Notes

• Le wizard doit être exécuté en administrateur.
• L’installation de WSL2 nécessite un redémarrage de l’ordinateur. Le wizard s’enregistre dans RunOnce pour se relancer automatiquement.
• Le MSI Podman doit correspondre à l’architecture x64.