Création de paquets Windows

Programme d’installation NSIS

Le format de paquet par défaut crée un programme d’installation NSIS :

wails3 package GOOS=windows

Cette opération exécute wails3 task windows:package, qui :

1. Compile l’application
2. Génère le programme d’amorçage de WebView2
3. Crée un programme d’installation NSIS

Sortie : build/windows/nsis/<AppName>-installer.exe

Paquet MSIX

Pour une distribution via le Microsoft Store ou un déploiement Windows moderne :

wails3 package GOOS=windows FORMAT=msix

Sortie : bin/<AppName>-<arch>.msix

Personnalisation du programme d’installation

La configuration de NSIS se trouve dans build/windows/nsis/project.nsi. Modifiez ce fichier pour personnaliser :

• L’interface utilisateur et l’identité visuelle du programme d’installation
• Le répertoire d’installation
• Les raccourcis du menu Démarrer et du bureau
• Les associations de fichiers
• Le contrat de licence

Les métadonnées de l’application proviennent de build/windows/info.json :

{
  "fixed": {
    "file_version": "1.0.0"
  },
  "info": {
    "0000": {
      "ProductVersion": "1.0.0",
      "CompanyName": "My Company",
      "FileDescription": "My Application",
      "ProductName": "MyApp"
    }
  }
}

Signature du code

Signez votre exécutable et votre programme d’installation pour éviter les avertissements SmartScreen :

# Using the wrapper (auto-detects platform)
wails3 sign GOOS=windows

# Or using tasks directly
wails3 task windows:sign
wails3 task windows:sign:installer

Configurez la signature dans build/windows/Taskfile.yml :

vars:
  SIGN_CERTIFICATE: "path/to/certificate.pfx"
  # Or use thumbprint for certificates in Windows store
  SIGN_THUMBPRINT: "certificate-thumbprint"
  TIMESTAMP_SERVER: "http://timestamp.digicert.com"

Stockez le mot de passe de votre certificat de manière sécurisée :

wails3 setup signing

Pour plus de détails, consultez Signature des applications.

Compilation pour ARM

wails3 build GOOS=windows GOARCH=arm64
wails3 package GOOS=windows GOARCH=arm64

Résolution des problèmes

makensis introuvable

Installez NSIS :

# Windows
winget install NSIS.NSIS

# Or download from https://nsis.sourceforge.io/

Avertissement SmartScreen

Votre exécutable n’est pas signé. Consultez la section Signature du code ci-dessus.

WebView2 manquant

Le programme d’installation comprend un programme d’amorçage de WebView2 qui télécharge l’environnement d’exécution si nécessaire. Si vous devez effectuer une installation hors ligne, téléchargez Evergreen Standalone Installer auprès de Microsoft.