Skip to Content
Neue Version 12 verfügbar 🎉
DesktopVerschleierung

Verschleierung

Ein Verschleierungsprojekt fasst die zu schützenden Assemblys, ihre Abhängigkeiten und die Einstellungen jeder einzelnen zusammen. Babel Desktop stellt es als Graph auf einer Zeichenfläche oder als Tabelle dar und führt es mit der Engine von Babel Obfuscator aus.

Babel Desktop speichert Projekte als .babel-Dateien, dem MSBuild-Projektformat, das auch die MSBuild-Aufgabe verwendet. Ein in Babel Desktop gespeichertes Projekt können Sie mit MSBuild ausführen, und ein vorhandenes .babel-Projekt können Sie in Babel Desktop öffnen.

Ab Version 12.1.1 lädt ein Projekt, das auf einem Rechner mit installierter MSBuild-Aufgabe gespeichert wird, die Aufgabe aus der Datei dieser Installation. Ein Projekt, das die Aufgabe noch über Assemblyname und Version angibt, wird beim Speichern umgestellt. Siehe MSBuild-Aufgabe.

Babel Desktop erhält die Teile einer .babel-Datei, die es nicht bearbeitet, etwa Kommentare, benutzerdefinierte Eigenschaften und benutzerdefinierte MSBuild-Aufgaben. MSBuild-Importe, Bedingungen und benutzerdefinierte Aufgaben wertet es nicht aus: Ein Projekt, das davon abhängt, muss mit MSBuild ausgeführt werden. Die einzige Ausnahme ist das Element UsingTask der Babel-Aufgabe, das wie oben beschrieben umgestellt wird.

Ziele, Abhängigkeiten und Abläufe

Ein Projekt besteht aus wenigen Arten von Elementen. Die anderen Seiten dieses Abschnitts verwenden die folgenden Begriffe in dieser Bedeutung.

BegriffBedeutung
ZielEine Assembly, die die Engine verschleiert und in eine eigene Ausgabedatei schreibt. Jedes Ziel hat eigene Einstellungen. Es heißt auch primäres Ziel.
AbhängigkeitEine Assembly, die mit einem Ziel zusammengeführt, in ein Ziel eingebettet oder nur zum Auflösen seiner Referenzen verwendet wird. Eine Abhängigkeit gehört zu genau einem Ziel und hat keine eigenen Einstellungen. Siehe Abhängigkeiten.
Map-VerknüpfungEine Verbindung zwischen zwei Zielen: Das erste schreibt seine XML-Umbenennungs-Map, das zweite liest sie. So verwenden beide dieselben neuen Namen für die öffentlichen Symbole. Siehe Ausführungsreihenfolge.
AblaufEine Gruppe von Zielen, die durch Abhängigkeiten, Map-Verknüpfungen oder die Ausführungsreihenfolge miteinander verbunden sind. Die Ziele eines Ablaufs laufen nacheinander in der Reihenfolge ihrer Schritte.

Ein Projekt anlegen

Ein Projekt entsteht in vier Schritten, vom Hinzufügen der Assemblys bis zum ersten Lauf.

Assemblys hinzufügen

Klicken Sie auf dem Startbildschirm auf Assemblys hinzufügen oder in der Symbolleiste auf + Assembly hinzufügen (Ctrl+Shift+A, Cmd+Shift+A unter macOS), oder ziehen Sie .NET-Assemblys aus dem Dateimanager auf die Zeichenfläche. Jede Assembly wird zu einem Ziel: einem Knoten auf der Zeichenfläche und einer Zeile in der Tabelle.

Abhängigkeiten verbinden

Fügen Sie die Assemblys hinzu, die mit einem Ziel zusammengeführt, in ein Ziel eingebettet oder von ihm referenziert werden, wie unter Abhängigkeiten beschrieben. Bei einer Gruppe von Assemblys, die gemeinsam ausgeliefert werden, verbinden Sie die Ziele, die die öffentliche API des jeweils anderen verwenden, mit Map-Verknüpfungen.

Jedes Ziel konfigurieren

Wählen Sie ein Ziel aus und öffnen Sie den Eigenschaftenbereich, um seine Einstellungen und XML-Regeln zu bearbeiten, oder bearbeiten Sie mehrere Ziele gleichzeitig in der Tabelle. Siehe Zieleinstellungen und Die Tabelle des Projekts.

Speichern und ausführen

Speichern Sie das Projekt mit Datei > Speichern (Ctrl+S, Cmd+S unter macOS) und klicken Sie dann auf Projekt ausführen (Ctrl+Enter, Cmd+Enter unter macOS). Siehe Das Projekt ausführen.

