Installation

Babel Desktop

Babel Desktop ist die plattformübergreifende Anwendung für Windows, macOS und Linux, mit der Sie .babel-Verschleierungsprojekte bearbeiten und ausführen und einen Babel Licensing Service verwalten. Die Installationsprogramme finden Sie unter Installation von Babel Desktop, die Lizenzanforderungen unter Produktaktivierung.

[!NOTE] Babel Desktop installiert das Befehlszeilentool babel nicht. Um Babel in einem Terminal, in einem Buildskript oder mit MSBuild auszuführen, verwenden Sie die Zip-Pakete oder das dotnet-Tool, die weiter unten beschrieben sind.

Befehlszeile und MSBuild-Aufgabe (Zip-Pakete)

Das Befehlszeilentool und die MSBuild-Aufgabe werden als Zip-Pakete ausgeliefert, eines für jedes Zielframework:

Jedes Paket enthält:

• babel, das Befehlszeilentool von Babel Obfuscator
• lic, das Befehlszeilentool von Babel Licensing
• HardwareId, das Tool, das die Hardware-ID des Rechners ausliest
• die MSBuild-Aufgabe im Ordner MSBuild: Babel.Build.dll, Babel.Build.targets und Babel.Build.xsd

So installieren Sie das Befehlszeilentool:

> babel

Das Paket für .NET Framework läuft nur unter Windows. Die Pakete für .NET 8, .NET 9 und .NET 10 laufen über den Host dotnet auch unter Linux und macOS, sofern die passende .NET-Laufzeit installiert ist:

dotnet ~/Babel/babel.dll

Unter Linux und macOS können Sie babel auch als dotnet-Tool installieren, wie unter Das dotnet-Tool Babel CLI installieren beschrieben.

Das Babel Encrypt Plugin wird separat im Paket babel_encrypt_plugin_<ver>.zip ausgeliefert.

NuGet-Pakete von Babel

Mit dem Kauf der Ultimate-Edition von Babel Obfuscator oder der Editionen Server und Data Center von Babel Licensing erhalten Sie mehrere NuGet-Pakete. Dazu gehören die NuGet-Pakete von Babel Obfuscator:

Diese NuGet-Pakete sind im öffentlichen NuGet-Repository nicht verfügbar. Um sie in Ihren Projekten zu verwenden, installieren Sie sie in Ihren privaten NuGet-Feeds oder auf Ihrem lokalen Rechner.

Private NuGet-Feeds gibt es bei mehreren Anbietern:

• Azure Artifacts 
• GitHub Package Registry 
• GitLab Package Registry 
• MyGet 
• TeamCity 
• Gitea  (Open Source)
• NuGet Server  (Open Source)

Wenn Sie keinen privaten NuGet-Feed haben, können Sie einen auf Ihrem lokalen Rechner anlegen.

[!NOTE] Unabhängig davon, ob Ihre Pakete auf einem Server oder auf Ihrem lokalen Rechner liegen, greifen Sie mit dem CLI-Tool nuget  oder mit Visual Studio  auf sie zu.

Einen lokalen NuGet-Feed mit dotnet erstellen

Wenn Sie Visual Studio oder das dotnet SDK installiert haben, greifen Sie direkt aus dem dotnet-CLI-Tool auf NuGet zu. Entscheiden Sie nun, wo Sie Ihre Pakete auf dem lokalen Rechner ablegen. In diesem Beispiel legen wir den Ordner NuGet im Dokumentenordner des Benutzers an. Unter Linux oder macOS können Sie den Ordner im Home-Verzeichnis des Benutzers anlegen: ~/NuGet.

Mit dem Befehl dotnet nuget add fügen Sie die Pakete Ihrem lokalen Feed hinzu.

Windows PowerShell oder DOS-Shell:

dotnet nuget add source %UserProfile%\Documents\NuGet

Linux oder macOS:

dotnet nuget add source ~/NuGet

Das dotnet-Tool meldet, dass das Paket hinzugefügt wurde. Über den Befehl dotnet erreichen Sie nun Ihre Pakete.

Einen lokalen NuGet-Feed mit Visual Studio erstellen

Optionen für Paketquellen öffnen

Öffnen Sie Visual Studio und wählen Sie im Menü Tools (Extras) den Eintrag Options (Optionen). Suchen Sie im Bereich Options nach NuGet und wählen Sie unter dem Baumeintrag NuGet Package Manager den Knoten Package Sources (Paketquellen).

Babel-Paketquelle hinzufügen

Klicken Sie auf die Schaltfläche mit dem Plussymbol. Geben Sie im Feld „Name“ den Wert Babel und im Feld „Source“ den vollständigen Pfad des Ordners ein, der die NuGet-Paketdateien von Babel Obfuscator enthält. Klicken Sie auf die Schaltfläche „OK“.

Paket Babel.Obfuscator referenzieren

Klicken Sie im Solution Explorer (Projektmappen-Explorer) mit der rechten Maustaste auf Ihre Projektdatei. Wählen Sie Manage NuGet Packages… (NuGet-Pakete verwalten).

Wählen Sie in der Auswahlliste Package source die soeben hinzugefügte Babel-Paketquelle aus und installieren Sie dann das Paket Babel.Obfuscator.

Lizenzdatei hinzufügen

Kopieren Sie Ihre Lizenzdatei babel.licenses in den Ordner der Projektmappe und erstellen Sie die Projektmappe neu.

Das dotnet-Tool Babel CLI installieren

Sobald die NuGet-Pakete von Babel in Ihrem lokalen NuGet-Repository liegen, installieren Sie die CLI-Tools mit dem Befehl dotnet tool install.

Installieren Sie babel, das CLI-Tool von Babel Obfuscator:

dotnet tool install Babel.Obfuscator.Tool -g

Installieren Sie lic, das CLI-Tool von Babel Licensing:

dotnet tool install Babel.Licensing.Tool -g

Die Versionen der installierten dotnet-Tools zeigt der folgende Befehl an:

dotnet tool list -g
 
Package Id                 Version      Commands
------------------------------------------------
babel.licensing.tool       12.0.0.1     lic     
babel.obfuscator.tool      12.0.0.1     babel   

Das dotnet-Tool Babel CLI aktualisieren

Um das CLI-Tool babel von Babel Obfuscator zu aktualisieren, führen Sie im Terminal aus:

dotnet tool update Babel.Obfuscator.Tool -g

Um das CLI-Tool lic von Babel Licensing zu aktualisieren, führen Sie im Terminal aus:

dotnet tool update Babel.Licensing.Tool -g

Das dotnet-Tool Babel CLI deinstallieren

Um das CLI-Tool babel von Babel Obfuscator zu entfernen, führen Sie im Terminal aus:

dotnet tool uninstall Babel.Obfuscator.Tool -g

Um das CLI-Tool lic von Babel Licensing zu entfernen, führen Sie im Terminal aus:

dotnet tool uninstall Babel.Licensing.Tool -g