Share via


Como: organizar arquivos de saída do projeto para compilações

Este tópico descreve as práticas recomendadas para a organização de arquivos de saída do projeto.Construir erros podem ocorrer quando você configurar os arquivos de saída de projeto incorretamente.Este tópico também descreve as vantagens e desvantagens de cada alternativa para organizar seus arquivos de saída do projeto.

Referenciando Assemblies do CLR

Para fazer referência a assemblies com # using

  • Você pode consultar um assembly diretamente do seu código usando a diretiva # using, tal como #using <System.Data.dll>.Para obter mais informações, consulte # usando diretiva (C++).

    O arquivo especificado pode ser um arquivo. dll,. exe,.netmodule ou. obj, contanto que ele seja na MSIL.O componente referenciado pode ser montado em qualquer idioma.Com essa opção, você terá acesso ao Intellisense desde que os metadados serão extraídos da MSIL.O arquivo em questão deve estar no caminho para o projeto; Caso contrário, o projeto não será compilado e o Intellisense não estarão disponível.Uma maneira fácil de determinar se o arquivo está no caminho é com o botão direito sobre a # usando a linha e escolher a documento aberto comando.Você será notificado se o arquivo não foi encontrado.

    Se você deseja colocar o caminho completo para o arquivo, você pode usar o /AI opção de compilador para editar o caminho de pesquisa para referências # using.Para obter mais informações, consulte /AI (especificam diretórios de metadados).

Para fazer referência a assemblies com /FU

  • Em vez de referenciar um assembly diretamente de um arquivo de código, conforme descrito acima, você pode usar o /FU opção de compilador.A vantagem desse método é que você não precisará adicionar um # separado usando a instrução para cada arquivo que faz referência a um determinado conjunto.

    Para definir essa opção, abra o Páginas de propriedades para o projeto.Expanda o Propriedades de configuração nó e em seguida, expanda o C/C++ nó e selecione Advanced.Adicione os assemblies desejados ao lado de Force # using.Para obter mais informações, consulte /Fu (nome forçado # using do arquivo).

Para fazer referência a assemblies com Adicionar nova referência

  1. Esta é a maneira mais fácil de usar o CLR assemblies.Primeiro, verifique se o projeto for compilado com o /clr opção de compilador.Em seguida, clique com botão direito do projeto a partir do Solution Explorer e selecione referências.O Páginas de propriedades caixa de diálogo aparecerá.

  2. Do Páginas de propriedades caixa de diálogo, selecione Adicionar nova referência de.Uma caixa de diálogo será exibida, listando todos.NET, COM e outros conjuntos de módulos disponíveis no projeto atual.Selecione o assembly desejado e clique em OK.

    Uma vez definida uma referência de projeto, as dependências correspondentes são manipuladas automaticamente.Além disso, como metadados faz parte de um assembly, não há nenhuma necessidade de adicionar os elementos que estão sendo usados de um arquivo de cabeçalho ou o protótipo de assemblies gerenciados.

Fazendo referência a DLLs nativas ou bibliotecas estáticas

Para fazer referência a DLLs nativas ou bibliotecas estáticas

  1. O arquivo de cabeçalho apropriado no seu código usando o n º de referência de diretiva de inclusão.O arquivo de cabeçalho deve estar no caminho de inclusão ou parte do projeto atual.Para obter mais informações, consulte # include diretiva (C/C++).

  2. Você também pode definir as dependências do projeto.Definindo dependências de projeto garante duas coisas.Primeiro, ele garante que os projetos são construídos na ordem correta para que um projeto sempre possa localizar os arquivos dependentes necessários.Em segundo lugar, ele adiciona implicitamente diretório de saída do projeto dependente para o caminho para que os arquivos podem ser encontrados facilmente em tempo de link.

  3. Para implantar o aplicativo, você precisará colocar a DLL no local apropriado.Isso pode ser uma das seguintes opções:

    1. O mesmo caminho do executável.

    2. Em qualquer lugar no caminho do sistema (o path variável de ambiente).

    3. No assembly lado a lado.Para obter mais informações, consulte Criando conjuntos de C/C++ lado a lado.

Trabalhar com diversos projetos

Por padrão, os projetos são construídos de modo que todos os arquivos de saída são criados em um subdiretório do diretório do projeto.O diretório é nomeado com base na configuração da compilação (ex.:Debug ou Release).Em ordem para projetos de irmãos referir-se uns aos outros, cada projeto deve adicionar explicitamente os outros diretórios de saída do projeto para o seu caminho para que a vinculação para o sucesso.Isso é feito automaticamente quando você define as dependências do projeto.No entanto, se você não usar dependências, você deve cuidadosamente tratar isso como compilações podem ficar muito difícil de gerenciar.Por exemplo, quando um projeto tem configurações Debug e Release e inclui uma biblioteca externa de um projeto irmão, ele deve usar um arquivo de biblioteca diferente dependendo de qual configuração vai sendo construída.Assim, esses caminhos hard-coding pode ser complicado.

Todos os arquivos de saída essenciais (como arquivos executáveis, arquivos de vinculador incremental e arquivos PDB) são copiados para um diretório de solução comum.Assim, ao trabalhar com uma solução que contém um número de projetos do C++ com configurações equivalentes, todos os arquivos de saída são centralizados para vinculação simplificado e a implantação.Você pode ter certeza de que seus aplicativos/biblioteca funcionará como esperado se eles mantêm esses arquivos juntos (já que os arquivos são garantidos como no caminho).

O local dos arquivos de saída pode ser uma questão importante durante a implantação em um ambiente de produção.Durante a execução de projetos no IDE, os caminhos para as bibliotecas incluídas não são necessariamente o mesmo que no ambiente de produção.Por exemplo, se você tiver #using "../../lib/debug/mylib.dll" em seu código, mas então implantar mylib.dll em uma posição relativa diferente, o aplicativo falhará em tempo de execução.Para evitar isso, você deve evitar usar caminhos relativos no # incluir instruções em seu código.É melhor para assegurar que os arquivos necessários estejam no caminho de compilação do projeto e da mesma forma, garantindo que os arquivos de produção correspondentes estão posicionados corretamente.

Como especificar onde os arquivos de saída ir

  • O local do projeto de saída configurações podem ser encontradas no projeto de Páginas de propriedades.Expanda o nó ao lado de Propriedades de configuração e selecione Geral.O local de saída é especificado ao lado de Diretório de saída.Para obter mais informações, consulte Página de propriedades geral (projeto).

Consulte também

Conceitos

Tipos de projeto do Visual C++