Die Einrichtungsbefehle erledigen den zweiten und dritten Schritt für die häufigsten Fälle: eine Anwendung, mit der ihre Bibliotheken zusammengeführt werden, oder eine Gruppe von Bibliotheken, deren öffentliche Symbole umbenannt werden. Typische Arbeitsabläufe führt Schritt für Schritt durch beide Fälle.

Projekte öffnen und speichern

Ein Projekt wird als .babel-Datei gespeichert. Die meisten Projektbefehle stehen im Menü Datei und haben außerdem ein Tastenkürzel.

AktionVorgehen
Neues ProjektDatei > Neues Projekt, Ctrl+N (Cmd+N unter macOS), Projekt: Neu in der Befehlspalette oder die Schaltfläche Neues Projekt links in der Symbolleiste
Projekt öffnenDatei > Projekt öffnen…, Ctrl+O (Cmd+O unter macOS), die Schaltfläche Projekt öffnen… auf dem Startbildschirm oder eine .babel-Datei, die Sie auf der Tabelle ablegen
Zuletzt verwendetes Projekt öffnenProjekt: Zuletzt verwendete öffnen… in der Befehlspalette
SpeichernDatei > Speichern, Ctrl+S (Cmd+S unter macOS)
Unter anderem Namen speichernDatei > Speichern unter…, Ctrl+Shift+S (Cmd+Shift+S unter macOS)

Speichern schreibt die geöffnete .babel-Datei und fragt nur bei einem neuen Projekt nach einem Dateinamen. Der Dialog Projekt öffnen beginnt im Ordner des zuletzt geöffneten Projekts. Hat das aktuelle Projekt ungespeicherte Änderungen, fragt Babel Desktop, ob sie verworfen werden sollen, bevor es ein anderes Projekt anlegt oder öffnet, und fragt erneut, bevor das Fenster geschlossen wird. Warten Sie, bis ein laufender Auftrag abgeschlossen ist, bevor Sie ein anderes Projekt öffnen.

Babel Desktop merkt sich außerdem auf diesem Rechner, ob Sie ein Projekt zuletzt auf der Zeichenfläche oder in der Tabelle angesehen haben. Ein Wechsel der Ansicht verändert die Projektdatei nicht.

Eine Eingabe ersetzen

Um ein Ziel auf einen neuen Build seiner Assembly umzustellen, ohne seine Einstellungen zu verlieren, wählen Sie das Ziel aus und führen Sie in der Befehlspalette Assembly: Eingabe ersetzen und Einstellungen beibehalten… aus. Assembly: Ausgewähltes Ziel entfernen oder Assembly entfernen im Menü eines Knotens oder einer Zeile entfernt ein Ziel samt seinen Abhängigkeiten und Verbindungen.

Seiten in diesem Abschnitt

Die folgenden Seiten behandeln die beiden Ansichten eines Projekts, wie seine Ziele verbunden und angeordnet werden, ihre Einstellungen, den Lauf und seine Ergebnisse, und schließen mit vollständigen Beispielen.

  • Die Zeichenfläche des Projekts: die Graphansicht, ihre Knoten, das Knotenmenü und die Navigation auf der Zeichenfläche.
  • Abhängigkeiten: Abhängigkeiten zum Zusammenführen, Einbetten und Referenzieren sowie das Zusammenführen eines Ziels mit einem anderen.
  • Ausführungsreihenfolge: Abläufe, Schritte, Ablaufkanten und Map-Verknüpfungen.
  • Die Tabelle des Projekts: die Tabellenansicht, das gleichzeitige Bearbeiten vieler Ziele, die Ausführungsreihenfolge und die Details jedes Ziels.
  • Zieleinstellungen: der Eigenschaftenbereich, Map-Dateien, XML-Regeln, Engine-Plugins, die Einrichtungsbefehle und die Schutzstufen.
  • Das Projekt ausführen: Ausgabedateien, der Bereich „Aktivität“, Warnungen und parallel ausgeführte Abläufe.
  • Ausführungsergebnisse: der Verschleierungswert und die Schutzstatistiken jedes Laufs.
  • Typische Arbeitsabläufe: eine einzelne Anwendung, eine Anwendung mit zusammengeführten Bibliotheken und eine Gruppe von Bibliotheken mit öffentlicher Verschleierung.

Um die verschleierten Stacktraces einer geschützten Anwendung mit ihren XML-Map-Dateien in die ursprünglichen Namen zurückzuübersetzen, verwenden Sie den Stack-Decoder.

Last updated on