Builds obfusqués

Garble est un outil de compilation Go qui remplace go build afin de renommer les symboles, d’obfusquer les constantes et de supprimer les informations de débogage du binaire obtenu. Wails v3 prend directement en charge Garble grâce à deux nouvelles commandes.

Prérequis

• Go 1.26.2 ou version ultérieure — requis par Garble v0.16.0
• Garble v0.16.0

go install mvdan.cc/garble@v0.16.0

Obligatoire : ajoutez des balises JSON aux types de vos services

Toute structure renvoyée ou acceptée par une méthode de service liée doit comporter des balises JSON explicites sur chacun de ses champs exportés :

// Without tags — breaks under Garble
type OrderSummary struct {
    ID        int
    Total     float64
    LineItems []LineItem
}

// With tags — safe under Garble
type OrderSummary struct {
    ID        int       `json:"id"`
    Total     float64   `json:"total"`
    LineItems []LineItem `json:"lineItems"`
}

Les propres types de Wails — Screen, Rect, Point, Size, EnvironmentInfo, OSInfo, Capabilities — comportent déjà des balises. Vous devez uniquement ajouter des balises à vos propres types.

Compiler avec obfuscation

wails3 generate bindings -obfuscated

wails3 build --obfuscated

Transmettre des options supplémentaires à Garble

Utilisez --garbleargs pour transmettre directement des options à garble :

# Obfuscate string literals and reduce binary size
wails3 build --obfuscated --garbleargs "-literals -tiny"

# Reproducible output — same seed produces the same binary
wails3 build --obfuscated --garbleargs "-seed=deadbeef"

Consultez la documentation de Garble pour connaître la liste complète des options prises en charge.

Avancé : écrire le fichier d’identifiants dans un autre package

Par défaut, wails_obfuscated.gen.go est écrit à côté de votre package main. Si votre projet conserve les services dans un sous-package importé par main, vous pouvez plutôt y écrire le fichier avec -obfuscated-output :

wails3 generate bindings -obfuscated -obfuscated-output ./internal/services

Dépannage

garble: command not found

Garble n’est pas installé ou $(go env GOPATH)/bin ne figure pas dans votre PATH.

go install mvdan.cc/garble@v0.16.0
export PATH="$PATH:$(go env GOPATH)/bin"

Le frontend reçoit des valeurs de champs incorrectes ou vides

Les types de retour de vos services ne comportent pas de balises json:"...". Vérifiez chaque structure renvoyée par vos méthodes liées et ajoutez des balises explicites à chaque champ exporté.

Erreur binding not found dans la console du navigateur

Le fichier d’identifiants stables est absent ou n’a pas été inclus dans la compilation. Vérifiez les points suivants :

• wails_obfuscated.gen.go existe dans le répertoire de votre package principal (ou dans le répertoire transmis à -obfuscated-output)
• Vous avez exécuté wails3 build --obfuscated, qui ajoute la balise de compilation wails_obfuscated
• Si vous avez utilisé -obfuscated-output, le package de destination est importé par main

Windows Defender signale le build comme un virus

Pendant la compilation, Windows Defender signale de manière heuristique les binaires Go obfusqués avec Garble, car ils ne comportent pas de symboles de débogage et ressemblent à des exécutables compressés. La compilation échoue avec le message suivant :

open C:\Users\...\AppData\Local\Temp\go-build...\a.out.exe: The file contains a virus or potentially unwanted software.

Ajoutez votre répertoire temporaire (dans lequel Go écrit les artefacts de compilation intermédiaires) et le répertoire de votre projet à la liste d’exclusions de Defender :

Add-MpPreference -ExclusionPath "$env:TEMP"
Add-MpPreference -ExclusionPath "C:\path\to\your\project"

Ces exclusions s’appliquent uniquement aux chemins indiqués et ne désactivent pas Defender globalement.

La compilation échoue avec unsupported Go version

Garble v0.16.0 nécessite Go 1.26.2 ou version ultérieure. Mettez Go à niveau ou consultez la page des versions de Garble afin de trouver une version compatible avec votre chaîne d’outils.