Configurazione del progetto per l'output

Ogni configurazione può supportare un set di processi di compilazione che producono gli elementi di output come eseguibile o file di risorse. Questi elementi di output sono privati all'utente e possono essere inseriti in gruppi che correlano i tipi correlati di output come i file eseguibili (con estensione exe, dll, lib) e file di origine (file con estensione h, .idl).

Gli elementi di Output possono essere resi disponibili dai metodi di IVsOutput2 ed essere enumerati con i metodi di IVsEnumOutputs . Quando si desidera raggruppare gli elementi di output, il progetto deve implementare anche l'interfaccia di IVsOutputGroup .

Il costrutto compilato implementando IVsOutputGroup consente i progetti raggruppare gli output come utilizzare. Ad esempio, una DLL può essere raggruppato con il relativo database (PDB) di programma.

Nota

Un file PDB contiene le informazioni di debug e viene creato quando “generare opzione di informazioni di debug„ è specificato durante la compilazione della DLL o EXE.Il file pdb viene solitamente generato per la configurazione del progetto di Debug solo.

Il progetto deve restituire lo stesso numero dei gruppi per ogni configurazione che supporta, anche se il numero di output contenuti all'interno di un gruppo può variare dalla configurazione della configurazione. Ad esempio, la DLL del Matt di progetto può includere mattd.dll e mattd.pdb nella configurazione di debug, ma solo include matt.dll nella configurazione al dettaglio.

I gruppi dispone anche delle stesse informazioni dell'identificatore, ad esempio il nome, il nome visualizzato e informazioni canonici del gruppo, la configurazione della configurazione all'interno di un progetto. Questa costante viene utilizzata nel codice generato per fare riferimento a questa voce di menu.

I gruppi possono disporre di un output delle chiavi che consente la compressione i collegamenti nel passaggio con un nome significativo. Qualsiasi gruppo può essere vuoto nella configurazione specificata, pertanto alcuna supposizione deve essere eseguita sulla dimensione di un gruppo. La dimensione (numero di output) di ogni gruppo in qualsiasi configurazione può essere diverso dalla dimensione di un altro gruppo nella stessa configurazione. Può anche essere diversa dalla dimensione dello stesso gruppo in un'altra configurazione.

gruppi di output

L'utilizzo principale dell'interfaccia di IVsProjectCfg consiste nel fornire accesso per compilare, distribuire ed eseguire il debug di oggetti di gestione e concedere a progetti la libertà raggruppare gli output. Per ulteriori informazioni sull'utilizzo di questa interfaccia, vedere Oggetto di configurazione del progetto.

Nel diagramma precedente, il gruppo incorporato ha un output delle chiavi tramite le configurazioni (bD.exe o b.exe) in modo che l'utente possa creare un collegamento compilato e si è certi che il collegamento funzionerà indipendentemente dalla configurazione distribuita. L'origine del gruppo non dispone di un output delle chiavi, pertanto l'utente non può creare un collegamento a. Se il gruppo di Debug compilato effettua compilare un output delle chiavi, ma il gruppo al dettaglio contrario, che sarà corretta implementazione. Seguente, pertanto, che se una configurazione non dispone di un gruppo che non contenga output e, di conseguenza, file di chiave, quindi altre configurazioni al gruppo contenenti gli output non possono avere file di chiave. Gli editor del programma di installazione presuppongono che i nomi e i nomi visualizzati canonici dei gruppi, nonché l'esistenza di un file di chiave, non variano in base alle configurazioni.

Note that if a project has an IVsOutputGroup that it does not want to package or deploy, it is sufficient to not put that output in a group. L'output può ancora essere enumerato in genere implementando il metodo di EnumOutputs che restituisce tutti gli output di una configurazione indipendentemente da raggruppamento.

Per ulteriori informazioni, vedere l'implementazione di IVsOutputGroup nell'esempio personalizzato di progetto a MPF per i progetti - rappresentazione studio.

Vedere anche

Concetti

Configurazione del progetto per la compilazione

Oggetto di configurazione del progetto

Oggetto di configurazione del progetto

Configurazione di soluzione

Altre risorse

gestire le opzioni di configurazione