Informazioni su Dotfuscator Community & Visual Studio

Eseguire l'aggiornamento da Dotfuscator Community 5

Informazioni su come eseguire l'aggiornamento a PreEmptive Protection - Dotfuscator Community 6.

A seconda della cronologia di installazione e della versione di Visual Studio, potrebbe essere in esecuzione Dotfuscator Community 5, la versione principale precedente. In tal caso, è consigliabile eseguire l'aggiornamento, perché è importante assicurarsi che al codice vengano fornite le misure di protezione più recenti. Gli aggiornamenti sono disponibili gratuitamente.

Questo articolo illustra come determinare la versione attualmente disponibile, come eseguire l'aggiornamento alla versione 6, se necessario, e quali funzionalità sono state sostituite o rimosse tra le due versioni.

Determinare la versione di Dotfuscator

Se non si è certi della versione di Dotfuscator in esecuzione, è possibile determinare la versione eseguendo una delle opzioni seguenti:

• Avviare l'interfaccia utente grafica (GUI) di Dotfuscator Community passando al menu Strumenti di Visual Studio e selezionando PreEmptive Protection - Dotfuscator Community.

  Dall'interfaccia utente grafica di Dotfuscator aprire il menu ? e selezionare Informazioni su per visualizzare la schermata Informazioni.

  Questa schermata elenca la versione di Dotfuscator.

• Se Dotfuscator è integrato nella compilazione con l'interfaccia della riga di comando (ad esempio con le app Xamarin), è anche possibile controllare i log di compilazione per una riga simile all'esempio seguente:

  Dotfuscator Community Version 5.42.0.9514-e0e25f754
  

  Potrebbe essere necessario aumentare il livello di dettaglio della compilazione per visualizzare questo testo. Per Visual Studio, vedere Impostazioni di dettaglio.

Il primo numero intero della versione, prima del primo punto ., indica la versione principale di Dotfuscator. Se il primo numero intero è 5, è necessario eseguire i passaggi di aggiornamento in questa pagina, in modo da poter sfruttare le funzionalità e gli aggiornamenti di protezione più recenti di Dotfuscator 6.

Istruzioni per l'aggiornamento

Questa sezione include set di istruzioni per l'aggiornamento degli utilizzi tipici di Dotfuscator Community dalla versione 5 alla versione 6.

Installare Dotfuscator 6

Dotfuscator Community viene distribuito come estensione per Visual Studio. Le istruzioni per installare Dotfuscator 6 variano in base alla versione di Visual Studio in uso:

• Visual Studio 2022 Dotfuscator Community 6 è incluso in Visual Studio 2022.

• Visual Studio 2019 Dotfuscator Community 6 è incluso nelle versioni successive di Visual Studio 2019 (versione 16.10.0 e successive). Aggiornare Visual Studio 2019 alla versione più recente. L'aggiornamento di Visual Studio aggiorna automaticamente qualsiasi installazione di Dotfuscator Community 5 a Dotfuscator Community 6.

  • Se Dotfuscator non è già installato, aggiornare prima Visual Studio e quindi vedere Installazione.

  • Oltre alle versioni con Visual Studio, è sempre possibile ottenere le versioni più recenti di Dotfuscator Community dalla pagina Download di Dotfuscator.

• Visual Studio 2017 Questa versione di Visual Studio è disponibile solo con Dotfuscator Community 5. Tuttavia, è possibile installare o eseguire l'aggiornamento a Dotfuscator Community 6 passando alla pagina Download di Dotfuscator e selezionando il collegamento di download appropriato.

  Eseguire il file scaricato .vsix e seguire le istruzioni per installare Dotfuscator Community 6 in Visual Studio. Vengono aggiornate anche le installazioni esistenti di Dotfuscator Community 5.

• Le versioni precedenti di Visual Studio Dotfuscator Community 6 non sono supportate in queste versioni di Visual Studio. È consigliabile eseguire l'aggiornamento a una versione più recente di Visual Studio o eseguire l'aggiornamento da Dotfuscator Community a Dotfuscator Professional.

Se dotfuscator Community 5 è stato registrato in precedenza, la registrazione viene convertita automaticamente la prima volta che si esegue Dotfuscator Community 6.

Aggiornare i percorsi dell'interfaccia della riga di comando

Se in precedenza è stata usata l'interfaccia della riga di comando di Dotfuscator 5 per proteggere l'app, è necessario aggiornare il percorso all'interfaccia della riga di comando in tutti i progetti e compilare script che vi fanno riferimento. Include progetti che usano l'integrazione Xamarin di Dotfuscator Community.

