Skip to Content
Nuova versione 12 disponibile 🎉
DesktopOffuscamento

Offuscamento

Un progetto di offuscamento raccoglie gli assembly da proteggere, le loro dipendenze e le impostazioni di ciascuno. Babel Desktop lo mostra come grafo su un canvas o come tabella in una griglia e lo esegue con il motore di Babel Obfuscator.

Babel Desktop salva i progetti come file .babel, il formato di progetto MSBuild usato dal task MSBuild. Puoi compilare con MSBuild un progetto salvato in Babel Desktop e aprire in Babel Desktop un progetto .babel esistente.

Dalla versione 12.1.1, un progetto salvato su un computer in cui il task MSBuild è installato carica il task dal file di quell’installazione, e un progetto che indica ancora il task con il nome dell’assembly e la versione viene convertito quando lo salvi. Vedi Task MSBuild.

Babel Desktop conserva le parti di un file .babel che non modifica, come commenti, proprietà personalizzate e task MSBuild personalizzati. Non valuta gli import, le condizioni né i task personalizzati di MSBuild: un progetto che ne dipende deve essere compilato con MSBuild. Fa eccezione l’elemento UsingTask del task Babel, che viene convertito come descritto sopra.

Target, dipendenze e flussi

Un progetto è composto da pochi tipi di elementi. Le altre pagine di questa sezione usano questi termini con il significato indicato qui sotto.

TermineSignificato
TargetUn assembly che il motore offusca e scrive in un proprio file di output. Ogni target ha le proprie impostazioni. Viene chiamato anche target principale.
DipendenzaUn assembly unito a un target, incorporato in esso o usato solo per risolverne i riferimenti. Una dipendenza appartiene a un solo target e non ha impostazioni proprie. Vedi Dipendenze.
Collegamento mapUn collegamento tra due target: il primo scrive la sua mappa XML di ridenominazione e il secondo la legge, così entrambi usano gli stessi nuovi nomi per i simboli pubblici. Vedi Ordine di esecuzione.
FlussoUn gruppo di target legati tra loro da dipendenze, collegamenti map od ordine di esecuzione. I target di un flusso vengono eseguiti uno dopo l’altro, nell’ordine dei loro passi.

Creare un progetto

Un progetto si prepara in quattro passaggi, dall’aggiunta degli assembly alla prima esecuzione.

Aggiungi gli assembly

Fai clic su Aggiungi assembly nella schermata iniziale o su + Aggiungi assembly nella barra degli strumenti (Ctrl+Shift+A, Cmd+Shift+A su macOS), oppure trascina gli assembly .NET dal file manager sul canvas. Ogni assembly diventa un target: un nodo del canvas e una riga della griglia.

Collega le dipendenze

Aggiungi gli assembly che vengono uniti a un target, incorporati in esso o da esso referenziati, come descritto in Dipendenze. Per un insieme di assembly distribuiti insieme, collega con collegamenti map i target che usano l’uno l’API pubblica dell’altro.

Configura ogni target

Seleziona un target e apri il pannello delle proprietà per modificarne le impostazioni e le regole XML, oppure modifica più target insieme nella griglia. Vedi Impostazioni del target e La griglia del progetto.

Salva ed esegui

Salva il progetto con File > Salva (Ctrl+S, Cmd+S su macOS), poi fai clic su Esegui progetto (Ctrl+Enter, Cmd+Enter su macOS). Vedi Eseguire il progetto.

I comandi di configurazione svolgono il secondo e il terzo passo nei casi più comuni: un’applicazione con le sue librerie unite, oppure un insieme di librerie con i simboli pubblici rinominati. Flussi di lavoro tipici li descrive entrambi passo per passo.

Aprire e salvare i progetti

Un progetto viene salvato come file .babel. La maggior parte dei comandi di progetto si trova nel menu File e ha anche una scorciatoia da tastiera.

AzioneCome
Nuovo progettoFile > Nuovo progetto, Ctrl+N (Cmd+N su macOS), Progetto: Nuovo nella tavolozza comandi oppure il pulsante Nuovo progetto a sinistra della barra degli strumenti
Aprire un progettoFile > Apri progetto…, Ctrl+O (Cmd+O su macOS), il pulsante Apri progetto… della schermata iniziale oppure un file .babel trascinato sulla griglia
Aprire un progetto recenteProgetto: Apri recente… nella tavolozza comandi
SalvareFile > Salva, Ctrl+S (Cmd+S su macOS)
Salvare con un altro nomeFile > Salva con nome…, Ctrl+Shift+S (Cmd+Shift+S su macOS)

Salva scrive il file .babel aperto e chiede un nome di file solo per un progetto nuovo. La finestra Apri progetto si apre sulla cartella dell’ultimo progetto aperto. Se il progetto corrente ha modifiche non salvate, Babel Desktop chiede se scartarle prima di creare o aprire un altro progetto, e lo chiede di nuovo prima di chiudere la finestra. Se è in corso un’elaborazione, attendi che termini prima di aprire un altro progetto.

Babel Desktop ricorda inoltre, su questo computer, se hai guardato un progetto l’ultima volta sul canvas o nella griglia. Cambiare vista non modifica il file di progetto.

Sostituire un input

Per far puntare un target a una nuova build del suo assembly senza perderne le impostazioni, seleziona il target ed esegui Assembly: Sostituisci input e mantieni impostazioni… dalla tavolozza comandi. Assembly: Rimuovi destinazione selezionata, oppure Rimuovi assembly nel menu di un nodo o di una riga, rimuove un target insieme alle sue dipendenze e ai suoi collegamenti.

Pagine di questa sezione

Le pagine seguenti trattano le due viste di un progetto, come i target sono collegati e ordinati, le loro impostazioni, l’esecuzione e i risultati, e si chiudono con alcuni esempi completi.

  • Il canvas del progetto: la vista a grafo, i nodi, il menu del nodo e come spostarsi.
  • Dipendenze: le dipendenze da unire, incorporare e referenziare, e come unire un target a un altro.
  • Ordine di esecuzione: flussi, passi, archi di flusso e collegamenti map.
  • La griglia del progetto: la vista a tabella, la modifica di molti target insieme, l’ordine di esecuzione e i dettagli di ogni target.
  • Impostazioni del target: il pannello delle proprietà, i file map, le regole XML, i plugin del motore, i comandi di configurazione e i livelli di protezione.
  • Eseguire il progetto: i file di output, il pannello Attività, gli avvisi e i flussi eseguiti in parallelo.
  • Risultati dell’esecuzione: il punteggio di offuscamento e le statistiche di protezione di ogni esecuzione.
  • Flussi di lavoro tipici: una sola applicazione, un’applicazione con librerie unite e un insieme di librerie con offuscamento pubblico.

Per riportare ai nomi originali gli stack trace offuscati di un’applicazione protetta, usando i suoi file map XML, usa il Decodificatore stack.

Last updated on