EduBox Dev
84 lines
2.2 KiB
Markdown
84 lines
2.2 KiB
Markdown
# 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](https://dotnet.microsoft.com/download/dotnet/8.0)
|
||
- Visual Studio 2022 ou Visual Studio Code (optionnel)
|
||
|
||
## Structure
|
||
|
||
```text
|
||
setup-wizard/
|
||
├── SetupWizard.csproj
|
||
├── Program.cs
|
||
├── MainForm.cs
|
||
├── InstallerState.cs
|
||
├── PrerequisiteChecker.cs
|
||
└── Resources/
|
||
├── podman-setup.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 :
|
||
|
||
```powershell
|
||
dotnet build -c Release
|
||
```
|
||
|
||
Pour publier un exécutable autonome (pas besoin du runtime .NET sur le poste cible) :
|
||
|
||
```powershell
|
||
dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true
|
||
```
|
||
|
||
L’exécutable se trouve dans :
|
||
|
||
```text
|
||
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-setup.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
|
||
|
||
```powershell
|
||
.\StudioE5-SetupWizard.exe
|
||
```
|
||
|
||
### Mode désinstallation
|
||
|
||
```powershell
|
||
.\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`.
|