Il motivo per cui un percorso dell'interfaccia della riga di comando di Dotfuscator potrebbe ora non essere valido perché i nomi di alcuni dei file eseguibili installati con Dotfuscator Community sono stati modificati in Dotfuscator 6. Questa modifica rende questi nomi eseguibili uguali in Dotfuscator Community e Dotfuscator Professional.

Se la compilazione usa un percorso dell'interfaccia della riga di comando dotfuscator non valido, è possibile che vengano visualizzati errori come uno degli esempi seguenti:

'"[...]\PreEmptiveSolutions\DotfuscatorCE\dotfuscatorCLI.exe"' is not recognized as an internal or external command, operable program or batch file.

The command ""[...]\PreEmptiveSolutions\DotfuscatorCE\dotfuscatorCLI.exe" Dotfuscator.xml" exited with code 9009.

When the DotfuscatorXamarinEnabled property is 'true', the Dotfuscator command line interface specified by DotfuscatorXamarinCliPath ('[...]\DotfuscatorCE\dotfuscatorCLI.exe') must exist.

Per aggiornare la compilazione in modo da usare il percorso corretto dell'interfaccia della riga di comando:

1. Avviare l'interfaccia utente grafica della community di Dotfuscator passando al menu Strumenti di Visual Studio e selezionando PreEmptive Protection - Dotfuscator Community.

2. Nell'interfaccia utente grafica della community di Dotfuscator passare al menu Strumenti e selezionare Prompt dei comandi dotfuscator.

3. Nel prompt dei comandi visualizzato digitare where dotfuscator.exe. Copiare il primo percorso visualizzato in un documento di testo normale per un riferimento successivo. Questo percorso è il nuovo percorso dell'interfaccia della riga di comando di Dotfuscator Community 6.

4. Aprire il progetto o la configurazione di compilazione in base alle esigenze del sistema di compilazione.

   • Per i progetti di Visual Studio, aprire il file di progetto (.csproj, .vbprojo .fsproj) come testo normale. Aprire un file di progetto in Visual Studio.

   • Se in precedenza è stata usata l'integrazione Xamarin di Dotfuscator Community per proteggere un'app Xamarin, tenere presente che Dotfuscator è integrato in ogni singolo progetto di app (ad esempio MyProject.Android.csproj e MyProject.iOS.csproj) separatamente e non in progetti di libreria condivisa. Aggiornare tutti i progetti di app attualmente in uso con Dotfuscator.

5. Individuare eventuali posizioni all'interno del progetto o della configurazione di compilazione in cui viene usato un percorso precedente dell'interfaccia della riga di comando di Dotfuscator Community 5. In genere è un percorso che termina con dotfuscatorCLI.exe.

   • Quando si aggiorna un progetto usando l'integrazione Xamarin di Dotfuscator Community, il percorso precedente si trova tra i <DotfuscatorXamarinCliPath> tag e </DotfuscatorXamarinCliPath> .

6. Sostituire i percorsi precedenti che si trovano nel passaggio 5 con il nuovo percorso annotato nel passaggio 3.

   Se uno dei percorsi precedenti non è un percorso assoluto, è necessario modificare il nuovo percorso in modo appropriato in base al contesto. Nell'esempio seguente la VSInstallDir variabile di ambiente è stata usata nel percorso precedente, quindi il nuovo percorso corrispondente deve eseguire la stessa operazione.

   • Nuovo percorso del passaggio 3: C:\Program Files (x86)\Microsoft Visual Studio\2019\Preview\Common7\IDE\Extensions\PreEmptiveSolutions\DotfuscatorCE\dotfuscator.exe
   • Percorso precedente nel file di progetto: %VSInstallDir%\Common7\IDE\Extensions\PreEmptiveSolutions\DotfuscatorCE\dotfuscatorCLI.exe
   • Nuovo percorso nel file di progetto: %VSInstallDir%\Common7\IDE\Extensions\PreEmptiveSolutions\DotfuscatorCE\dotfuscator.exe

7. Se si usa un sistema di controllo del codice sorgente, ad esempio Git, assicurarsi che le modifiche apportate al passaggio 6 vengano riflesse nel sistema. Distribuire queste modifiche al resto del team, come potrebbe essere appropriato per il sistema e l'organizzazione.

Aggiornare i file di configurazione dotfuscator

Tutti i file di configurazione dotfuscator (ad esempio Dotfuscator.xml) creati prima di Dotfuscator 6 devono essere aggiornati.

