WPF-Pack-URIs durch die Obfuskierung am Leben halten
WPF kompiliert dein XAML in BAML innerhalb eines nach der Assembly benannten Ressourcenstreams, und Pack-URIs verankern diesen Namen fest — das Falsche umzubenennen zerstört also jedes Fenster. So schützt Nebula.NET eine WPF-App, ohne diese Verknüpfungen zu kappen.
Eine WPF-App, die im Debug tadellos läuft, kann beim ersten Start ihres obfuskierten Builds IOException: Cannot locate resource 'views/mainwindow.xaml' werfen — bevor eine einzige Zeile deines View-Models ausgeführt wird. Das Fenster öffnet sich nie. An deinen XAML-Bindungen ist nichts falsch, und preservePublicApi ist eingeschaltet. Der Bruch liegt eine Ebene unter der Bindungsschicht, bei der die meisten WPF-Obfuskierungsratschläge aufhören: Er steckt darin, wie WPF dein kompiliertes Markup speichert und findet.
Der allgemeine Rat — gebundene Member benannt zu lassen, damit {Binding CustomerName} auflöst — ist notwendig, aber nicht hinreichend. XAML wird zur Laufzeit nicht interpretiert; es wird zu BAML kompiliert und in einen Ressourcenstream eingebettet, dessen Name und interne Verweise auf eine Weise an deine Assembly gekoppelt sind, die ein Renamer leise durchtrennen kann. Dieser Artikel ist der Mechanismus: wo dein XAML in der ausgelieferten DLL wirklich lebt, welche Namen die Runtime fest verankert, und wie Nebula.NET die Interna hart obfuskiert und diese Verknüpfungen dabei intakt lässt.
Wohin dein XAML geht
Wenn du ein WPF-Projekt baust, wird jede .xaml-Datei mit der Build-Aktion Page zu BAML kompiliert — einer binären, tokenisierten Form des Markups — und all diese Streams werden in eine einzige verwaltete Ressource mit dem Namen der Assembly gepackt: MyApp.g.resources. Darin wird jedes Fenster oder Steuerelement durch seinen kleingeschriebenen, projektrelativen Pfad mit der Endung .baml identifiziert, zum Beispiel views/mainwindow.baml.
Die generierte Hälfte deiner Fensterklasse erreicht diesen Stream über einen 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);
}
Dieser eine URI-String trägt zwei tragende Namen. MyApp ist der kurze Assembly-Name — WPF verwandelt ;component in eine Suche nach MyApp.g.resources. views/mainwindow.xaml ist der Ressourcenpfad, den WPF auf den Eintrag views/mainwindow.baml in diesem Stream abbildet. Dieselbe Form taucht überall dort auf, wo XAML eine andere Ressource referenziert:
<!-- 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"/>
Jeder davon löst über dieselben zwei Koordinaten auf: den kurzen Assembly-Namen und einen Ressourcenpfad. Benenne eine davon um, ohne die andere zu aktualisieren, und die Auflösung schlägt fehl.
Die drei Wege, auf denen Obfuskierung es bricht
Die Assembly umbenennen. Das ist die klassische Falle. Benennt dein Werkzeug die Ausgabe-Assembly um — oder legst du für den geschützten Build einen anderen AssemblyName fest — wird der Stream zu Protected.g.resources, während der Pack-URI weiterhin /MyApp;component/ sagt. WPF sucht einen Stream, der nicht mehr existiert, und scheitert beim Start. Die Regel ist einfach: Benenne den Namen der WPF-Assembly nicht um. Obfuskiere alles darin; lass die Identität der Assembly in Ruhe.
Typen umbenennen, ohne das BAML neu zu schreiben. Ein BAML-Stream ist keine undurchsichtige Bytefolge. Er beginnt mit einer Assembly- und einer Typtabelle, die den x:Class-Typ, jeden im Markup instanziierten Elementtyp und die darauf gesetzten Eigenschaften benennen. Beim Laden liest WPF diese Namen und bindet den Stream an dein Code-Behind MyApp.Views.MainWindow und seine Member. Benenne diesen Typ in den IL-Metadaten um, aber lass den BAML-Eintrag auf den alten String zeigen, und der Loader kann das Fenster nicht mit seiner Klasse verbinden — du erhältst eine XamlParseException oder ein null-Code-Behind.
Verschlüsseln, was WPF als Text lesen muss. Die Ressourcenpfade in Pack-URIs und die x:Key-Ressourcenschlüssel im BAML werden vom XAML-/Ressourcen-Subsystem verbraucht, nicht von deinem Code. Es sind keine ldstr-Anweisungen, die ein String-Verschlüsselungsdurchlauf sähe, deshalb rührt die normale String-Verschlüsselung sie nicht an — aber jede benutzerdefinierte Verfälschung des Ressourcennamens, die es täte, würde die Auflösung brechen.
Was Nebula.NET für dich tut
Nebula.NET erkennt eine WPF-Assembly (sie trägt den .g.resources-Stream und einen ThemeInfo/XmlnsDefinition-Fußabdruck) und behandelt BAML als erstklassige Metadaten statt als trägen Blob:
- Es bewahrt den kurzen Assembly-Namen und den Namen des
.g.resources-Streams, damit jeder;component-Pack-URI und jeder Aufruf vonApplication.LoadComponentweiterhin auflöst. - Es parst und schreibt die Typ- und Assembly-Tabellen des BAML im Gleichschritt mit der Umbenennungskarte neu. Wird ein aus dem Markup referenzierter Typ in den Metadaten umbenannt, wird sein BAML-Eintrag auf denselben neuen Namen neu geschrieben — Markup und umbenanntes IL bleiben konsistent, genau wie die Token-Neunummerierung die Operanden von
callundldstrnach einem Metadaten-Neuaufbau konsistent hält. - Es lässt die Ressourcenpfade und
x:Key-Strings in Ruhe, denn das sind Adressen, die WPF auflöst, keine Geheimnisse.
Die praktische Konfiguration ist dieselbe minimale, sichere Fläche, die du für jede WPF-App verwenden würdest, plus die ausdrückliche Absicht, die Ressourcen intakt zu halten:
{
"inputs": ["bin/Release/net8.0/MyApp.dll"],
"outputDirectory": "protected",
"preservePublicApi": true,
"preserveResources": true,
"controlFlowObfuscation": true,
"encryptStrings": true
}
preserveResources hält die Streamnamen und einzelnen Ressourcendateien adressierbar; preservePublicApi hält die gebundenen View-Model-Member benannt, damit {Binding} weiterhin auflöst. Alles, was das Markup nicht benennt — deine Dienste, Algorithmen, privaten Member — wird mit voller Stärke umbenannt, abgeflacht und stringverschlüsselt. Der Wert lebt im Code hinter dem Fenster, und genau das wird geschützt.
Benutzerdefinierte Steuerelemente und Themes
Eine wiederverwendbare Steuerelementbibliothek hat eine zusätzliche Kopplung: Das Attribut [assembly: ThemeInfo] weist WPF an, /themes/generic.baml für die Standardstile zu suchen, und die DefaultStyleKey jedes Steuerelements ist sein eigener Type. Weil Nebula den Ressourcenstream bewahrt und die Typtabelle des BAML konsistent neu schreibt, lädt Themes/Generic.xaml weiterhin und die Standardstile binden weiterhin — aber es ist der wichtigste Bildschirm, den du nach dem Schutz durchklicken solltest, da ein fehlendes Theme visuell scheitert statt mit einer harten Ausnahme.
Prüfe, dass sie wirklich lädt
BAML-Probleme treten beim Laden auf, nicht beim Kompilieren, deshalb besteht der Test darin, den geschützten Build auszuführen und jedes Fenster zu öffnen — besonders Steuerelemente mit benutzerdefiniertem Template und jedes aus einer anderen Assembly gemergte ResourceDictionary. Wirft ein Fenster eine Ausnahme, lies die Meldung: Cannot locate resource deutet auf eine Unstimmigkeit beim Streamnamen oder Ressourcenpfad hin, während eine XamlParseException, die einen Typ nennt, auf eine BAML-Typtabellen-Neuschreibung hindeutet, die nicht stattfand.
Du kannst das ausgelieferte Artefakt auch direkt inspizieren. Öffne die geschützte DLL in Glass.NET und sieh dir die verwalteten Ressourcen an: Bestätige, dass der <AssemblyName>.g.resources-Stream unter dem unveränderten Assembly-Namen vorhanden ist und seine BAML-Einträge weiterhin die erwarteten Pfade tragen. Für eine tiefere Prüfung extrahierst du einen BAML-Stream und bestätigst, dass seine Typtabelle die umbenannten Typen nennt — das ist der Beweis, dass Markup und Metadaten übereinstimmen. Diese Prüfung in CI zu automatisieren folgt demselben Muster wie jede andere Obfuskierungsschranke: schützen und dann behaupten, dass der Ressourcenstream existiert und der Smoke-Test der App jedes Fenster öffnet. Siehe Obfuskierung in CI verifizieren für das Gerüst.
Die Kurzfassung
- WPF liefert dein XAML als BAML in
<AssemblyName>.g.resourcesaus, und Pack-URIs verankern den kurzen Assembly-Namen und den Ressourcenpfad. - Benenne niemals den Namen der WPF-Assembly um — er ist in jeden
;component-URI und in den Namen des Ressourcenstreams eingebacken. - Typen umzubenennen ist in Ordnung, sofern die Typtabelle des BAML mit ihnen neu geschrieben wird; Nebula.NET tut das im Gleichschritt mit der Umbenennungskarte.
- Lass
preserveResourcesundpreservePublicApieingeschaltet und obfuskiere dann die Interna hart — dort liegt der Wert. - Teste, indem du jedes Fenster startest und öffnest, und verifiziere den Ressourcenstream mit Glass.NET.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.