Skip to content
← Tous les articles
· Delta1 Labs WPFNebula

Préserver les pack URI WPF à travers l'obfuscation

WPF compile votre XAML en BAML dans un flux de ressources nommé d'après l'assembly, et les pack URI figent ce nom — renommer la mauvaise chose casse donc chaque fenêtre. Voici comment Nebula.NET protège une app WPF sans rompre ces liens.

Une app WPF qui tourne parfaitement en Debug peut lever IOException: Cannot locate resource 'views/mainwindow.xaml' à son premier lancement en build obfusqué — avant qu”une seule ligne de votre view-model ne s”exécute. La fenêtre ne s”ouvre jamais. Rien dans vos liaisons XAML n”est faux, et preservePublicApi est activé. La panne se situe un niveau en dessous de la couche de liaison où s”arrête la plupart des conseils d”obfuscation WPF : elle est dans la façon dont WPF stocke et retrouve votre balisage compilé.

Le conseil général — garder nommés les membres liés pour que {Binding CustomerName} se résolve — est nécessaire mais pas suffisant. Le XAML n”est pas interprété à l”exécution ; il est compilé en BAML et incrusté dans un flux de ressources dont le nom et les références internes sont couplés à votre assembly de manières qu”un renommeur peut rompre sans bruit. Cet article est le mécanisme : où vit réellement votre XAML dans la DLL distribuée, quels noms le runtime fige, et comment Nebula.NET obfusque les entrailles à fond tout en laissant ces liens intacts.

Où va votre XAML

Lorsque vous compilez un projet WPF, chaque fichier .xaml avec l”action de génération Page est compilé en BAML — une forme binaire tokenisée du balisage — et tous ces flux sont empaquetés dans une unique ressource managée nommée d”après l”assembly : MyApp.g.resources. À l”intérieur, chaque fenêtre ou contrôle est identifié par son chemin relatif au projet en minuscules avec l”extension .baml, par exemple views/mainwindow.baml.

La moitié générée de votre classe de fenêtre atteint ce flux via un pack URI :

// MainWindow.g.cs — generated, normally hidden
public void InitializeComponent()
{
    if (_contentLoaded) return;
    _contentLoaded = true;
    var uri = new Uri("/MyApp;component/views/mainwindow.xaml", UriKind.Relative);
    Application.LoadComponent(this, uri);
}

Cette unique chaîne URI porte deux noms déterminants. MyApp est le nom court de l”assembly — WPF transforme ;component en une recherche de MyApp.g.resources. views/mainwindow.xaml est le chemin de la ressource, que WPF mappe vers l”entrée views/mainwindow.baml dans ce flux. La même forme apparaît partout où le XAML référence une autre ressource :

<!-- App.xaml: merge a theme dictionary -->
<ResourceDictionary.MergedDictionaries>
  <ResourceDictionary Source="pack://application:,,,/MyApp;component/Themes/Colors.xaml"/>
</ResourceDictionary.MergedDictionaries>

<!-- An image shipped with Build Action = Resource -->
<Image Source="pack://application:,,,/Images/logo.png"/>

Chacun de ces URI se résout à travers les deux mêmes coordonnées : le nom court de l”assembly et un chemin de ressource. Renommez l”un sans mettre à jour l”autre et la résolution échoue.

pack URI (dans InitializeComponent)/MyApp;component/views/mainwindow.xamlMyApp.dllMyApp.g.resources (flux)views/mainwindow.bamltable de types → MyApp.Views.MainWindow(1) le nom court de l'assemblydoit égaler le nom du flux(2) couplage que le renommeur doit respecterrenommer MyApp.Views.MainWindow dans métadonnées →réécrire la table de types du BAML au nouveau nomBAML et métadonnées restent synchronisés

Les trois façons dont l”obfuscation la casse

Renommer l”assembly. C”est le piège classique. Si votre outil renomme l”assembly de sortie — ou si vous fixez un AssemblyName différent pour le build protégé — le flux devient Protected.g.resources tandis que le pack URI dit toujours /MyApp;component/. WPF cherche un flux qui n”existe plus et échoue au démarrage. La règle est simple : ne renommez pas le nom de l”assembly WPF. Obfusquez tout ce qu”il contient ; laissez l”identité de l”assembly tranquille.

Renommer des types sans réécrire le BAML. Un flux BAML n”est pas une suite d”octets opaques. Il commence par une table d”assemblies et une table de types qui nomment le type x:Class, chaque type d”élément instancié dans le balisage et les propriétés affectées dessus. Au chargement, WPF lit ces noms et lie le flux à votre code-behind MyApp.Views.MainWindow et à ses membres. Renommez ce type dans les métadonnées IL mais laissez l”enregistrement BAML pointant vers l”ancienne chaîne, et le chargeur ne pourra pas connecter la fenêtre à sa classe — vous obtiendrez une XamlParseException ou un code-behind nul.