Se si tenta di eseguire l'interfaccia della riga di comando di Dotfuscator con un file di configurazione precedente, vengono visualizzati errori come gli esempi seguenti:

Dotfuscator Engine Initialization error: PreEmptive Analytics, Authenticode signing, and the Introduce Explicit Method Overrides setting are no longer supported. Please open your Dotfuscator config in the Config Editor which automatically upgrades it.

Per aggiornare un file di configurazione:

1. Avviare l'interfaccia utente grafica (GUI) di Dotfuscator Community passando al menu Strumenti di Visual Studio e selezionando PreEmptive Protection - Dotfuscator Community.

2. Aprire il file di configurazione Dotfuscator in questione (CTRL+O).

3. Nella scheda Output di compilazione viene visualizzato il messaggio seguente:

   PreEmptive Analytics, Authenticode signing, and the Introduce Explicit Method Overrides setting are no longer supported. The associated settings have been removed. Please save your upgraded Dotfuscator config.

4. Salvare il file di configurazione dotfuscator aggiornato (CTRL+S).

5. Se si usa un sistema di controllo del codice sorgente, ad esempio Git, assicurarsi che le modifiche apportate al file di configurazione dotfuscator vengano riflesse nel sistema. Distribuire queste modifiche al resto del team, come potrebbe essere appropriato per il sistema e l'organizzazione.

Aggiornare l'integrazione di Xamarin

Se dotfuscator Community 5 è stato integrato nel progetto Xamarin , uno dei passaggi necessari per scaricare le destinazioni e le attività di MSBuild personalizzate, ad esempio PreEmptive.Dotfuscator.Xamarin.targets. Queste destinazioni e attività sono state aggiornate in Dotfuscator Community 6, quindi è necessario sostituire le versioni precedenti con le nuove versioni.

Per aggiornare i file di integrazione di Xamarin:

1. Individuare la directory in cui sono stati scaricati inizialmente questi file. L'esempio fornito nelle istruzioni usa una sottodirectory denominata PreEmptive.Dotfuscator.Xamarin, ma è possibile che i file siano stati scaricati in una directory diversa, che potrebbe anche non avere file non correlati a Dotfuscator.

2. Nella directory che si trova nel passaggio 1 eliminare i file correlati all'integrazione di Dotfuscator Xamarin.

3. Scaricare il file ZIP collegato alla versione corrente della sezione User Guide seguente: Scaricare il set personalizzato di destinazioni e attività di MSBuild per Dotfuscator.

4. Estrarre il contenuto del file ZIP nella stessa directory annotata nel passaggio 1.

5. Se si usa un sistema di controllo del codice sorgente, ad esempio Git, assicurarsi che la rimozione dei file precedenti e l'aggiunta dei nuovi file si riflettano in tale sistema. A seconda del tipo di sistema, queste modifiche possono apparire come file che modificano il contenuto, anziché essere sostituiti. Distribuire queste modifiche al resto del team, come potrebbe essere appropriato per il sistema e l'organizzazione.

Altre sottosezioni in questa pagina si applicano anche ai progetti Xamarin, quindi assicurarsi di esaminare le altre istruzioni di questa pagina.

Aggiornare i riferimenti alle librerie di attributi

Dotfuscator consente di configurare determinate funzionalità tramite attributi .NET nel codice sorgente. Se i progetti usano tali attributi, potrebbe essere necessario aggiornarli per risolvere le modifiche in Dotfuscator 6.

Attributi offuscati

Non sono state apportate modifiche agli attributi di offuscamento. Questi attributi sono definiti nelle librerie di classi di base .NET e Dotfuscator Community 6 continua a rispettarli.

Controlla attributi

La libreria contenente gli attributi check è stata modificata. In Dotfuscator Community 5 è stato distribuito come file insieme a Dotfuscator stesso. A partire da Dotfuscator Community 6, viene invece distribuito come pacchetto NuGet pubblico.

Se si tenta di compilare un progetto di Visual Studio che fa ancora riferimento alla posizione precedente, è possibile che vengano visualizzati errori come gli esempi seguenti:

The type or namespace name 'PreEmptive' could not be found (are you missing a using directive or an assembly reference?)

The type or namespace name 'TamperCheckAttribute' could not be found (are you missing a using directive or an assembly reference?)

È anche possibile che venga visualizzato questo avviso:

Could not resolve this reference. Could not locate the assembly "PreEmptive.Attributes". Check to make sure the assembly exists on disk. If this reference is required by your code, you may get compilation errors.

Per aggiornare il progetto in modo da usare la nuova posizione:

