Installazione

Babel Desktop

Babel Desktop è l’applicazione multipiattaforma per Windows, macOS e Linux che modifica ed esegue i progetti di offuscamento .babel e gestisce un Babel Licensing Service. Vedi Installazione di Babel Desktop per gli installer e Attivazione del prodotto per i requisiti di licenza.

[!NOTE] Babel Desktop non installa lo strumento da riga di comando babel. Per eseguire Babel da un terminale, da uno script di build o da MSBuild, usa i pacchetti zip o lo strumento dotnet descritti di seguito.

Riga di comando e task MSBuild (pacchetti zip)

Lo strumento da riga di comando e il task MSBuild sono distribuiti come pacchetti zip, uno per ogni framework di destinazione:

Ogni pacchetto contiene:

• babel, lo strumento da riga di comando di Babel Obfuscator
• lic, lo strumento da riga di comando di Babel Licensing
• HardwareId, lo strumento che legge l’identificatore hardware del computer
• il task MSBuild nella cartella MSBuild: Babel.Build.dll, Babel.Build.targets e Babel.Build.xsd

Per installare lo strumento da riga di comando:

> babel

Il pacchetto per .NET Framework funziona solo su Windows. I pacchetti per .NET 8, .NET 9 e .NET 10 funzionano anche su Linux e macOS tramite l’host dotnet, purché sia installato il runtime .NET corrispondente:

dotnet ~/Babel/babel.dll

Su Linux e macOS puoi anche installare babel come strumento dotnet, come descritto in Installare lo strumento dotnet Babel CLI.

Il plugin Babel Encrypt è distribuito separatamente nel pacchetto babel_encrypt_plugin_<ver>.zip.

Pacchetti NuGet di Babel

Acquistando l’edizione Ultimate di Babel Obfuscator o le edizioni Server e Data Center di Babel Licensing ricevi diversi pacchetti NuGet. Tra questi ci sono i pacchetti NuGet di Babel Obfuscator:

Questi pacchetti NuGet non sono disponibili nel repository pubblico di NuGet. Per usarli nei tuoi progetti devi installarli nei tuoi feed NuGet privati o sul tuo computer.

Sono disponibili diversi feed NuGet privati:

• Azure Artifacts 
• GitHub Package Registry 
• GitLab Package Registry 
• MyGet 
• TeamCity 
• Gitea  (open source)
• NuGet Server  (open source)

Se non hai un feed NuGet privato, puoi crearne uno sul tuo computer.

[!NOTE] Che i tuoi pacchetti siano ospitati su un server o sul tuo computer, puoi accedervi con lo strumento CLI nuget  o con Visual Studio .

Creare un feed NuGet locale con dotnet

Se hai installato Visual Studio o l’SDK dotnet, puoi accedere a NuGet direttamente dallo strumento CLI dotnet. Ora devi decidere dove conservare i pacchetti sul tuo computer. In questo esempio creiamo la cartella NuGet nella cartella Documenti dell’utente. Su Linux o macOS puoi creare la cartella nella cartella home dell’utente, ~/NuGet.

Puoi aggiungere i pacchetti al tuo feed locale con il comando dotnet nuget add.

Windows PowerShell o shell DOS:

dotnet nuget add source %UserProfile%\Documents\NuGet

Linux o macOS:

dotnet nuget add source ~/NuGet

Lo strumento dotnet dovrebbe segnalare che il pacchetto è stato aggiunto correttamente; da questo momento puoi accedere ai tuoi pacchetti tramite il comando dotnet.

Creare un feed NuGet locale con Visual Studio

Apri le opzioni delle origini pacchetti

Apri Visual Studio e dal menu Tools seleziona Options. Nel pannello Options cerca NuGet e seleziona il nodo Package Sources sotto la voce NuGet Package Manager dell’albero.

Aggiungi l’origine pacchetti Babel

Premi il pulsante con l’icona del segno più, poi inserisci Babel nel campo Name e, nel campo Source, il percorso completo della cartella che contiene i file dei pacchetti NuGet di Babel Obfuscator. Premi il pulsante OK.

Aggiungi il riferimento al pacchetto Babel.Obfuscator

In Solution Explorer fai clic con il pulsante destro sul tuo file di progetto. Seleziona Manage NuGet Packages…

Nella casella combinata Package source seleziona l’origine pacchetti Babel appena aggiunta, poi installa il pacchetto Babel.Obfuscator.

Aggiungi il file di licenza

Copia il tuo file di licenza babel.licenses nella cartella della soluzione e ricompila la soluzione.

Installare lo strumento dotnet Babel CLI

Quando i pacchetti NuGet di Babel sono nel tuo repository NuGet locale, puoi installare gli strumenti CLI con il comando dotnet tool install.

Installa lo strumento CLI di Babel Obfuscator, babel:

dotnet tool install Babel.Obfuscator.Tool -g

Installa lo strumento CLI di Babel Licensing, lic:

dotnet tool install Babel.Licensing.Tool -g

Per vedere le versioni degli strumenti dotnet installati, usa il comando seguente:

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

Aggiornare lo strumento dotnet Babel CLI

Per aggiornare lo strumento CLI di Babel Obfuscator, babel, esegui nel terminale:

dotnet tool update Babel.Obfuscator.Tool -g

Per aggiornare lo strumento CLI di Babel Licensing, lic, esegui nel terminale:

dotnet tool update Babel.Licensing.Tool -g

Disinstallare lo strumento dotnet Babel CLI

Per rimuovere lo strumento CLI di Babel Obfuscator, babel, esegui nel terminale:

dotnet tool uninstall Babel.Obfuscator.Tool -g

Per rimuovere lo strumento CLI di Babel Licensing, lic, esegui nel terminale:

dotnet tool uninstall Babel.Licensing.Tool -g