Como modificar a estrutura de destino e o conjunto de ferramentas da plataforma

  • Artigo

Você pode editar um arquivo de projeto do Visual Studio C++ para direcionar diferentes versões do conjunto de ferramentas da plataforma C++. O SDK do Windows e o .NET Framework usados também são editáveis. (O .NET Framework se aplica somente a projetos C++/CLI). Um novo projeto usa o conjunto de ferramentas e .NET Framework padrão da versão do Visual Studio que você usa para criar o projeto. Se você modificar esses valores no arquivo .vcxproj, poderá usar a mesma base de código para cada destino de compilação.

Conjunto de ferramentas da plataforma

O conjunto de ferramentas da plataforma consiste no compilador C++ (cl.exe) e no vinculador (link.exe), juntamente com as bibliotecas padrão C/C++. O Visual Studio 2015, Visual Studio 2017 e Visual Studio 2019 são compatíveis com binários. É mostrado pela versão principal do conjunto de ferramentas, que permaneceu em 14. Os projetos compilados no Visual Studio 2019 ou no Visual Studio 2017 são compatíveis com a ABI em versões anteriores com projetos do 2017 e 2015. A versão secundária foi atualizada por 1 para cada versão desde o Visual Studio 2015:

  • Visual Studio 2015: v140
  • Visual Studio 2017: v141
  • Visual Studio 2019: v142
  • Visual Studio 2022: v143

Esses conjuntos de ferramentas dão suporte ao .NET Framework 4.5 e posteriores.

O Visual Studio também dá suporte a multiplataforma para projetos C++. Você pode usar o IDE mais recente do Visual Studio para editar e criar projetos criados por versões mais antigas do Visual Studio. Ele não exige que um projeto atualize os projetos para usar uma nova versão do conjunto de ferramentas. Ele requer que o conjunto de ferramentas mais antigo seja instalado em seu computador. Para obter mais informações, consulte Como usar a multiplataforma nativa no Visual Studio. Por exemplo, no Visual Studio 2015, você pode ter como destino o .NET Framework 2.0, mas deve usar um conjunto de ferramentas anterior que dê suporte a ele.

Estrutura de destino (somente projeto C++/CLI)

Ao alterar a Estrutura de destino, altere também o conjunto de ferramentas da plataforma para uma versão que suporte essa Estrutura. Por exemplo, para ter como destino do .NET Framework 4.5, é preciso usar um conjunto de ferramentas da plataforma compatível. Esses conjuntos de ferramentas incluem Visual Studio 2015 (v140), Visual Studio 2013 (v120) ou Visual Studio 2012 (v110). Você pode usar o SDK do Windows 7.1 para ter como destino o .NET Framework 2.0, 3.0, 3.5 e 4.

É possível estender a plataforma de destino ainda mais criando um conjunto de ferramentas personalizado da plataforma. Para obter mais informações, consulte Multiplataforma nativa do C++ no blog do Visual C++.

Para alterar a Estrutura de destino

  1. No Visual Studio, em Gerenciador de Soluções, selecione seu projeto. Na barra de menus, abra o menu Projeto e escolha Descarregar projeto. Esse comando descarrega o arquivo do projeto (.vcxproj) para seu projeto.

    Observação

    Um projeto C++ não pode ser carregado enquanto você edita o arquivo do projeto no Visual Studio. No entanto, é possível usar outro editor como o Bloco de Notas para modificar o arquivo do projeto enquanto o projeto é carregado no Visual Studio. O Visual Studio detectará que o arquivo do projeto foi modificado e solicitará que o projeto seja recarregado.

  2. Na barra de menus, selecione Arquivo, Abrir, Arquivo. Na caixa de diálogo Abrir Arquivo, navegue até a pasta do projeto e abra o arquivo do projeto (.vcxproj).

  3. No arquivo do projeto, localize a entrada para a versão da Estrutura de destino. Por exemplo, se o projeto estiver designado para o .NET Framework 4.5, localize <TargetFrameworkVersion>v4.5</TargetFrameworkVersion> no elemento <PropertyGroup Label="Globals"> do elemento <Project>. Se o elemento <TargetFrameworkVersion> não estiver presente, seu projeto não usa o .NET Framework e nenhuma modificação é necessária.

  4. Altere o valor para a versão do Framework desejada, como v3.5 ou v4.6.

  5. Salve as alterações e feche o editor.

  6. No Gerenciador de Soluções, abra o menu de atalho do projeto e escolha Recarregar projeto.

  7. Para verificar a alteração, na barra de menus, selecionePropriedades>do Projeto para abrir a caixa de diálogo Páginas de Propriedades do projeto. Na caixa de diálogo, selecione a página de propriedade Propriedades de Configuração>Geral. Verifique se a Versão da Estrutura de Destino do .NET Framework mostra a nova versão do Framework.

Para alterar o conjunto de ferramentas da plataforma

  1. No Visual Studio, na barra de menus, selecionePropriedades>do Projeto para abrir a caixa de diálogo Páginas de Propriedades do projeto.

  2. Na parte de cima da caixa de diálogo Páginas de Propriedade, abra a lista suspensa Configuração e selecione Todas as Configurações.

  3. Na caixa de diálogo, selecione a página de propriedade Propriedades de Configuração>Geral.

  4. No página de propriedades, selecione Conjunto de ferramentas da plataforma e selecione o conjunto de ferramentas desejado na lista suspensa. Por exemplo, se você instalou o conjunto de ferramentas do Visual Studio 2010, selecione Visual Studio 2010 (v100) para usá-lo em seu projeto.

  5. Escolha o botão OK para salvar suas alterações.

Próximas etapas

Passo a passo: trabalhando com projetos e soluções (C++)

Confira também

MSBuild na linha de comando – C++