1. Rimuovere il riferimento all'assembly del progetto a PreEmptive.Attributes.dll.

2. Aggiungere il riferimento PreEmptive.Protection.Checks.Attributes al pacchetto NuGet al progetto. Il pacchetto è disponibile nel feed NuGet predefinito nuget.org.

Sono stati rimossi anche i parametri di ExtendedKey ogni attributo Check. Questi parametri sono stati ignorati in Dotfuscator Community 5, ma se il codice sorgente li ha usati indipendentemente, rimuovere questi utilizzi per consentire la compilazione del progetto.

Attributi di strumentazione

Gli attributi di strumentazione sono stati usati per configurare la funzionalità PreEmptive Analytics in Dotfuscator 5. Tuttavia, PreEmptive Analytics è stato rimosso in Dotfuscator 6; vedere la sottosezione Funzionalità rimossa PreEmptive Analytics. Di conseguenza, anche gli attributi di strumentazione sono stati rimossi.

Se si tenta di compilare un progetto di Visual Studio che usa gli attributi di strumentazione, è possibile che vengano visualizzati gli stessi tipi di errori e avvisi indicati in Controlla attributi, anche se i nomi degli attributi sono diversi, FeatureAttribute ad esempio anziché TamperCheckAttribute.

Se si tenta di eseguire Dotfuscator in assembly già compilati che contengono utilizzi degli attributi di strumentazione, si ottengono errori come negli esempi seguenti:

The PreEmptive.Attributes.FeatureAttribute attribute (annotating SomeNamespace.SomeType::SomeMethod) is not recognized by this version of Dotfuscator.

Per risolvere questi problemi, rimuovere tutti gli utilizzi degli attributi di strumentazione dal codice sorgente. È anche necessario rimuovere i riferimenti all'assembly alla libreria che ha definito gli attributi , PreEmptive.Attributes.dll. (Se si usavano anche gli attributi check definiti in questa libreria, sono stati spostati; vedere Controllare gli attributi precedenti.

Funzionalità rimosse

Dotfuscator Community 6 introduce modifiche di rilievo apportate a Dotfuscator Community 5. Se si usa Dotfuscator Community 5, questa sezione descrive come gestire le modifiche che potrebbero richiedere modifiche alla compilazione o influire sull'output di Dotfuscator.

Nel log delle modifiche è disponibile un elenco completo delle modifiche.

PreEmptive Analytics

Dotfuscator 6 non supporta PreEmptive Analytics, incluso Check Telemetry. Tuttavia, i controlli stessi (incluse le notifiche dell'applicazione e le azioni di controllo) sono ancora supportati.

Per usare Dotfuscator 6, aggiornare il file di configurazione per rimuovere le impostazioni di PreEmptive Analytics.

Se si usano attributi in codice per configurare PreEmptive Analytics, rimuoverli dal codice sorgente e ricompilare gli assembly di input prima che Dotfuscator 6 possa proteggere tali assembly.

Se si usa Verifica telemetria per segnalare quando un controllo rileva uno stato non valido,ad esempio quando viene rilevata manomissione, è possibile sostituirlo con una notifica dell'applicazione personalizzata che segnala l'evento imprevisto a app Azure lication Insights o a un altro servizio di propria scelta.

Tipi di applicazione non supportati

I tipi di applicazione seguenti non sono più supportati in Dotfuscator 6:

• Windows Phone
• WinRT (app di Windows 8)
• Silverlight
• Unity (motore di gioco)

Inoltre, le app piattaforma UWP (Universal Windows Platform) (UWP) sono supportate solo per gli scenari Xamarin.

Per proteggere altri tipi di app UWP, eseguire l'aggiornamento a Dotfuscator Professional e seguire le istruzioni proteggi la tua app .

Input non supportati

Dotfuscator Community non supporta più pacchetti piattaforma UWP (Universal Windows Platform) (UWP) .appx come input. È possibile continuare a proteggere le app Xamarin destinate a UWP con l'integrazione di Xamarin . Per proteggere altri tipi di app UWP, eseguire l'aggiornamento a Dotfuscator Professional e seguire le istruzioni proteggi la tua app .

Inoltre, .xap i pacchetti non possono più essere usati come input perché Silverlight non è più supportato.

Introdurre sostituzioni esplicite dei metodi

L'opzione Ridenominazione per introdurre sostituzioni esplicite dei metodi è stata rimossa da Dotfuscator. Per usare Dotfuscator 6, aggiornare il file di configurazione per rimuovere questa impostazione.