Chiffrer ce que WPF doit lire comme du texte. Les chemins de ressource dans les pack URI et les clés de ressource x:Key dans le BAML sont consommés par le sous-système XAML/ressources, pas par votre code. Ce ne sont pas des instructions ldstr qu”une passe de chiffrement de chaînes verrait, donc le chiffrement de chaînes ordinaire n”y touche pas — mais tout mangling personnalisé du nom de ressource qui le ferait casserait la résolution.

Ce que Nebula.NET fait pour vous

Nebula.NET reconnaît un assembly WPF (il porte le flux .g.resources et une empreinte ThemeInfo/XmlnsDefinition) et traite le BAML comme des métadonnées de première classe plutôt que comme un blob inerte :

  • Il préserve le nom court de l”assembly et le nom du flux .g.resources, pour que chaque pack URI ;component et chaque appel à Application.LoadComponent se résolvent encore.
  • Il analyse et réécrit les tables de types et d”assemblies du BAML en phase avec la carte de renommage. Quand un type référencé depuis le balisage est renommé dans les métadonnées, son enregistrement BAML est réécrit au même nouveau nom — le balisage et l”IL renommé restent cohérents, exactement comme la renumérotation des jetons garde cohérents les opérandes de call et ldstr après une reconstruction des métadonnées.
  • Il laisse tranquilles les chemins de ressource et les chaînes x:Key, car ce sont des adresses que WPF résout, pas des secrets.

La configuration pratique est la même surface minimale et sûre que vous utiliseriez pour n”importe quelle app WPF, plus l”intention explicite de garder les ressources intactes :

{
  "inputs": ["bin/Release/net8.0/MyApp.dll"],
  "outputDirectory": "protected",
  "preservePublicApi": true,
  "preserveResources": true,
  "controlFlowObfuscation": true,
  "encryptStrings": true
}

preserveResources garde adressables les noms de flux et les fichiers de ressource isolés ; preservePublicApi garde nommés les membres du view-model liés pour que {Binding} se résolve toujours. Tout ce que le balisage ne nomme pas — vos services, algorithmes, membres privés — est renommé, aplati et ses chaînes chiffrées à pleine force. La valeur vit dans le code derrière la fenêtre, et c”est exactement ce qui est protégé.

Contrôles personnalisés et thèmes

Une bibliothèque de contrôles réutilisable a un couplage supplémentaire : l”attribut [assembly: ThemeInfo] indique à WPF de chercher /themes/generic.baml pour les styles par défaut, et la DefaultStyleKey de chaque contrôle est son propre Type. Comme Nebula préserve le flux de ressources et réécrit la table de types du BAML de façon cohérente, Themes/Generic.xaml continue de se charger et les styles par défaut continuent de se lier — mais c”est l”écran le plus important à parcourir après la protection, puisqu”un thème absent échoue visuellement plutôt qu”avec une exception dure.

Vérifiez qu”elle se charge vraiment

Les problèmes de BAML surgissent au chargement, pas à la compilation, donc le test consiste à exécuter le build protégé et à ouvrir chaque fenêtre — surtout les contrôles à gabarit personnalisé et tout ResourceDictionary fusionné depuis un autre assembly. Si une fenêtre lève une exception, lisez le message : Cannot locate resource pointe vers une incohérence de nom de flux ou de chemin de ressource, tandis qu”une XamlParseException nommant un type pointe vers une réécriture de la table de types du BAML qui n”a pas eu lieu.

Vous pouvez aussi inspecter l”artefact distribué directement. Ouvrez la DLL protégée dans Glass.NET et regardez les ressources managées : confirmez que le flux <AssemblyName>.g.resources est présent sous le nom d”assembly inchangé et que ses entrées BAML portent toujours les chemins attendus. Pour une vérification plus poussée, extrayez un flux BAML et confirmez que sa table de types nomme les types renommés — c”est la preuve que le balisage et les métadonnées s”accordent. Automatiser cette vérification en CI suit le même schéma que n”importe quelle autre barrière d”obfuscation : protéger, puis affirmer que le flux de ressources existe et que le test de fumée de l”app ouvre chaque fenêtre. Voir Vérifier l”obfuscation en CI pour le harnais.

La version courte

  • WPF distribue votre XAML sous forme de BAML dans <AssemblyName>.g.resources, et les pack URI figent le nom court de l”assembly et le chemin de la ressource.
  • Ne renommez jamais le nom de l”assembly WPF — il est incrusté dans chaque URI ;component et dans le nom du flux de ressources.
  • Renommer des types est acceptable si la table de types du BAML est réécrite avec eux ; Nebula.NET le fait en phase avec la carte de renommage.
  • Gardez preserveResources et preservePublicApi activés, puis obfusquez les entrailles à fond — c”est là qu”est la valeur.
  • Testez en lançant et en ouvrant chaque fenêtre, et vérifiez le flux de ressources avec Glass.NET.

Essayez Nebula.NET

Renforcez votre code .NET en quelques minutes — commencez avec l'édition gratuite.