Implementare i criteri di archiviazione di analisi codice personalizzati per il codice gestito

Articolo
02/10/2024

Un criterio di archiviazione dell'analisi del codice specifica un set di regole che i membri di un progetto Azure DevOps devono essere eseguiti nel codice sorgente prima di essere archiviati nel controllo della versione. Microsoft fornisce un set di set di regole standard che raggruppano le regole di analisi del codice in aree funzionali. I set di regole dei criteri di archiviazione personalizzati specificano un set di regole di analisi del codice specifiche di un progetto. Un set di regole viene archiviato in un file con estensione ruleset.

I criteri di archiviazione vengono impostati a livello di progetto Azure DevOps e specificati dal percorso di un file con estensione ruleset nell'albero dei controlli della versione. Non sono previste restrizioni sulla posizione del controllo della versione del set di regole personalizzate dei criteri del team.

L'analisi del codice viene configurata per i singoli progetti di codice nella finestra delle proprietà per ogni progetto. Un set di regole personalizzato per un progetto di codice viene specificato dal percorso fisico del file con estensione ruleset nel computer locale. Quando si specifica un file con estensione ruleset che si trova nella stessa unità del progetto di codice, Visual Studio usa un percorso relativo al file nella configurazione del progetto.

Una procedura consigliata per la creazione di un set di regole personalizzate del progetto Azure DevOps consiste nell'archiviare il file con estensione ruleset dei criteri di archiviazione in una cartella speciale che non fa parte di alcun progetto di codice. Se si archivia il file in una cartella dedicata, è possibile applicare autorizzazioni che limitano chi può modificare il file di regole e spostare facilmente la struttura di directory che contiene il progetto in un'altra directory o computer.

Creare il set di regole di archiviazione personalizzato del progetto

Per creare un set di regole personalizzato per un progetto Azure DevOps, creare prima di tutto una cartella speciale per il set di regole dei criteri di archiviazione in Esplora controllo del codice sorgente. Creare quindi il file del set di regole e aggiungere il file al controllo della versione. Infine, si specifica il set di regole come criterio di archiviazione dell'analisi del codice per il progetto.

Nota

Per creare una cartella in un progetto Azure DevOps, è prima necessario eseguire il mapping della radice del progetto a un percorso nel computer locale.

Per creare la cartella del controllo della versione per il set di regole dei criteri di archiviazione

In Team Explorer espandere il nodo del progetto e quindi fare clic su Controllo del codice sorgente.
Nel riquadro Cartelle fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Nuova cartella.
Nel riquadro controllo del codice sorgente principale fare clic con il pulsante destro del mouse su Nuova cartella, scegliere Rinomina e digitare un nome per la cartella del set di regole.

Per creare il set di regole dei criteri di archiviazione

Scegliere Nuovo dal menu File, quindi fare clic su File.
Nell'elenco Categorie fare clic su Generale.
Nell'elenco Modelli fare doppio clic su Set di regole di analisi codice.
Specificare le regole da includere nel set di regole e quindi salvare il file del set di regole nella cartella del set di regole creata.

Per aggiungere il file del set di regole al controllo della versione

In Esplora controllo del codice sorgente fare clic con il pulsante destro del mouse sulla nuova cartella e quindi scegliere Aggiungi elementi alla cartella.

Per altre informazioni, vedere Git e Azure Repos.
Fare clic sul file del set di regole creato e quindi su Fine.

Il file viene aggiunto al controllo del codice sorgente ed estratto.
Nella finestra Dei dettagli di Esplora controllo del codice sorgente fare clic con il pulsante destro del mouse sul nome del file e quindi scegliere Archivia modifiche in sospeso.
Nella finestra di dialogo Archiviazione è possibile aggiungere un commento e quindi fare clic su Archiviazione.

Nota

Se è già stato configurato un criterio di archiviazione dell'analisi del codice per il progetto Azure DevOps ed è stato selezionato l'opzione Imponi archiviazione per contenere solo i file che fanno parte della soluzione corrente, verrà generato un avviso di errore dei criteri. Nella finestra di dialogo Errore criteri selezionare Sostituisci errore dei criteri e continua l'archiviazione. Aggiungere un commento obbligatorio e quindi fare clic su OK.

Per specificare il file del set di regole come criterio di archiviazione

Scegliere Project Impostazioni dal menu Team e quindi fare clic su Controllo del codice sorgente.
Fare clic su Criteri di archiviazione e quindi su Aggiungi.
Nell'elenco Criteri di archiviazione fare doppio clic su Analisi codice e verificare che la casella di controllo Imponi analisi codice per codice gestito sia selezionata.
Nell'elenco Esegui questo set di regole fare clic su< Seleziona set di regole dal controllo del codice> sorgente.
Digitare il percorso del file del set di regole dei criteri di archiviazione nel controllo della versione.

Il percorso deve essere conforme alla sintassi seguente:

$/ TeamProjectName / VersionControlPath

Nota

È possibile copiare il percorso usando una delle procedure seguenti in Esplora controllo del codice sorgente:
- Nel riquadro Cartelle fare clic sulla cartella che contiene il file del set di regole. Copiare il percorso del controllo della versione della cartella visualizzata nella casella Origine e digitare manualmente il nome del file del set di regole.
- Nella finestra dei dettagli fare clic con il pulsante destro del mouse sul file del set di regole e quindi scegliere Proprietà. Nella scheda Generale copiare il valore in Nome server.

Sincronizzare i progetti di codice con il set di regole dei criteri di archiviazione

Specificare un set di regole dei criteri di archiviazione del progetto come set di regole di analisi del codice di una configurazione del progetto di codice nella finestra di dialogo proprietà del progetto di codice. Se il set di regole si trova nella stessa unità del progetto di codice, viene usato un percorso relativo per specificare il set di regole quando il percorso viene selezionato nella finestra di dialogo file. Il percorso relativo consente alle impostazioni delle proprietà del progetto di essere portabili in altri computer che usano strutture di controllo della versione locali simili.

Per specificare un set di regole di progetto come set di regole di un progetto di codice

Se necessario, recuperare la cartella e il file del set di regole dei criteri di archiviazione dal controllo della versione.

È possibile eseguire questo passaggio in Esplora controllo codice sorgente facendo clic con il pulsante destro del mouse sulla cartella del set di regole e quindi scegliendo Ottieni versione più recente.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto di codice e quindi scegliere Proprietà.
Fare clic su Analisi codice.
Se necessario, fare clic sulle opzioni appropriate negli elenchi Configurazione e piattaforma .
Per eseguire l'analisi del codice ogni volta che il progetto di codice viene compilato usando la configurazione specificata, selezionare Esegui alla compilazione nella sezione Analizzatori binari.
Nell'elenco Esegui questo set di regole fare clic su <Sfoglia>.
Selezionare la versione locale del file del set di regole dei criteri di archiviazione.